Qualtrics Social Connect との統合

Qualtrics Social Connect との統合について

Qualtrics Social Connectと統合すると、デジタル顧客からのフィードバックをすべて1つの場所で統合および分析できます。CXダッシュボードにText iQを含むQualtricsの分析方法を使用して、データを分析できます。

ステップ 1: 権限ヘッダの登録

このセクションでは、統合の権限ヘッダを登録する方法について説明します。これは、Qualtrics Social Connect との統合を設定するために必要です。

1. ［アカウント設定］に移動します。
2. アカウントの［クアルトリクスID］セクションに移動して、APIトークンをコピーします。API トークンがすでにある場合は、新しい API トークンを生成しないでください。
3. クアルトリクスのユーザー名を書き留めます。通常、これはクアルトリクスへのログインに使用するメールアドレスです。クアルトリクスのユーザー名がわからない場合は、ブランド管理者にお問い合わせください。
4. クアルトリクスユーザー名を使用して、次の形式で認証情報文字列を作成します：
   <クアルトリクスユーザー名>:<クアルトリクスAPIトークン>
   ヒント：SSOを使用してクアルトリクスにログインする場合は、ユーザー名の#コンポーネントを含めてください。

   例: 認証情報文字列の例:

   barnaby@qualtrics.com:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki

5. base64 エンコードで認証情報文字列をエンコードします。これを行うには、任意の base64 エンコーダをオンラインで使用することができます。

   例：base64 でエンコードされた認証情報文字列は:
   です。

   YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=

6. 認証ヘッダを次の形式で構築します: Basic <base64 encoded credentials>. “基本” と認証情報の間のスペースに注意してください。

   例: 最後の権限ヘッダ:

   基本 YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=

次のセクションでは、この権限認証情報が必要になります。簡単にアクセスできる場所にコピーしてください。

ステップ 2: Qualtrics Social Connect での自動化の作成

このセクションでは、Qualtrics Social Connect でインテグレーションを設定するために完了する必要がある初期設定について説明します。設定を開始するには、最初にクアルトリクスでワークフローを作成する必要があります。

ヒント：Qualtrics Social Connectのヘルプが必要な場合は、Qualtricsソーシャルコネクトアカウントにログインし、プロファイルアイコンをクリックし、［サポートに連絡］を選択してチームに連絡してください。

1. Qualtricsで、 ワークフロー.
2. [ワークフローを作成]、[イベントにより開始] の順にクリックします。
3. 以下を選択します。 JSONイベント.
4. [URL のコピー] をクリックして、イベントエンドポイントをコピーします。このイベントエンドポイントは、Qualtrics Social Connect での設定を完了するために必要です。後でアクセスできるように、どこかに保存します。
5. 新しいブラウザタブで、Qualtrics Social Connect にログインします。
   ヒント：Qualtrics Social Connectは、クアルトリクスアカウントとは別の認証情報を使用します。Qualtrics Social Connect へのアクセスについて質問がある場合は、Social Connect サポートチームに連絡してください。
   
6. ［アカウント設定］に移動します。
7. 概要タブで、自動化レシピを選択します。
8. ケース更新セクションで、自動化レシピ追加をクリックします。
9. 自動化レシピに名前を付けます。
10. トリガセクションでメンションが選択されていることを確認し、ドロップダウンメニューから登録済を選択します。
11. プラス記号（ + ）をクリックして、監視するトピックを1つ以上選択します。
12. フィルタセクションで、監視するメンションのフィルタリングルールを設定します。
13. アクションセクションで、ドロップダウンメニューから Webhook をトリガを選択します。
14. [URL] フィールドに、手順 4 でコピーしたイベントエンドポイントを貼り付けます。
15. 権限ヘッダ項目に、前に作成した権限ヘッダをペーストします。
16. API 呼び出しを使用してタグを取得する場合は、[遅延] オプションを有効にします。タグがメンションに添付される時間があるように、最小遅延を 10 分に設定することをお奨めします。
17. [追加] をクリックして、設定を完了します。

接続をテストするには、新しいメンションを生成します (メンションの生成方法は、新規ツイートの登録やコメントの残留など、ソースによって異なります)。また、次の投稿が自然に発生するのを待つこともできます。新しいメンションが生成されたら、QualtricsワークフローでJSONイベントを開き、そのイベントで取得されたJSONプロパティを確認します。

