kapa.ai 믹스패널 유저 프로퍼티 임포트 하는 방법 알려줘

Please stand by DONGHYO L. as I search the knowledge base. I normally take about 15 seconds or so. 👋

믹스패널(Mixpanel)에서 유저 프로퍼티(사용자 프로필)를 임포트하는 방법은 여러 가지가 있습니다. 아래에 대표적인 방법들을 정리해 드립니다.---

1. CSV 파일 준비 - 첫 번째 열에 $distinct_id(유저 고유 식별자)를 포함하세요. - 추가로 임포트할 프로퍼티(예: $name, $email, department 등)를 열로 추가하세요. - CSV에는 컬럼 헤더를 포함하지 마세요. 헤더는 업로드 과정에서 UI에서 직접 지정합니다.2. Mixpanel UI에서 임포트 - Users 페이지로 이동 후 Add/Edit Profile 클릭 - Import from CSV 탭 선택 - CSV 파일 업로드 - 각 열이 어떤 프로퍼티에 매핑될지 지정 - 임포트할 열만 선택하고, 필요 없는 열은 체크 해제 - Import profiles 버튼 클릭> ⚠️ 이미 존재하는 $distinct_id가 있으면 해당 프로필이 업데이트되고, 새로운 값이면 새 프로필이 생성됩니다.

자세한 안내 보기---

