Twilio Segmentイベント

Twilio セグメントイベントについて

Twilio Segment イベントにより、Twilio Segment のイベントに基づいて Qualtrics にデータを送信するために、Qualtrics と Twilio Segment を統合することができます。Twilio Segment イベントでは、主に 3 つのユースケースがサポートされています。

1. Twilio セグメントのデータイベントに基づいてワークフローを開始します。
2. Twilio Segmentのイベントに基づいてXM Directoryの連絡先情報を更新しています。
3. Twilio Segment のイベントに基づいてトランザクションデータをコンタクトに追加します。

Twilio セグメントイベントの設定

Twilio Segment イベントを使用するには、Twilio Segment と Qualtrics の両方で設定を完了する必要があります。Twilio Segment インスタンス内に Webhook 宛先として Qualtrics を追加する必要があります。このセクションでは、Twilio Segment との初期統合の設定について説明します。

接続を設定するには、次のQualtrics IDが必要です。

• API トークン (すでにトークンがある場合は、新しいトークンを生成しないでください)
• データセンタ ID
• XM Directoryで連絡先を追加または更新する場合、連絡先を保存するディレクトリのディレクトリIDです。

Twilio セグメントへの接続

1. ワークフロータブで、ワークフローの作成をクリックします。
   
2. イベントの受信時に [開始] を選択します。
3. Twilio Segment イベントを選択します。
   
4. 別のブラウザタブで、Twilio Segment にログインします。クアルトリクスを終了しないでください。
5. 接続タブに移動します。
   
6. 宛先を追加をクリックします。
7. Qualtrics 接続を検索し、ワークスペースに追加します。クリックして、接続の設定を開始します。
8. 接続に名前を付けます。この名称は、組織的な目的で使用されます。
9. Qualtrics API トークンを入力します。トークンを見つけるためのサポートが必要な場合は、API トークンの生成を参照してください。
10. クアルトリクスデータセンターIDを入力します。データセンターの検索についてサポートが必要な場合は、「データセンター ID の検索」を参照してください。
11. 出力先を有効にするがオンになっていることを確認します。
12. [Save Changes] をクリックします。
13. マッピングタブで、新規マッピングをクリックします。
14. 実行する処理を以下から選択します。
    
    • XM Directoryで連絡先を作成/更新：Twilioセグメントのデータイベントに基づいて、XM Directoryで連絡先を追加または更新します。このイベントによって処理されるすべての連絡先は、ディレクトリの設定に従って重複解除されます。このオプションの設定の残りの部分については、「XM Directoryでの連絡先の追加または更新」を参照してください。
    • Upsert 連絡先トランザクション：連絡先にトランザクションデータを追加します。コンタクトが存在しない場合は、コンタクトが登録され、トランザクションデータがそのコンタクトに追加されます。このオプションの残りの設定については、コンタクトへのトランザクションの追加を参照してください。
    • Qualtricsでワークフローを開始：Twilioセグメントのデータイベントに基づいてQualtricsワークフローを開始します。このオプションの残りの設定については、「クアルトリクスワークフローのトリガ」を参照してください。
      ヒント：必要に応じてこれらのオプションをすべて使用できます。最初の設定後に必要なのは、追加のマッピングを登録することだけです。

XM Directoryで連絡先を追加または更新

Twilioセグメントイベントを使用すると、Twilioセグメントのデータに対する変更に基づいて、XM Directoryの連絡先を更新できます。

1. Twilio セグメントイベントの設定の指示に従って、Qualtrics と Twilio Segment を統合します。インテグレーションの設定時に［XM Directoryで連絡先を作成／更新］オプションを選択します。
2. 任意のフィルタ条件を追加します。これらの条件により、クアルトリクスにデータを送信するタイミングが決まります。
   
   ヒント：通常の設定では、この統合には「イベントの種類」が「特定」の条件が自動的に含まれます。必要に応じて、このフィルタを変更したり、新しいフィルタを追加したりすることができます。クアルトリクスに送信されるデータを制限するために、1つ以上のフィルターを含めることをお勧めします。
3. 必要に応じて、[テストイベントの追加] セクションを使用して、マッピングに含めることができるフィールドをテストします。
4. ［マッピングを選択］セクションで、クアルトリクスディレクトリIDをマッピングします。複数のディレクトリがある場合は、連絡先を追加するディレクトリを選択します。詳細については、「PoolID の検索」を参照してください。 
5. 必要に応じて、イベントフィールドマッピングを調整します。詳細については、こちらの「Twilio サポート」ページを参照してください。多くの場合、事前設定されたマッピングを調整する必要はありません。
6. ［保存］をクリックします。

取引先担当者へのトランザクションの追加

Twilio Segmentイベントを使用すると、XM Directoryの既存の連絡先にトランザクションデータを追加できます。連絡先がまだディレクトリに存在しない場合は、連絡先が作成されます。トランザクションデータは、新たに登録されたコンタクトに保存されます。

