Mixpanel에서 마이그레이션

Amplitude 프로페셔널 서비스 팀은 Mixpanel에서 마이그레이션하고 신속하게 인사이트를 얻을 수 있도록 이 가이드를 작성했습니다.

Mixpanel 기록 데이터 가져오기

Amplitude는 API를 사용하여 Mixpanel에서 과거 데이터를 마이그레이션할 수 있는 두 가지 옵션을 제공합니다.

• Mixpanel 가져오기 도구: 과거 이벤트 데이터를 빠르게 전송하는 데 가장 적합합니다.
• 배치 이벤트 업로드 API: 이벤트 및 사용자 프로필 속성을 비롯한 기록 데이터를 대규모로 전송하는 데 가장 적합합니다.

Mixpanel 가져오기 도구

Mixpanel 프로젝트의 API 키 또는 서비스 계정 자격 증명을 사용하여, 이 도구는 Mixpanel의 Export API를 통해 Mixpanel에서 이벤트 데이터를 내보내고 Amplitude 프로젝트로 가져옵니다.

제한 사항

• 이 도구는 배치당 약 160,000개의 이벤트를 처리합니다.
• 이 도구는 사용자 프로필 가져오기를 지원하지 않습니다. 사용자 프로필 정보를 가져오려면 다음 옵션 중 하나를 사용하십시오.
  • Mixpanel Export 및 Engage API를 사용하여 Mixpanel에서 데이터를 내보내고, 일괄 이벤트 업로드 API를 사용하여 Amplitude로 가져옵니다.
  • Amplitude 서포트나 Amplitude 계정 관리자에게 문의하여 Amplitude 프로페셔널 서비스 팀의 맞춤형 서비스를 받으십시오.

문제 해결

가져오기 도구가 인증 오류와 함께 응답하는 경우:

• Mixpanel 가져오기 도구에 올바른 인증을 제공했는지 확인하십시오.
• Mixpanel 프로젝트의 API 키를 사용하는 경우 올바른 프로젝트를 참조하십시오. Mixpanel의 각 프로젝트는 자체 API 키를 갖습니다.
• Mixpanel 서비스 계정을 사용하는 경우 다음과 같이 자격 증명을 입력하십시오.

• Mixpanel 프로젝트의 서비스 계정에 대한 사용자 이름과 암호를 가지고 있지 않은 경우, 프로젝트에 대한 새 서비스 계정을 생성하고 값을 복사하십시오.
• 귀하의 Mixpanel 서비스 계정에 필요한 정보에 액세스할 수 있는 권한이 있는지 확인하십시오. Mixpanel의 데이터 다운로드 페이지에서 자격 증명을 테스트하십시오. 페이지에 200상태가 표시되면 서비스 계정에 필요한 권한 관리가 있는 것입니다.

가져오기 도구가 완료되지 않거나 일반 오류로 응답하는 경우:

• 데이터 세트가 너무 커서 처리할 수 없을 수 있습니다. 일괄 처리당 최대 160,000개의 이벤트를 넘지 않도록 목표로 더 좁은 시간 범위에서 다시 시도하십시오.

도구가 예상보다 적은 수의 트랜잭션을 가져올 경우:

• Amplitude는 중복 이벤트를 감지하여 제외합니다. 데이터에 많은 중복 항목이 포함되어 있는 경우 Amplitude는 예상보다 적은 수의 이벤트를 가져옵니다.
• 일부 Mixpanel 이벤트는 누락된 정보로 인해 Amplitude 이벤트와 호환되지 않을 수 있습니다. Mixpanel 계측이 name, date, 또는 device ID과 같은 필드를 캡처하지 않는 경우 Amplitude는 해당 이벤트를 가져오지 못할 수 있습니다.

Amplitude 배치 이벤트 업로드 API

Mixpanel API를 통해 Mixpanel에서 데이터를 내보내고 배치 이벤트 업로드 API를 사용하여 Amplitude에 업로드하세요. 데이터를 다른 외부 소스에 호스팅하는 경우, 배치 엔드포인트를 사용하여 데이터를 Amplitude에 업로드할 수도 있습니다.

프로페셔널 서비스

Amplitude 프로페셔널 서비스 팀의 맞춤형 서비스를 받으려면 Amplitude 계정 관리자에게 문의하십시오.

