Gainsightとの統合

Gainsightとの統合について

Gainsightは、カスタマーエンゲージメントを強化し、保持/定着率/離職防止を向上させ、事業拡大を推進するためのカスタマーサクセス・プラットフォームです。

クアルトリクスアカウントとGainsightを統合して、プラットフォーム間でデータを受け渡し、Gainsightのイベントに基づいてクアルトリクスのワークフローをトリガーすることができます。例えば、カスタマーがGainsightでトラッキングされたオンボーディングジャーニーを完了した場合、そのカスタマーにクアルトリクス経由でフォローアップアンケートを送り、オンボーディングエクスペリエンスについて尋ねることができます。

ステップ1：認証機能ヘッダーの作成

Gainsightとの接続を設定するには、Basic認証ヘッダーが必要です。このヘッダはBase64エンコードされた文字列で、クアルトリクスのユーザー名とAPIトークンをコロンで区切って含んでいます。ヘッダーを作成する：

1. クアルトリクスのユーザー名とクアルトリクスAPIトークンを検索します。
   注意既にAPIトークンをお持ちの場合は、新たに生成しないでください。
2. 以下のフォーマットで認証文字列を作成する：”username:APItoken”。
3. Base64エンコーダーを使って文字列をエンコードする。
4. このキーは後で使うために取っておく。

ステップ2: JSONイベントの設定

次へ、Gainsightから送信されたデータを受け取るために、新しいクアルトリクスワークフローを作成します。このワークフローは、純粋にトリガーとして使用することもできるし、後のワークフローのステップで有用なデータをインジェストすることもできる。

1. クアルトリクスで、ワークフローページに移動します。
2. ワークフローの作成」をクリックします。
3. イベント受信時に開始を選択。
4. ワークフローに名前をつける。
5. ワークフローをスタンドアロンワークフローとして保存します。
6. ワークフローの作成」をクリックします。
7. JSONイベントを選択します。
8. JSONイベントで、「URLをコピー」をクリックします。このURLは後で使えるように保存しておきましょう。

この時点で、上記のステップで作成したJSONイベントを使用して、統合を設定し、ワークフロー内の他のタスクをトリガーすることができます。単にワークフローを開始する必要がある場合は、以下の追加ステップをスキップして、JSONイベントを保存することができます。ただし、Gainsightからクアルトリクスに追加データを渡したい場合（例えば「Company GSID」や「Renewal Date」など）は、JSONイベントにそれらのフィールドを追加する必要があります：

1. JSONイベントの詳細設定セクションに移動します。
2. Add a JSON fieldをクリックします。
3. JSONフィールド名を入力します。
4. JSONパス式を定義します（単純なキーと値のペアの場合は、”$.[fieldName]”を使用します。例えば、”$.companyGSID”）。
5. ［保存］をクリックします。

これらのJSONフィールドは、後続のワークフロータスクで「イベントデータ」として利用できるようになります：ユーザー定義フィールドこれらはテキストの差し込みメニュー{a}からアクセスできます。

ステップ3：カスタムGainsightコネクタの作成

次へ、クアルトリクスと接続するために、Gainsightで新しいカスタムコネクタを作成する必要があります。このコネクタには先ほどの認証トークンが保存され、GainsightのExternal Actions経由でクアルトリクスにデータを送信するために使用されます。

クアルトリクスに必要なコネクタは1つだけです。クアルトリクス用のカスタムコネクタがすでに存在する場合は、Gainsightの外部アクションの設定について次へ進んでください。

1. Gainsight で「管理」に移動します。
2. Integrationsを選択し、次にConnectors 2.0を選択します。
3. Create Connectionをクリックします。
4. カスタムコネクタを選択します。
5. 接続先に名前をつける。
6. 認証タイプを選択します：トークン・ベース
7. 以下のヘッダーのキーと値のペアを入力する：
   • キー“認証”
   • 値：”基本{{先ほどのユーザー名とトークンの値をエンコードしたもの}}”
     例値は次のようになります
     :Basic ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=Refer
     theHTTP BASIC AUTHsection ofthis support pagefor more information.
