クアルトリクス ソーシャルコネクトとの連携

クアルトリクス ソーシャルコネクトとの連携について

クアルトリクスソーシャルコネクトと統合することで、すべてのデジタル顧客フィードバックを一箇所に集約し、分析することができます。その後、CXダッシュボードでテキストiQを含むクアルトリクスの分析方法を使用してデータを分析することができます。

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

このセクションでは、統合のための認可ヘッダーを作成する方法について説明します。クアルトリクス・ソーシャルコネクトとの連携設定に必要です。

1. アカウント設定に進む。
2. アカウントのクアルトリクスIDsセクションに移動し、Apiトークンをコピーします。既にAPIトークンをお持ちの場合は、新たに生成しないでください。
3. クアルトリクスのユーザー名を控えておいてください。通常、クアルトリクスにログインする際に使用するメールアドレスです。クアルトリクスユーザー名がわからない場合は、ブランド管理者に連絡してください。
4. クアルトリクスのユーザー名を使用して、次のフォーマットで認証情報文字列を作成します:
   <あなたのクアルトリクスユーザー名>:<あなたのクアルトリクスAPIトークン>.
   Qtip:SSOを利用してクアルトリクスにログインする場合は、ユーザー名の#を必ず入れてください。

   例クレデンシャル文字列の例を以下に示す：

   barnaby@qualtrics.com:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki

5. クレデンシャル文字列をbase64 エンコードする。このためには、オンライン上のどんなbase64エンコーダーでも使うことができる。

   例私のBase64エンコードされたクレデンシャル文字列は次のとおりです：

   YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=

6. 認可ヘッダーを以下のフォーマットで構築する：Basic <base64 encoded credentials>. Basic “とクレデンシャルの間のスペースに注意。

   例私の最終承認ヘッダーは

   基本的なYmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=。

次へ進むには、この認証クレデンシャルが必要になる。アクセシビリティの高い場所にコピーしてください。

ステップ2：クアルトリクス ソーシャルコネクトでオートメーションを作成する

このセクションでは、クアルトリクス・ソーシャル・コネクトで統合を設定するために必要な初期設定について説明します。セットアップを始めるには、まずクアルトリクスでワークフローを作成する必要があります。

Qtip:クアルトリクス・ソーシャル・コネクトに関するお問い合わせは、クアルトリクス・ソーシャル・コネクトのアカウントにログインし、プロフィールアイコンをクリックして、連絡先サポートを選択してください。

1. クアルトリクスでは、以下のページにアクセスします。 ワークフロー。
2. ワークフローを作成し、イベントによって開始をクリックします。
3. を選択する。 JSONイベント。
4. イベントエンドポイントをコピーするには、[Copy URL]をクリックします。クアルトリクス・ソーシャル・コネクトで設定を完了するには、このイベント・エンドポイントが必要です。後でアクセスできる場所に保存してください。
5. 新しいブラウザのタブで、クアルトリクス・ソーシャル・コネクトにログインします。
   QTip:クアルトリクス・ソーシャル・コネクトは、クアルトリクスアカウントとは別の認証情報を使用します。クアルトリクス・ソーシャルコネクトへのアクセスについてご不明な点がございましたら、ソーシャルコネクトサポートチームまでご連絡ください。
   
6. アカウント設定に進む。
7. Overview］タブで［Automation Recipes］を選択する。
8. On Case Update] セクションで、[Add Automation Recipe] をクリックします。
9. 自動化レシピに名前をつける。
10. トリガーセクションで「メンション」が選択されていることを確認し、ドロップダウンメニューから「作成済み」を選択します。
11. プラス記号 (+) をクリックして、監視するトピックを 1 つ以上選択します。
12. フィルタセクションで、監視するメンションのフィルタリングルールを設定します。
13. アクション]セクションで、ドロップダウンメニューから[トリガーウェブフック]を選択します。
14. URLフィールドに、ステップ4でコピーしたイベントエンドポイントを貼り付けます。
15. Authorization Headerフィールドに、先ほど作成した認証ヘッダーを貼り付ける。
16. タグの取得にAPIコールを使用している場合は、Delayオプションを有効にしてください。タグがメンションに付けられる時間を確保するため、最低10分のディレイを設定することを推奨する。
17. Addをクリックしてセットアップを完了します。

接続をテストするには、新しい言及を生成する（言及を生成する方法は、新しいツイートを作成したり、コメントを残すなど、ソースによって異なります）。あるいは、それが自然に起こる次への投稿を待つこともできる。新しいメンションが生成されたら、クアルトリクスワークフローでJSONイベントを開き、イベントでキャプチャされたJSONプロパティを見てください：

ステップ3：クアルトリクスデータセットの作成

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

1. テキストエディタを開き、apiコマンドを作成する。一般的なフォーマットは以下の通り：

   curl -X POSThttps://brandID.qualtrics.com/API/v3/datasets-H "Content-Type: application/json" -H "X-API-TOKEN:Your Qualtrics API Token" -d '{
   
   "name"："Choose a name for your dataset",
   
   "primaryKey"："Choose ID column name",
   
   "createProject": true,
   
   "fields"：[
   
   {
   
   "name":"上記と同じIDカラム名",
   
   "type": "string"
   
   }
   
   ]
   
   }'.

