Mixpanelコネクタ
重要 - 画像/情報は四半期ごとのリリースで更新されます!
四半期ごとのリリースにて、最新の機能・情報を反映し、画像を含めた情報は更新されます。
| 重要: Gainsight は、Horizon Experience を使用して Connectors 2.0 をアップグレードしています。 この記事は、Horizon Experience for Connectors 2.0 にアップグレードされたテナントに適用されます。 以前のバージョンでコネクタ 2.0 を使用している場合は、ここでドキュメントを参照できます。 |
この記事では、MixpanelをGainsightと統合して、GainsightのすべてのMixpanelイベントデータにアクセスする方法について説明します。
メモ: このドキュメントでは、接続の作成に関する一般的なガイダンスを提供します。ジョブの使用例はそれぞれ異なり、独自の構成が必要なため、ジョブの作成に関する詳細については、この記事の最後にある「その他のリソース」セクションの「コネクタの構成」を参照してください。
[概要]
Mixpanelは、Webサイトから顧客の使用状況データを取得し、そのデータをMixpanelと統合されている任意のシステムに送信する顧客データプラットフォームです。MixpanelをGainsightと統合して、顧客の使用状況データをカスタムGainsightオブジェクトにインポートします。Mixpanelの統合により、Mixpanelがイベントをキャプチャすると使用状況データがGainsightに引き込まれるため、データジョブのスケジュールを設定する必要はありません。
たとえば、利用状況データには、電子商取引サイトでの商品の閲覧数や、サイトでの顧客活動の経時的な追跡が含まれます。
GainsightとMixpanelを統合するメリット: Gainsightに保存されている使用状況データを分析して、より良い製品を設計したり、素晴らしいカスタマーサービスを提供したり、オーディエンスを増やしたりすることができます。
GainsightによるMixpanelインテグレーションの設定
推奨事項
Gainsightは、Mixpanelのイベント、ユーザー、および関連するプロパティをサポートして、ウェブサイトでのページ読み込みをトラッキングします。詳細については、この記事の最後にある「その他のリソース」セクションの「使用状況データの追跡」を参照してください。.
前提条件
- ウェブトラッキングコードをインストールして、Mixpanelをアプリケーションと統合します。詳細については、この記事の「Mixpanelとアプリの統合」セクションを参照してください。
- イベントと人物のデータを保存するために、必要に応じてGainsightカスタムオブジェクトを作成するか、用意してください。カスタムオブジェクトの作成方法の詳細については、この記事の最後にある「その他のリソース」セクションの「Gainsight Data Management」を参照してください。
- オブジェクトを作成するときは、必ず次のフィールドを含める必要があります。
- アカウント識別子
- イベント識別子
- 時間識別子
- ユーザー識別子
- ユーザー名
- ユーザー苗字
- ユーザーのメール
さらに、Mixpanelプロジェクトのマッピングに必要なフィールドを追加します。
- GainsightオブジェクトにデータをインポートしたいMixpanelプロジェクトからAPIシークレットキーをコピーします。詳細については、Mixpanel: 個人設定の記事のプロジェクト トークン、API キー、および API シークレットの表示を参照してください。
Mixpanelとアプリケーションの統合
ウェブサイトにMixpanelウェブトラッキングコードをインストールして、Mixpanelをアプリと統合します。
メモ: Mixpanel ウェブトラッキングコードが既にウェブサイトにインストールされている場合は、この手順をスキップできます。
Mixpanelがサイトにインストールされていない場合は、Mixpanel実装ガイドの記事の指示に従って、Mixpanel Javascriptライブラリをサイトに直接追加してください。次の画像は、ウェブトラッキングコードの例を示しています。
重要: プロジェクトのトークンを使用する必要があります。
使用状況データを追跡する
Gainsightは、Mixpanelのイベント、ユーザー、および関連するプロパティをサポートして、Mixpanelウェブサイトでのページ読み込みをトラッキングします。次のコードスニペットには、Mixpanel 統合に推奨される 3 つのプロパティが含まれています。
Mixpanelを使用して追跡されたウェブページのプロパティは次のとおりです。
- Mixpanelでページの読み込みをトラッキングするには、トラックAPIコールを追加する必要があります。この呼び出しは、ページが読み込まれるときに呼び出されます。
- ページに関連する詳細は、イベントの属性として渡されます。
- Mixpanelは、ユーザーをUI上のアクションにリンクし、ユーザーに関する特性を記録します。これには、固有のユーザー ID と、メールアドレス、名前などの任意の特性が含まれます。
- 上記のコードスニペットに示すように、MixpanelインテグレーションでPageLoadイベントと一緒に使用することが推奨される3つのプロパティを以下に示します。
- pageTitle: このプロパティは、URL 構造を無視して、ページに割り当てられた名前を追跡します。これは、ほとんどすべての URL がユニークな Web サイトや、URL がフォルダー構造に従わないウェブサイトに最適です。
- pagePathLevelOne: このプロパティは URL をフォルダー階層にグループ化し、最上位フォルダーの下にあるすべてのページのメトリックを集約します。これは、階層的に構成された URL が多数ある Web サイトに最適です。
- pageURL: このプロパティはすべてのページを個別に追跡します。これは、個別の URL の数が少ない Web サイトに最適です。
メモ: このドキュメントでは、イベントと関連プロパティを使用しています。
概説されているMixpanelコードをすべてまとめると、すべてのWebページのコードは次の例のようになります。
Mixpanel接続を作成
このセクションでは、Mixpanelとの接続を作成する方法について説明します。接続が作成されると、データジョブは使用状況データを Gainsight カスタムオブジェクトに取り込むように構成されます。
メモ: [管理] > [コネクタ 2.0] > [接続] ページで複数のMixpanel接続を作成します。
Mixpanelとの接続を作成するには:
- [管理] > [コネクタ 2.0] > [接続] に移動します。
- 「接続を作成」をクリックします。[接続の作成] ダイアログが表示されます。
- コネクタドロップダウンリストから Mixpanel を選択します。
- 接続の名前を入力します。
- ドロップダウンリストからタイムゾーンを選択します。Mixpanelプロジェクトで設定されているタイムゾーンを選択してください。
メモ: Mixpanelプロジェクトで設定されているタイムゾーンとは異なるタイムゾーンを選択すると、データにエラーが含まれる可能性があります。 - プロジェクトからコピーしたAPIシークレットキーをMixpanelのウェブサイトに入力します。
- (オプション) 接続をテストするには、「接続をテスト」をクリックします。
- [保存] をクリックして接続を作成します。
データジョブの作成
メモ: [管理] > [コネクタ 2.0] > [接続] ページで、Mixpanel接続ごとにデータジョブを作成します。
データジョブを作成するには:
- 「ジョブ」ページに移動します。
- [ジョブを作成] をクリックします。[ジョブの作成] ダイアログが表示されます。
- 「ジョブの名前」テキストボックスにジョブ名を入力します。
- [次へ] をクリックします。「ジョブの準備」ページが表示されます。
- データソースでMixpanelを選択します。次の 4 つのセクションを含む「準備」タブが表示されます。
- ジョブの詳細
- メタデータを取得
- マップメタデータ
- データをインポート
ジョブの詳細
「ジョブの詳細」セクションで、次のアクションを実行します。
- 接続: デフォルトでは、 Mixpanel接続が選択されています。接続タイプは変更できません。
- コネクタ: コネクタ名が表示されます。
- タイムゾーン: タイムゾーンを表示します。
- エンゲージメントタイプ: [+] アイコンをクリックし、ドロップダウンから [イベント] または [ユーザー] を選択します。Gainsightは2つのエンゲージメントタイプをサポートしています。顧客の使用状況データを追跡するためのイベントとピープル。
- [保存] をクリックします。
メタデータを取得
「メタデータの取得」セクションで、次のアクションを実行します。
- 使用状況メタデータを抽出する日付範囲を選択します。これにより、選択した日付範囲のすべてのイベントが取得されます。デフォルトでは、過去 5 日間の日付範囲があらかじめ入力されています。
注意：日付範囲で最大 7 日間 (1 週間) を選択できます。
- 「電子メール通知の送信」に、次の場合の受信者の電子メールアドレスを入力します。
- 成功時の電子メール: メタデータが正常にインポートされると、ここに入力されたメールアドレスに成功通知メールが送信されます。
- 失敗時の電子メール: メタデータのインポートに失敗すると、ここに入力されたメールアドレスに失敗通知メールが送信されます。
メモ: デフォルトでは、「成功」フィールドと「失敗」フィールドには、ログインしているユーザーのメールアドレスが入力されます。
- 「メタデータを取得」をクリックします。次の UI 通知が表示されます。以下に示すように、メタデータ生成の成功通知が電子メールで届きます。
メタデータの生成に失敗すると、適切な失敗通知が表示されます。
- [マッピングを表示] をクリックして [マップメタデータ] セクションに移動します。UI メッセージ「マッピングが正常に取得されました」が表示されます。
マップメタデータ
イベントマッピング
「イベントマッピング」セクションで、次のアクションを実行します。
- Gainsightカスタムオブジェクトを選択して、Mixpanelからイベントデータをロードします。例えば、MixPanelオブジェクトは以下のように選択されています。
- 「必須」タブで、以下に示すように、Mixpanelメタデータをアカウント識別子、イベント識別子、および時間識別子のターゲットGainsightオブジェクトのフィールドにマップします。
- (オプション) イベントデータ変換には以下のアクションを実行します。
- アカウント識別子とイベント識別子の変換アイコンをクリックして、イベントレコードを変換します。変換ダイアログが表示されます。
メモ: 時間識別レコードには変換を実行できません。 - 変換ダイアログで:
- デフォルト値: NULL レコードにデフォルト値を割り当てます。
- ケースを変更: レコードの大文字と小文字を「小文字」または「大文字」に変更します。
- 置換: ソースレコードの名前を指定された値とともに入力します。
- と: この値に置き換えるソースレコードの値を入力します。
- 「適用」をクリックします。
- アカウント識別子とイベント識別子の変換アイコンをクリックして、イベントレコードを変換します。変換ダイアログが表示されます。
- 「追加」タブで「追加」をクリックして、追加のMixpanelメタデータをターゲットGainsightオブジェクトのフィールドにマップします。
ピープルマッピング
「ピープルマッピング」セクションで次のアクションを実行します。
- Gainsightカスタムオブジェクトを選択して、Mixpanelから人物データを読み込みます。たとえば、Mixpanel の「ピープル」は以下のように選択されています。
- 「必須」タブで、以下に示すように、MixpanelメタデータをGainsightオブジェクト、Mixpanel People（ユーザー識別子）、ファーストネーム、ラストネーム、メールの各フィールドにマッピングします。
- 必要に応じて、[識別子]、[名]、[姓]、[電子メール] の値に変換を適用します。詳細については、「イベントマッピング」セクションの変換ステップを参照してください。
- 「追加」タブで「追加」をクリックして、追加のMixpanelメタデータをターゲットGainsightオブジェクトのフィールドにマップします。
データをインポート
「データのインポート」セクションで次のアクションを実行します。
- 次のいずれかのオプションを使用して、Mixpanelからデータをインポートします。
- 今すぐインポート: このオプションを使用して、MixpanelからGainsightオブジェクトに今すぐデータをインポートしてください。最大 2 週間の日付範囲を選択し、その期間内に入手可能なデータをインポートします。
注意：2 週間を超えるデータをインポートする場合は、適切な日付範囲内でインポートオプションを複数回使用できます。
- 予定インポート: このオプションを使用すると、Mixpanelから毎日のスケジュールでデータをインポートできます。スケジューラーは、ユーザーが指定した時刻に毎日実行され、スケジュールされた実行日の N 日前にデータを取得します。
メモ: たとえば、昨日のデータをインポートするには、N 日を 1 に設定する必要があります。過去 2 日間のデータをインポートする場合と同様に、N 日数は 2 に設定する必要があります。Mixpanel接続のタイムゾーンはここに表示されます。
- 「電子メール通知の送信」に、次の場合の受信者の電子メールアドレスを入力します。
- 成功時の電子メール: データが正常にインポートされると、ここに入力されたメールアドレスに成功通知メールが送信されます。
- 失敗時の電子メール: データのインポートに失敗すると、ここに入力されたメールアドレスに失敗通知メールが送信されます。
メモ: デフォルトでは、「成功」フィールドと「失敗」フィールドには、ログインしているユーザーのメールアドレスが入力されます。
- [データインポートを開始] をクリックします。次の UI 通知が表示されます。
イベントや人物のデータインポートが成功すると、メールで個別に通知が届きます。イベントや人物のデータインポートが失敗すると、それに応じて失敗通知が届きます。イベントのデータインポートが成功したことを示す通知を以下に示します。
People のデータインポートの成功通知を以下に示します。
ジョブリスト
ジョブリストページでは、各Mixpanel接続のデータジョブを確認できます。ジョブリストページで既存のデータジョブを編集または削除します。[管理] > [コネクタ 2.0] > [接続] ページで、Mixpanel接続ごとにデータジョブを作成できます。詳細については、この記事の最後にある「その他のリソース」セクションのジョブリストページを参照してください。
アクティビティ
アクティビティページには、すべてのデータジョブの実行アクティビティと更新アクティビティが表示されます。このページからジョブ実行のログをダウンロードすると、構成の問題のトラブルシューティングに役立ちます。詳細については、この記事の最後にある「その他のリソース」セクションのアクティビティ ページを参照してください。
使用状況データ集計
ルールを使用して顧客の使用状況データを集計します。使用状況データの集計を実行して集計のスケジュールを設定するには、この記事の最後の「その他のリソース」セクションの「ルールエンジンを使用した使用状況データの集計」を参照してください。
この記事で説明されている機能について質問やフィードバックがある場合は、community.gainsight.comで共有してください