Mixpanel에서 새로운 Amplitude 추적 계획 수립

제품 목표 설정

구현을 시작하기 전에 이해 관계자와 팀 구성원들이 데이터에서 얻고자 하는 내용과 중점을 두어야 할 활용 사례에 대해 동의하는지 확인하십시오.

업종별 일반적인 활용 사례

데이터 택소노미 설계 및 계측

• Mixpanel에서 마이그레이션한 Amplitude 고객의 일반적인 사용 사례를 바탕으로 작성된 Mixpanel to Amplitude 택소노미 워크북을 검토하십시오.
• 더 광범위한 택소노미 지침은 데이터 택소노미 플레이북을 참조하십시오.

계측 방법 선택

Amplitude 클라이언트 측, 서버 측 또는 제3자를 통해 데이터를 전송할 수 있습니다. 이벤트를 추적하는 위치에 따라 다음 옵션을 사용하십시오.

• 클라이언트측 이벤트 트래킹: Amplitude SDK 카탈로그를 사용하십시오. 기존 계측기를 교체하려면 Amplitude 매핑을 참조하십시오.
• 서버측 이벤트 트래킹: Amplitude HTTP API 사용.

Mixpanel 메서드를 Amplitude 메서드로 매핑

Mixpanel과 Amplitude 트래킹 및 식별 방법 간의 매핑은 데이터 유형에 따라 다릅니다.

이벤트 트래킹

• Mixpanel은 이벤트 이름과 일련의 속성을 취하는 'mixpanel.track()'메서드를 사용하여 이벤트를 추적합니다.
• Amplitude는 이벤트 이름과 일련의 속성을 JSON 객체로 취득하는 'amplitude.getinstance().logEvent()' 메서드를 사용하여 이벤트를 추적합니다.

속성 추적

Mixpanel 슈퍼 속성은 모든 후속 이벤트에 연결됩니다. Amplitude 사용자 속성은 비슷하게 작동합니다. 설정한 후에는 Amplitude가 수집하는 모든 후속 이벤트에 연결됩니다.

• Mixpanel에서 'mixpanel.register()'메서드를 사용하여 슈퍼 속성을 설정합니다.
• Amplitude에서 메서드를 사용하여 사용자 'amplitude.identify()'속성을 업데이트합니다.

사용자 식별

• Mixpanel은 distinct_id(특정 플랫폼에서 무작위로 생성된 식별자)와 user_id(계측 팀이 설정한 식별자)의 조합을 사용하여 'mixpanel.identify()'방법으로 사용자를 식별합니다.
• Amplitude는 device_id(특정 플랫폼에서 무작위로 생성된 식별자)와 user_id (계측 팀에서 설정한 식별자)의 조합을 사용하여 이 방법을 통해 'amplitude.identify()'사용자를 식별합니다.

Amplitude가 사용자 ID를 확인하는 방법에 대한 자세한 내용은 고유 사용자 추적을 참조하세요.

데이터 개인 정보 보호 고려 사항

고객 데이터를 관리할 때 다음과 같은 기능과 영역을 고려하십시오.

• TTL(Time to Live): Amplitude 인스턴스에서 이벤트 데이터가 유지되는 기간을 제어하는 Amplitude 기능입니다.
• 옵트아웃을 관리하는 방법: 웹사이트 방문자가 활동 추적을 비활성화할 수 있도록 해주는 SDK 설정입니다.
• IP 주소: Amplitude는 기본적으로 클라이언트 측 추적을 통해 IP 주소와 위치 기반 세부 정보를 캡처합니다. 이 추적을 비활성화하려면 브라우저 SDK | 선택적 추적을 참조하십시오.
• 사용자 개인정보 보호 API: 알려진 Amplitude ID 또는 사용자 ID 세트의 모든 데이터를 삭제하기 위한 API입니다.
• 보안 및 개인정보 보호에 대한 Amplitude의 입장

GDPR 컴플라이언스

Amplitude는 GDPR을 완벽하게 준수합니다. 컴플라이언스에 대한 자세한 내용은 보안 및 개인정보 보호를 참조하십시오.

Amplitude는 최종 사용자 데이터 삭제 요청을 처리할 수 있는 사용자 개인정보 보호 API를 유지합니다.

피드백 또는 질문

이 구현 가이드에 대한 의견이나 질문을 제출하려면 이 양식을 사용하십시오.