2. 上記のAPIコマンドでは、以下の値を置き換える必要がある：
   • brandID: クアルトリクスの組織ID。
   • クアルトリクスのAPIトークンです：あなたのAPIトークン。
   • データセットの名前を選んでください．データセットにつける名前を入力してください．
   • IDカラム名を選択：プロジェクトの識別キーを格納するフィールド名を指定します。uniqueId “の使用を推奨する。
3. コンピューターでターミナルを開き、コマンドを貼り付ける。Enterキーを押してコマンドを実行する。
4. 結果からデータセットIDをコピーする．これは後で必要になる。APIコールの結果は以下の形式になる：

   {"result":{"name":"<Name of your dataset>", "primaryKey":"<id field that you defined>", "datasetId":"dataset ID, this is what you need to copy", "fields":[<list of fields that you defined>]}, "meta":{"requestId":"<internal request ID>", "httpStatus": "200 - OK" }}。

5. データセットを作成すると、インポートされたデータプロジェクトとしてクアルトリクスプロジェクトページで利用できるようになります。プロジェクトをクリックして開きます。
6. インポートされたデータプロジェクトを開いたら、Data & Analysis タブのフィールドエディターを使ってSocial Connectからインポートしたいフィールドを追加します。利用可能なフィールドの詳細については、ソーシャルコネクトの共通フィールドを参照してください。フィールドタイプを追加する際は、データセットにオープンテキストタイプとして保存することをお勧めします。

ステップ4：ワークフローの完成

クアルトリクス・ソーシャルコネクトとの接続を確立し、データセットを作成したら、いよいよクアルトリクス・ソーシャルコネクトからデータセットにデータをマッピングします。

1. 先ほど作成したワークフローを開きます。
2. プラス記号（+）をクリックし、タスクを選択します。
3. を選択する。 ウェブサービス タスク.
   
4. 自分らしくいられること（Authenticated web service）」を選択します。
   
5. ［次へ］をクリックします。
6. ユーザーアカウントの追加をクリックします。
7. アカウントに名前を付けます。これはあなた自身の整理のためです。
8. 接続タイプにOAuthを選択します。
9. グラントタイプでクライアント認証情報を選択します。
10. クライアント IDとクライアントシークレットを入力します。これらの作成方法の詳細については、API OAuthを参照してください。
11. 次の URL をToken エンドポイントに貼り付けます: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はクアルトリクスのブランドID、DatasetIDは先ほどコピーしたデータセットIDです。

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

ステップ5：クアルトリクスソーシャルコネクトデータの分析

ここでは、クアルトリクスのソーシャルコネクトデータをCxダッシュボードやText iQで分析する方法について説明します。

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

1. Cxダッシュボードプロジェクトに新しいダッシュボードを作成します。
2. ソースの追加]をクリックし、[外部データソース]にカーソルを合わせ、ソーシャルコネクトデータを含むプロジェクトを選択します。
3. インポートしたフィールドのフィールドタイプを調整します。各データセットフィールドの推奨フィールドタイプの詳細については、一般的なソーシャルコネクトフィールドを参照してください。
4. 完了したら変更を保存します。

ダッシュボードの編集は、他のCxダッシュボードの編集と同じです。詳細を見るには、以下のサポートページをご覧ください：

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

TEXT iQの使い方

CxダッシュボードでTEXT iQを使用することをお勧めします。こうすることで、すべてのデータが1つの場所に集まり、ダッシュボードで分析すれば、TEXT iqフィールドは自動的にダッシュボードにマッピングされます。準備ができたら、ダッシュボードの「Text iQで分析 」ボタンをクリックします。

ほとんどの言及フィールドはテキスト分析には役に立たないだろう（例：著者、ソース、idなど）。Text iQにインポートするデータを選択する際は、必ずメッセージコンテンツフィールドを選択してください。

ソーシャルコネクトデータにText iQを使用すると、クアルトリクスでアンケート調査の回答テキストを分析するのと同じように機能します。詳細を見るには、以下のサポートページをご覧ください：

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

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

このセクションでは、XM Discoverエンリッチメントをデータセットにインポートする方法について説明します。クアルトリクスソーシャルコネクトとの統合は必須ではありませんが、XM Discoverエンリッチメントは、メンションの内容に基づいてタグ付けすることで、メンションをリアルタイムで分析するのに役立ちます。

1. ソーシャル・コネクトの「タグ」をクリック。
2. Add XM Discover Enrichment］をクリックします。
3. エンリッチメントを追加したいトピックを選択します。
4. ［次へ］をクリックします。
5. ご希望のカテゴリーモデルをお選びください。
   Qtip:1つのトピックにつき、2つのカテゴリーに制限されています。それ以上必要な場合は、クアルトリクス ソーシャルコネクトアカウントにログインし、プロフィールアイコンをクリックし、連絡先サポートを選択してソーシャルコネクトチームにご連絡ください。
   。
6. リアルタイム・エンリッチメント（Real-time Enrichment）」の場合は、「はい（Yes）」を選択する。
   注意リアルタイムエンリッチメントを有効にしない場合、XM DiscoverエンリッチメントはSocial Connectで言及が作成されてから7分以上遅れて処理されるため、対応するタグはクアルトリクスワークフローで利用できません。
7. ［保存］をクリックします。

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

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

一般的なソーシャル・コネクト・フィールド

このセクションには、Social Connectでよく使用されるフィールドの表、マッピングを作成するためのテキストの差し込みコード、クアルトリクスで保存するフィールドタイプ、フィールドに関する特別な注意事項が記載されています。