1. Twilio セグメントイベントの設定の指示に従って、Qualtrics と Twilio Segment を統合します。統合の設定時に、連絡先のアップサートトランザクションオプションを選択します。
2. 任意のフィルタ条件を追加します。これらの条件により、クアルトリクスにデータを送信するタイミングが決まります。
   ヒント：通常の設定では、この統合には「イベントの種類」が「追跡」、「イベント名」が「トランザクションが作成されました」の条件が自動的に含まれます。必要に応じて、このフィルタを変更したり、新しいフィルタを追加したりすることができます。クアルトリクスに送信されるデータを制限するために、1つ以上のフィルターを含めることをお勧めします。
3. 必要に応じて、[テストイベントの追加] セクションを使用して、マッピングに含めることができるフィールドをテストします。
4. ［マッピングを選択］セクションで、クアルトリクスディレクトリIDをマッピングします。複数のディレクトリがある場合は、連絡先を追加するディレクトリを選択します。詳細については、「PoolID の検索」を参照してください。
5. 必要に応じて、イベントフィールドマッピングを調整します（クアルトリクスに渡す追加のフィールドがある場合など）。詳細については、こちらの「Twilio サポート」ページを参照してください。多くの場合、事前設定されたマッピングを調整する必要はありません。
6. ［保存］をクリックします。

クアルトリクスワークフローのトリガ

Twilioセグメントイベントを使用すると、Twilioセグメントのデータイベントに基づいてQualtricsでワークフローを開始できます。

1. Twilio セグメントイベントの設定の指示に従って、Qualtrics と Twilio Segment を統合します。インテグレーションの設定時に Qualtrics でワークフローを開始オプションを選択します。
2. 任意のフィルタ条件を追加します。これらの条件により、クアルトリクスにデータを送信するタイミングが決まります。
   
   ヒント：クアルトリクスに送信されるデータを制限するため、1つ以上のフィルターを含めることをお勧めします。
3. テストイベント追加セクションを使用して、テスト項目マッピングを生成します。
   ヒント：テストイベントを生成するには、フィルター条件が1つ以上必要です。
4. Qualtricsで、Twilio Segmentイベントに戻ります。URL コピーをクリックします。
5. Twilio Segment に戻ります。Select mappings セクションで、コピーした URL を HTTP API フィールドにペーストして、ワークフロー URL にマッピングします。
6. 必要に応じて、クアルトリクスに渡すフィールドのマッピングを調整します。左側の列に、クアルトリクスに表示するフィールドの名前を入力します。
7. 右側の列で、ボックスをクリックしてフィールドを選択し、Qualtricsに渡すイベント変数を選択します。
8. テストレコードプレビュー表示を有効化します。
   ヒント：以前にテストマッピングを生成していない場合、このオプションを有効にすることはできません。テストイベント追加セクションまで上にスクロールして、テストマッピングを生成します。
9. JSON イベントペイロードを強調表示してコピーします。
10. ［保存］をクリックします。
11. Qualtricsの「Twilio Segment」イベントに戻ります。[詳細設定] セクションに移動します。
12. 先ほどコピーした JSON イベントペイロードを JSON オブジェクトフィールドにペーストします。
13. [フィールドマッピングの追加] をクリックします。JSON ペイロードに基づいて、フィールドが自動的にマッピングされます。
14. マップ項目セクションにナビゲートし、項目が正しくマッピングされていることを確認します。必要に応じて、フィールドを調整することができます。
15. パスについて、Twilio Segment の項目パス名に、Qualtrics に保存する項目を入力します。
16. [種類] で、フィールドに含まれるデータの種類を選択します:
    • 文字列: データはテキストの文字列です。
    • 数値: データは数値です。
    • ブール値: データはブール値 (true または false) です。
17. [フィールドの追加] をクリックして、追加フィールドをマッピングします。
18. マッピングから項目を削除するには、マイナス符号 ( – ) をクリックします。
19. 必要に応じて、統合をテストして、［テストデータを実行］をクリックし、Twilio Segment からイベントを起動して、適切なデータが Qualtrics に渡されるかどうかをチェックすることができます。詳細については、イベントデータのキャプチャを参照してください。
    ヒント：JSONPathの構文でJSONの解釈についての詳細を確認してください。
20. ［保存］をクリックします。
21. ワークフローにタスクを忘れずに追加してください。通常、これはアンケートを配信するXM Directoryのタスクです。
    ヒント：連絡先情報を保存または更新する場合は、「XM Directoryで連絡先を追加または更新する」を参照してください。
    例：顧客が Twilio Segment のレコードを更新する新しいユーザーオンボーディングツアーを完了したとします。その後、このデータ変更によって Qualtrics ワークフローがトリガーされ、これを使用してお客様にオンボーディング体験に関するフィードバックの提供を依頼する調査を配信することができます。