8. コネクタの説明がわかるように入力します。
9. 保存をクリックする。

ステップ4：Gainsight外部アクションの設定

カスタムコネクタを作成したら、Gainsightで外部アクションを設定して、クアルトリクスのJSONイベントにリクエストを送信します。Gainsightをトリガーとする複数のワークフローを作成したい場合は、ワークフローごとに個別の外部アクションを作成する必要があります。

クアルトリクスに必要なコネクターは1つだけです。クアルトリクスとの対話に使用されるすべての外部アクションは、同じクアルトリクスカスタムコネクタの下にある必要があります。

1. Gainsight で「管理」に移動します。
2. Integrationsを選択し、次にExternal Actionsを選択する。
3. ページ上部のCreate Actionをクリックします。
4. 先ほど作成したクアルトリクス カスタム コネクタを選択します。
5. アクションの名前を入力します。これは後で編集することはできない。
6. メソッドはPOSTを 選択してください。
7. 先ほどコピーしたJSONイベントURLを、新しい外部アクションのURLフィールドに貼り付けます。

次へ、リクエストのペイロードを設定する必要があります。この Gainsight 外部アクションをトリガーとしてのみ使用し、追加のデータを送信する必要がない場合は、保存する前にペイロードに開括弧と閉じ括弧を追加するだけです。Gainsightからクアルトリクスに追加データを送信する場合は、ペイロードにキーと値のペアを追加する必要があります：

1. クアルトリクスに送信する各フィールドのキーと値のペアを入力します。
   • • 各キーは、クアルトリクスのJSONイベントのJSONフィールド名と完全に一致する必要があります。
     • 各値は、静的な値として構成することも、ルール・エンジンのようなGainsightの他の領域からの入力を受け入れるためにトークン化することもできます。
     • 各キーと値のペアはカンマで次へ区切る。
       例以下は、先ほど設定したフィールドの JSON ペイロードです。
       
"companyGSID" : "{{Company_GSID}}",
"recipientEmailAddress" : "{{Recipient_Email}}"
}.
2. ページ上部のCreateをクリックし、外部アクションを保存します。

接続のテスト

接続をテストする：

1. クアルトリクスで、先ほど作成したJSONイベントを開きます。
2. ［有効化］を テストを実行. イベント待ちのメッセージが表示されます。
3. Gainsightで、先ほど作成した外部アクションに移動します。
4. ページ上部の「テスト 」をクリックします。
5. テストしたい各キー・バリューに値を入力する。
6. Test Actionをクリックする。

テストが成功すると、Status Code 202、eventId、requestIdが返される。

また、クアルトリクス内の「 最新のテストからキャプチャされたJSON 」にテストのキーと値のペアが表示されます。

ステップ 5: ルール・エンジンで Gainsight 外部アクションを使用する

新しく設定した外部アクションを使用するには、Rules Engine内で「Call External API」アクションを使用する必要があります。このアクションにサブミットされた各行は独立して実行されるので、Call External APIアクションを使用した100レコードのデータセットは、100回の別々のAPIコールになります。

1. Gainsight で「管理」に移動します。
2. ルールエンジンを選択します。
3. クアルトリクスに送信したいデータを含むルールを作成します。データセットを構成するこれらのフィールドは、あなたのユースケースに固有のものとなる。
4. ルールの “Action Setup “セクションで、プラス記号（+）をクリックする。
5. Add Criteria “画面で “Skip This Step “をクリックします。
6. Create Actionをクリックし、Call External APIを選択します。
7. 先ほど作成したクアルトリクス コネクタを選択します。
8. 先ほど作成した外部アクションを選択する。
9. ソースフィールドの値（ルールデータセットから）をアクションフィールドのキー（JSONペイロードから）にマッピングします。
   Qtip:データセットからフィールドをマッピングする代わりに、静的な値をソースフィールドとして設定することができます。
10. Save Actionsをクリックします。