Mixpanel からの移行

Amplitudeプロフェッショナルサービスチームは、Mixpanelから移行してインサイトを迅速に得られるよう、このガイドを編集しました。

Mixpanel 履歴データをインポートする

AmplitudeはAPIを使用してMixpanelから履歴データを移行するための2つのオプションを提供しています：

• Mixpanelインポートツール：履歴イベントデータをすばやく送信するのに最適です。
• バッチイベントアップロードAPI：イベントやユーザープロフィールのプロパティなどの履歴データを大規模に送信するのに最適です。

Mixpanel インポートツール

このツールは、MixpanelプロジェクトのAPIキーまたはサービスアカウントの認証情報を使用して、MixpanelのエクスポートAPIを使用してイベントデータをエクスポートし、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から移行したAmplitudeのお客様の一般的なユースケースに基づいて構築されています。
• より広範なタクソノミーに関するガイダンスについては、『データタクソノミープレイブック』を参照してください。

計装方法を選択する

Amplitudeのクライアント側、サーバー側、またはサードパーティを通じてデータを送信できます。 イベントを追跡する場所に応じて、次のオプションを使用できます。

• クライアント側のイベントトラッキング：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 は 'mixpanel.identify()' メソッドを使用してユーザーを識別します。これには、distinct_id（特定のプラットフォーム上でランダムに生成された識別子）と user_id（実装チームが設定したもの）の組み合わせが使用されます。
• Amplitudeは'amplitude.identify()'メソッドを使用してユーザーを識別します。これには、device_id（特定のプラットフォーム上でランダムに生成された識別子）とuser_id（実装チームが設定したもの）の組み合わせが使用されます。

AmplitudeがユーザーIDをどのように解決するかについての詳細は、「ユニークユーザーの追跡」を参照してください。

データプライバシーに関する考慮事項

カスタマーデータを管理する際には、以下の機能と領域を考慮してください。

• Time to Live(TTL):イベントデータがAmplitudeインスタンスに保存される期間を制御するAmplitude機能です。
• オプトアウトを管理する方法：ウェブサイト訪問者がアクティビティ追跡を無効にできるようにするSDK設定。
• IPアドレス：Amplitudeはデフォルトでクライアント側のトラッキングを使用してIPアドレスと位置情報に基づく詳細情報をキャプチャします。このトラッキングを無効にするには、ブラウザSDK | オプションのトラッキングを参照してください。
• ユーザープライバシーAPI：既知のAmplitude IDまたはユーザーIDのセットに関するすべてのデータを削除するためのAPIです。
• セキュリティとプライバシーに関するAmplitudeのスタンス

GDPRコンプライアンス

AmplitudeはGDPRに完全に準拠しています。 コンプライアンスに関する詳細については、「セキュリティとプライバシー」を参照してください。

AmplitudeはユーザープライバシーAPIを維持しており、これによりエンドユーザーのデータ削除リクエストに対応できます。

フィードバックや質問

この実装ガイドに関するフィードバックや質問を送信するには、こちらのフォームを使用してください。