ステップ 3: Qualtrics データセットの作成

Qualtrics にデータを保存するには、Qualtrics データセットを作成する必要があります。コマンドラインからデータセット API を直接呼び出すことで、Qualtrics データセットを作成できます。

1. テキストエディタを開き、API コマンドを作成します。一般的な形式は以下のとおりです。

   curl -X POST https://brandID.qualtrics.com/API/v3/datasets -H "Content-Type: application/json" -H "X-API-TOKEN: Your Qualtrics API Token" -d '{
   
    "name": "Select a name for your dataset",
   
    "primaryKey": "Choose ID column name",
   
    "createProject": true,
   
    "fields": [
   
    {
   
    "name": "同一 ID 列名"
   
   
   
   
   
   
   
   

2. 上記の API コマンドでは、以下の値を置き換える必要があります。
   • brandID: クアルトリクスの組織ID。
   • Qualtrics APIトークン：APIトークン。
   • データセットの名前を選択: データセットに付ける名前を入力します。
   • ID 列名選択: プロジェクトの ID キーを含む項目名を指定します。「uniqueId」を使用することをお勧めします。
3. コンピュータで Terminal を開き、コマンドを貼り付けます。Enter を押してコマンドを実行します。
4. 結果からデータセット ID をコピーします。これは後で必要になります。API 呼出の結果は以下の書式になります。

   {"result":{"name":"<Name of your dataset> ","primaryKey":"<id field that you defined> ","datasetId":"datasetId":"データセット ID、これはコピーする必要があるものです","fields":[<list of fields that you defined> ]},"meta":{"requestId":"<internal request ID> ","httpStatus":"200 - OK"}}

5. データセットを作成すると、インポートされたデータプロジェクトとしてQualtricsプロジェクトページで使用できるようになります。プロジェクトをクリックして開きます。
6. インポートしたデータプロジェクトを開いた後、Data & Analysis タブでフィールドエディタを使用して、Social Connect からインポートするフィールドを追加できます。利用可能なフィールドの詳細については、「Common Social Connect Fields」を参照してください。項目を追加する場合は、データセットにオープンテキストタイプとして項目を保存することをお奨めします。

ステップ 4: ワークフローの完了

Qualtrics Social Connect との接続が確立され、データセットが作成されました。次に、Qualtrics Social Connect からデータセットにデータをマッピングします。

1. 以前に登録したワークフローを開きます。
2. プラス記号 (+) をクリックし、[タスク] を選択します。
3. 以下を選択します。 Web サービス タスク。
   
4. 認証済 Web サービスを選択します。
   
5. [次へ] をクリックします。
6. [ユーザーアカウントを追加] をクリックします。
7. アカウントに名前を付けます。これは、独自の組織目的で使用されます。
8. 接続タイプとして OAuth を選択します。
9. 付与タイプのクライアント認証情報を選択します。
10. クライアント ID およびクライアントシークレットを入力します。これらの作成方法の詳細については、API OAuth を参照してください。
11. トークンエンドポイントに URL https://BrandID をペーストします。DatacenterID.qualtrics.com/oauth2/token
    • 上の太字のテキストを対応する ID に置き換えます。
    • BrandID：クアルトリクス組織ID。
    • DatacenterID：クアルトリクスデータセンターID。
12. [アカウントの接続] をクリックします。
13. 新たに追加したアカウントを選択します。
14. ［次へ］をクリックします。
15. 要求タイプとして POST を選択します。
16. 以下の書式で URL を入力します。

    https://brandID.qualtrics.com/API/v3/datasets/DatasetID/data

    brandIDはQualtricsブランドID、DatasetIDは以前にコピーしたデータセットIDです。

17. ヘッダセクションで、権限をキーとして追加します。
18. Value には Bearer を入力し、末尾のスペースを追加します。
19. テキストの差し込みアイコン {a} をクリックして、QSCアカウントを選択します。
20. Body セクションで、JSON Key-value ペアを選択し、フィールドのマッピングを開始します。キーには、項目名を入力します。値には、差し込みテキストを使用して、JSON イベントから直接取得されるフィールドを選択します。Common Social Connect Fields セクションには、Social Connect から変換されていないデータ用のテキストの差し込みコードがあります。
21. 終了したら、保存をクリックします。

ステップ 5：Qualtrics Social Connect データの分析

このセクションでは、CXダッシュボードとText iQでQualtrics Social Connectデータを分析する方法について説明します。

CXダッシュボードでのソーシャルコネクトデータの表示

1. CXダッシュボードプロジェクトでダッシュボードを新規作成します。
2. ソースの追加をクリックし、外部データソースにマウスポインタを合わせて、ソーシャル接続データを含むプロジェクトを選択します。
3. インポートした項目の項目データ型を調整します。データセットフィールドごとに提案されるフィールドタイプの詳細については、Common Social Connect フィールドを参照してください。
4. 完了したら、変更を保存します。

ダッシュボードの編集は、CXダッシュボードの編集と同じです。詳細については、以下のサポートページを参照してください。

• CXダッシュボード入門
• ステップ 1: プロジェクト &amp の登録、ダッシュボードの追加
• ステップ 2: ダッシュボードデータソースのマッピング
• ステップ 3：Dashboard Design の計画
• ステップ 4：ダッシュボードの構築
• ステップ 5：ダッシュボードの追加のカスタマイズ
• ステップ 6: ユーザの共有/管理

Text iQの使用

CXダッシュボードでText iQを使用することをお勧めします。これにより、すべてのデータが1つの場所に配置され、Text iQフィールドを分析すると、自動的にダッシュボードにマッピングされます。開始する準備ができたら、ダッシュボードの［Text iQで分析］ボタンをクリックします。

ほとんどのフィールドは、テキスト分析（作成者、ソース、ID など）には役立ちません。Text iQにインポートするデータを選択するときは、［メッセージコンテンツ］フィールドを選択してください。

Text iQをソーシャル接続データに使用する方法は、Qualtricsでアンケートの回答テキストを分析する場合と同じです。詳細については、以下のサポートページを参照してください。

• Text iQ機能
• Text iQのトピック
• 感情分析
• CXダッシュボードのテキストiQ

XM Discover エンリッチメントのインポート

このセクションでは、データセットに XM Discover 拡張をインポートする方法について説明します。Qualtrics Social Connect との統合は必須ではありませんが、XM Discover では、メンションのコンテンツに基づいてメンションにタグを付けることで、メンションをリアルタイムで分析できます。

1. Social Connect で、Tags に移動します。
2. ［XM Discover エンリッチメントを追加］をクリックします。
3. 拡張を追加するトピックを選択します。
4. [次へ] をクリックします。
5. 使用するカテゴリモデルを選択します。
   ヒント：トピックごとに2つのカテゴリに制限があります。これ以外が必要な場合は、Qualtricsソーシャルコネクトアカウントにログインし、プロファイルアイコンをクリックして［サポートに連絡］を選択して、Social Connectチームに連絡してください。
   .
6. [リアルタイムエンリッチメント] の場合は、[はい] を選択します。
   注意：リアルタイムエンリッチメントを有効にしない場合、XM Discover エンリッチメントは Social Connect で作成された後 7 分以上の遅延で処理されるため、対応するタグをクアルトリクスワークフローで利用できなくなります。
7. ［保存］をクリックします。

クアルトリクスのワークフローに戻ります。Qualtricsワークフローのフィールドをマッピングして、XM Discoverのエンリッチメントをクアルトリクスデータセットに保存してください。これらはタグ フィールドとして保存されます。

XM Discoverエンリッチメントはコンマ区切りリストとしてエクスポートされるため、識別値エディターを使用してダッシュボードでフィールド区切り文字を指定する必要があります。区切り文字としてカンマを必ず選択してください。識別値エディタを使用してフィールド名を変更し、ダッシュボードで表示しやすい名前にすることもできます。

共通ソーシャルコネクトフィールド

このセクションには、ソーシャルコネクトで一般的に使用されるフィールド、マッピングを構築するための差し込みテキストコード、クアルトリクスでフィールドタイプを保存する必要があるフィールド、およびフィールドに関する特別な注意事項が含まれています。