파이썬 등 서버에서 직접 Mixpanel HTTP API를 호출해 대량으로 유저 프로퍼티를 임포트할 수 있습니다.LBKSimport json import requestsLBKSPROJECT_TOKEN = "여기에_프로젝트_토큰_입력"LBKSdef get_users_from_database(): return [ {"user_id": "123", "$name": "Alice", "$email": "alice@​[linear.app](http://linear.app)", "department": "engineering"}, {"user_id": "456", "$name": "Bob", "department": "product"}, ]LBKSdef transform_to_mp_format(user): distinct_id = user.pop("user_id") return {"$distinct_id": distinct_id, "$token": PROJECT_TOKEN, "$ip": "0", "$set": user}LBKSusers = get_users_from_database() profiles = [transform_to_mp_format(u) for u in users]LBKSresp = [requests.post](http://requests.post)( "[https://api.mixpanel.com/engage](https://api.mixpanel.com/engage)", params={"verbose": "2"}, headers={"Content-Type": "application/json"}, data=json.dumps(profiles) )LBKSprint(resp.json())LBKS- 한 번에 200개 프로필씩 배치로 보내는 것이 권장됩니다. - $set 외에도 $set_once, $add, $union 등 다양한 연산자를 사용할 수 있습니다. API 예시 및 연산자 설명 API 샘플 코드---

BigQuery, Snowflake 등 데이터 웨어하우스와 Mixpanel을 연결해 자동으로 유저 프로필을 임포트할 수 있습니다. - 프로젝트 설정에서 Warehouse Source를 연결하고, User Table을 선택해 매핑하면 됩니다. - 이 방법은 별도의 라이선스가 필요할 수 있습니다. 자세히 보기---필요에 따라 위 방법 중 하나를 선택해 사용하시면 됩니다. 추가로 궁금한 점이 있으면 말씀해 주세요!

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

Mixpanel에서 $ip를 0으로 설정하면, 해당 유저 프로필을 임포트할 때 Mixpanel이 IP 주소를 사용해 위치(지리 정보)를 자동으로 추정하지 않도록 한다는 의미입니다.즉, 서버에서 API로 유저 프로필을 보낼 때 $ip를 0으로 지정하면, Mixpanel은 그 요청의 IP(예: 서버의 IP 주소)를 사용해 $city, $region, mp_country_code와 같은 위치 정보를 자동으로 채우지 않습니다. 이렇게 하면 모든 유저의 위치가 서버(데이터센터) 위치로 잘못 저장되는 것을 방지할 수 있습니다.아래 예시처럼 $ip를 0으로 지정합니다: LBKS{ "$token": "mytoken", "$distinct_id": "13793", "$ip": "0", "$set": { "My_property": "my_value" } }LBKS이렇게 하면 Mixpanel은 IP 기반 위치 정보를 저장하지 않습니다. 자세한 내용은 공식 문서에서 확인할 수 있습니다.

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

죄송하지만, 제공된 지식 소스에서는 ``` {'error': None, 'errors': {}, 'num_good_events': 200, 'status': 1}

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

앰플리튜드(Amplitude)에서 믹스패널(Mixpanel)로 유저 프로퍼티(사용자 프로필)를 이관하려면 아래와 같은 방법을 사용할 수 있습니다.---

가장 권장되는 방법은 Amplitude 데이터를 데이터 웨어하우스(BigQuery, Snowflake 등)에 저장한 뒤, Mixpanel의 Warehouse Connector를 통해 유저 프로퍼티를 이관하는 것입니다.절차 요약: 1. Amplitude의 유저 데이터를 데이터 웨어하우스에 적재합니다. 2. 아래와 같이 SQL로 JSON 컬럼을 평탄화(flatten)하여 필요한 컬럼만 추출합니다.LBKSSELECT event_time, user_id, -- user properties JSON_EXTRACT_SCALAR(user_properties, "$['$email']") AS email, JSON_EXTRACT_SCALAR(user_properties, "$['$name']") AS name, JSON_EXTRACT_SCALAR(user_properties, "$['last_genre']") AS last_genre, JSON_EXTRACT_SCALAR(user_properties, "$['lifetime_purchase']") AS lifetime_purchase FROM `project.dataset.tablename` t1 INNER JOIN ( SELECT user_id, MAX(event_time) as max_event_time FROM `project.dataset.tablename` WHERE user_id IS NOT NULL GROUP BY user_id ) t2 ON t1.user_id = t2.user_id AND t1.event_time = t2.max_event_timeLBKS3. Mixpanel 프로젝트에서 Warehouse Connector를 설정하고, 위에서 만든 테이블/뷰를 연결하여 각 필드를 매핑합니다. 자세한 절차는 공식 문서를 참고하세요.---

Mixpanel에서 제공하는 무료 Migration Service를 이용해 Amplitude의 이벤트와 유저 프로퍼티를 자동으로 이관할 수 있습니다. 아래와 같이 API를 호출하면 됩니다.LBKScurl --request POST \ --url [https://migrate.api.mixpanel.com/amplitude](https://migrate.api.mixpanel.com/amplitude) \ --header "Content-Type: application/json" \ --data '{ "AMPLITUDE_API_KEY": "YOUR_AMP_KEY", "AMPLITUDE_API_SECRET": "YOUR_AMP_SECRET", "MIXPANEL_TOKEN": "YOUR_MP_TOKEN", "START_DATE": "YYYY-MM-DD", "END_DATE": "YYYY-MM-DD" }'LBKS이 서비스는 Amplitude에서 데이터를 추출해 Mixpanel에 맞게 변환 후, 이벤트와 유저 프로필을 자동으로 이관합니다. 자세한 안내는 여기를 참고하세요.---

mixpanel-utils 라이브러리의 import_from_amplitude 함수를 사용하면 Amplitude 프로젝트의 데이터를 Mixpanel로 직접 이관할 수 있습니다.LBKSmputils.import_from_amplitude("Amplitude Key", "Amplitude Secret", "20210901T00", "20210930T23")LBKS- 날짜는 YYYYMMDDTHH 형식으로 지정합니다. - 이 방법은 Mixpanel의 Original ID Merge 방식에서만 지원됩니다 자세히 보기---이 외에도, CDP(Segment 등)나 Reverse ETL 도구(Census, Hightouch 등)를 통해서도 이관이 가능합니다. 각 방법의 세부 설정은 사용 중인 인프라와 데이터 구조에 따라 달라질 수 있으니, 공식 문서를 참고해 주세요.Amplitude에서 Mixpanel로 마이그레이션 공식 가이드 Warehouse Connector로 유저 프로퍼티 이관 Migration Service 안내

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

Engage API를 이용해 유저 프로필을 업데이트했지만 Mixpanel UI에서 보이지 않는 경우, 아래와 같은 원인과 점검 사항이 있습니다.1. distinct_id 일치 여부 확인 Mixpanel은 이벤트와 유저 프로필을 distinct_id로 연결합니다. 이벤트와 프로필 모두 동일한 distinct_id를 사용해야 UI에서 정상적으로 조회할 수 있습니다. distinct_id가 다르면 UI에서 해당 프로필이 보이지 않을 수 있습니다. 자세히 보기2. 프로필 생성/업데이트가 정상적으로 처리되었는지 확인 Engage API 호출 시 응답이 성공(예: status: 1)으로 나왔다면, 실제로 프로필이 생성되었는지 API로 다시 조회해보세요. 프로필 조회 방법3. UI 필터/검색 조건 확인 Users 탭에서 필터나 검색 조건이 잘못 설정되어 있으면 프로필이 보이지 않을 수 있습니다. 모든 필터를 해제하고 다시 확인해보세요.4. 프로필 속성 컬럼 노출 여부 UI에서 보이는 컬럼(프로퍼티)은 “Edit Columns”에서 선택한 항목만 노출됩니다. 필요한 컬럼이 선택되어 있는지 확인하세요. CSV 내보내기 및 컬럼 설정5. 반영까지 약간의 지연 API로 대량 업데이트 시 UI에 반영되기까지 약간의 시간이 걸릴 수 있습니다.6. $distinct_id 값이 잘못 지정된 경우 CSV나 API로 임포트할 때 $distinct_id가 잘못 지정되면 빈 프로필이 생성되거나, UI에서 찾기 어려울 수 있습니다. FAQ 참고위 사항을 점검해도 문제가 계속된다면, Engage API로 해당 distinct_id의 프로필을 조회해 실제로 데이터가 저장되어 있는지 확인해보는 것이 좋습니다. Engage API 프로필 조회 예시만약 여전히 해결되지 않는다면, Mixpanel 지원팀에 문의하는 것이 좋습니다.

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

제공하신 데이터를 Engage API를 통해 업데이트하는 방법은 올바르게 구성되어 있습니다. 아래와 같이 요청을 보내면 해당 유저 프로필이 업데이트됩니다.LBKSimport requests import jsonLBKSdata = [{ '$distinct_id': '28315', '$token': '6dffd554efe09b7c9b92fd7ffc87ee9f', '$ip': '0', '$set': { 'user_id': '28315', 'business_number': '8293001125', 'created_date': '2024-11-22', 'first_apply_date': '2024-12-04', 'first_payment_date': '2024-12-05', 'first_view_date': '2024-11-22', 'last_payment_date': '2025-06-25', 'raw_insert_id': '14e34b92-02d1-4540-8d11-08f83a8d660e', '$initial_referrer': 'EMPTY', '$initial_referring_domain': 'EMPTY' } }]LBKSresp = [requests.post](http://requests.post)( "[https://api.mixpanel.com/engage](https://api.mixpanel.com/engage)", headers={"Content-Type": "application/json"}, data=json.dumps(data) )LBKSprint(resp.json())LBKS**중요 확인 사항:- $distinct_id는 해당 유저의 고유 식별자로, 이벤트 트래킹 시 사용한 값과 동일해야 합니다. - $token은 Mixpanel 프로젝트 토큰입니다. - $ip를 "0"으로 설정하면 서버의 IP로 위치 정보가 잘못 저장되는 것을 방지할 수 있습니다 [공식 문서]. - $set 안에 원하는 프로필 속성을 자유롭게 추가할 수 있습니다.만약 UI에서 프로필이 보이지 않는다면:**- $distinct_id가 이벤트 트래킹에 사용한 값과 일치하는지 확인하세요. - 프로필이 정상적으로 생성되었는지, Users 페이지에서 해당 distinct_id로 검색해보세요. - 대량 업데이트 시 UI 반영까지 약간의 시간이 걸릴 수 있습니다. - 필터나 컬럼 설정이 잘못되어 있지 않은지 확인하세요 [참고].이 방식은 공식 문서의 예시와 일치합니다 [API 예시].추가로 궁금한 점이 있으면 말씀해 주세요!

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

Mixpanel에서 User 프로필(유저 프로필)을 삭제하는 방법은 다음과 같습니다.

- Users 페이지에서 직접 프로필을 선택하여 삭제할 수 있습니다.

Engage API의 delete-profile 엔드포인트를 사용하여 특정 $distinct_id의 프로필을 영구적으로 삭제할 수 있습니다. 요청 예시는 아래와 같습니다: LBKS[ { "$token": "YOUR_PROJECT_TOKEN", "$distinct_id": "USER_DISTINCT_ID", "$delete": "" } ]LBKS이 데이터를 POST [https://api.mixpanel.com/engage#profile-delete로](https://api.mixpanel.com/engage#profile-delete로) 전송하면 해당 프로필이 삭제됩니다. 추가로, 중복 프로필이 있을 경우 $ignore_alias` 옵션을 사용할 수 있습니다.> Permanently delete the profile from Mixpanel, along with all of its properties. The $delete object value is ignored - the profile is determined by the $distinct_id from the request itself. 공식 문서 참고 API 상세 설명

mixpanel-utils의 people_delete 함수를 사용해 조건에 맞는 여러 프로필을 일괄 삭제할 수 있습니다.LBKSmputils.people_delete(query_params={ 'selector' : '(("Albany" in properties["$city"]) and (defined (properties["$city"])))'})LBKS라이브러리 설명---이 방법들을 통해 Mixpanel에서 유저 프로필을 삭제할 수 있습니다.

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

이미 있는 데이터(동일한 $distinct_id를 가진 유저 프로필)가 다시 임포트될 경우, Mixpanel에서는 다음과 같이 처리됩니다: - 동일한 $distinct_id로 임포트: 이미 존재하는 프로필이 있다면, 새로 임포트된 데이터의 프로퍼티가 기존 프로필을 업데이트합니다. - 기존에 없는 프로퍼티는 새로 추가되고, - 이미 있는 프로퍼티는 새 값으로 덮어쓰기(Overwrite) 됩니다. - 즉, 가장 최근에 임포트된 값이 최종적으로 저장됩니다.- 다른 $distinct_id로 임포트: $distinct_id가 다르면 별도의 새로운 프로필이 생성됩니다. 이메일이나 이름이 같더라도 $distinct_id가 다르면 중복 프로필이 만들어집니다.> If you import profiles using $distinct_id values that already exist, those profiles will be updated with the additional profile properties. On the other hand, if you upload a profile that has the same email address or the same name as another existing profile, but a different $distinct_id, you will be uploading duplicates - they will not be combined. 관련 문서 참고즉, 동일한 $distinct_id로 임포트하면 기존 데이터가 최신 값으로 갱신됩니다.

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

Mixpanel에서는 이벤트가 중복될 경우, 이벤트 이름(event), distinct_id, timestamp(time), 그리고 $insert_id 이 네 가지 값이 모두 동일한 이벤트를 중복으로 간주하여 가장 최근에 수집된 이벤트만 쿼리 결과에 반영합니다. 나머지 중복 이벤트는 리포트에서 제외됩니다.- Deduplication(중복 제거) 기준: - event (이벤트 이름) - distinct_id (유저 식별자) - time (타임스탬프) - $insert_id (이벤트 고유 식별자)이 네 가지 값이 모두 동일하면, Mixpanel은 해당 이벤트를 중복으로 인식하고, 가장 마지막에 들어온 이벤트만 남깁니다. 추가적인 프로퍼티 값이 다르더라도, 위 네 가지가 같으면 중복으로 처리됩니다.- Deduplication 방식: - Query-Time Deduplication: 쿼리 시점에 즉시 중복이 제거되어 리포트에 반영됩니다. - Compaction-Time Deduplication: 백엔드에서 주기적으로 중복 이벤트를 정리하여 저장 공간을 최적화합니다. - Raw Export: 원본 데이터(Export)에는 중복 이벤트가 그대로 남아 있을 수 있습니다. 자세히 보기> Only the four key event properties listed above are used for deduplication. Additional event properties are not considered for the deduplication mechanism.

Deduplication Mechanism따라서, 이벤트가 중복되어 들어오더라도 위 기준에 따라 자동으로 중복이 제거되어 분석 결과에 영향을 주지 않습니다.

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

네, 맞습니다. Mixpanel에서는 동일한 $distinct_id를 가진 유저 프로필을 다시 임포트하면 기존 프로필이 새 데이터로 업데이트(덮어쓰기)됩니다. 즉, 과거 데이터부터 순차적으로 임포트하면, 각 시점의 값이 최신 값으로 계속 갱신되어 최종적으로 가장 마지막에 임포트된 값이 저장됩니다. 이 방식은 공식 문서에서도 동일하게 안내하고 있습니다—동일한 $distinct_id로 임포트하면 기존 프로필이 업데이트되고, 새로운 프로퍼티는 추가되며, 기존 프로퍼티는 새 값으로 덮어써집니다. 관련 문서 참고

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

임포트 이벤트 중에 connectionResetError가 발생하는 경우, 제공된 지식 소스에서는 이 오류의 구체적인 원인이나 해결 방법에 대한 직접적인 언급은 없습니다.다만, Mixpanel의 이벤트 임포트 및 API 연동 관련 문서에서는 네트워크 오류(예: 429, 5XX 등)가 발생할 경우 재시도(Exponential Backoff) 전략을 사용할 것을 권장하고 있습니다. 반면, 400번대 오류(데이터 유효성 문제 등)는 재시도하지 않아야 합니다. connectionResetError는 일반적으로 네트워크 연결이 비정상적으로 끊겼을 때 발생하는 오류로, 일시적인 네트워크 문제이거나 서버 측의 일시적 장애일 수 있습니다. 이런 경우에는 재시도 로직을 적용하는 것이 일반적인 권장 사항입니다. 관련 내용 참고정리하면, - connectionResetError는 네트워크 연결 문제로 발생할 수 있으며, - Mixpanel에서는 네트워크 오류 발생 시 재시도(backoff) 전략을 적용하는 것을 권장합니다.만약 오류가 지속적으로 반복된다면, 네트워크 환경이나 서버 상태를 점검하거나, Mixpanel 지원팀에 문의하는 것이 좋습니다. 지식 소스 내에 더 구체적인 원인이나 해결 방법은 명시되어 있지 않습니다.

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

네, Mixpanel API에는 요청 제한(레이트 리밋)이 있습니다. 주요 API별 제한은 다음과 같습니다: - Ingestion API (이벤트/프로필 임포트): 2GB의 비압축 JSON/분 또는 약 30,000 이벤트/초 (1분 단위 롤링 기준) 자세히 보기- Query API: 최대 5개의 동시 쿼리, 시간당 60회 쿼리 제한- Raw Data Export API: 최대 100개의 동시 쿼리, 시간당 60회, 초당 3회 쿼리 제한- GDPR/CCPA API: 초당 1회 요청 제한, 프로젝트당 최대 5년치 outstanding scan 제한 GDPR API 상세- Engage API (프로필 쿼리): 시간당 60회, 최대 5개 동시 쿼리 제한 Query API 제한API별로 세부 제한이 다르니, 대량 요청 시에는 이 점을 유의해야 합니다. Mixpanel 공식 레이트 리밋 안내

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

Mixpanel의 /engage API(Engage API)를 통해 유저 프로필을 업데이트할 때 적용되는 주요 제한(레이트 리밋)은 다음과 같습니다: - 한 번의 요청에 보낼 수 있는 프로필 수: 최대 2000개의 프로필 업데이트를 한 번에 전송할 수 있습니다. - 각 프로필 업데이트의 최대 크기: 각 개별 업데이트는 최대 1MB까지 허용됩니다.> The User Profile API imposes limits on the total number profile updates that can be sent per request to 2000 as well as limit each individual update in the request to a maximum of 1 MB. If you are running up against these limits, we suggest breaking your request into smaller batches. Usually these limits are only hit if you are attempting to do a bulk create/update. 출처: User Profile API Limits- 전체 API 요청의 속도 제한(레이트 리밋): Mixpanel Ingestion API 전체에 대해 2GB의 비압축 JSON/분 또는 약 30,000 이벤트/초(1분 단위 롤링 기준) 제한이 있습니다. 이 제한은 이벤트와 프로필 임포트 모두에 적용됩니다. 출처: Mixpanel API Rate Limits이 제한을 초과하면 429 에러(Too Many Requests)가 발생할 수 있으니, 대량 업데이트 시에는 요청을 여러 번에 나누어 보내는 것이 좋습니다.

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.

Let me check the knowledge base for you again. One moment! 📚

Mixpanel의 Engage API를 사용해 유저 프로필을 업데이트하는 요청 샘플은 아래와 같습니다.LBKSimport requestsLBKSurl = "[https://api.mixpanel.com/engage#profile-set](https://api.mixpanel.com/engage#profile-set)"LBKSpayload = [ { "$token": "YOUR_PROJECT_TOKEN", "$distinct_id": "USER_ID", "$set": { "$name": "Jane Doe", "$email": "jane.doe@​[example.com](http://example.com)", "plan": "Premium" } } ] headers = { "accept": "text/plain", "content-type": "application/json" }LBKSresponse = [requests.post](http://requests.post)(url, json=payload, headers=headers) print(response.text)LBKS- $token: Mixpanel 프로젝트 토큰 - $distinct_id: 업데이트할 유저의 고유 식별자 - $set: 추가하거나 변경할 프로필 속성이 샘플은 공식 문서에 안내된 예시와 동일합니다. 자세한 예시와 설명 보기

ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.