Qualtrics Social Connectインバウンドコネクター

Qualtrics Social Connectインバウンドコネクターについて

Qualtrics Social Connectインバウンドコネクターを使用して、Qualtrics Social ConnectアカウントからXM Discoverにデジタルチャネルデータをロードできます。

Qualtrics Social ConnectからXM Discoverにデータをアップロード

開始する前に

Qualtrics Social Connect インバウンドコネクターを使用してジョブを設定する前に、Qualtrics Social Connect アカウントの認証情報があることを確認してください。

接続の設定

1. コネクタにサインインします。
2. [ジョブ] ページの右上隅にある [新しいジョブ] ボタンをクリックします。
   
3. コネクタページで、ソースを選択セクションに移動します。
   
4. ［クアルトリクスソーシャル接続］ボタンをクリックします。
   

Qualtrics Social Connect 受信コネクタージョブの作成

接続を設定したら、以下のステップに従って Qualtrics Social Connectインバウンドコネクタージョブを作成し、XM Discoverに送信されるデータを設定します。

• ステップ 1: ジョブ名の入力
• ステップ 2: プロジェクトと説明の指定
• ステップ3：Qualtrics Social Connectアカウントを接続
• ステップ 4: データ型とトピックを選択
• ステップ 5: クエリ設定 (オプション)
• ステップ6：XM Discoverへの目的のフィールドのマッピング
• ステップ 7: データ代替および編集 (オプション)
• ステップ 8: フィルタ指定 (オプション) およびレコード制限
• ステップ 9: 通知設定 (オプション)
• ステップ 10: ジョブの追加オプションの設定
• ステップ 11: すべてのジョブ設定の確認

ヒント：［戻る］ボタンと［次へ］ボタンをクリックしてページ間を移動するか、矢印キーを使用します：戻るにはLEFT、次に進むには右ボタンを使用します。設定をキャンセルする場合は、［キャンセル］ボタンをクリックします。

ステップ 1: ジョブ名の入力

ページの左上の
[ジョブ名] ボックスに、認識可能なジョブ名を入力します。

ステップ 2: プロジェクトと説明の指定

1. [プロジェクトおよび説明の指定] ページで、プロジェクトのプルダウンリストからデータのロード先となるプロジェクトを選択します。
   
   ヒント: [職務概要] ボックスにジョブに関するメモを入力するオプションがあります。ジョブ記述書ボックスに入力したジョブ記述書は、コネクタ一覧でのみアクセス可能であり、ジョブデータの一部としてはアップロードされません。
   
2. [次へ] をクリックします。

ステップ3：Qualtrics Social Connectアカウントを接続

1. ［クアルトリクスソーシャル接続アカウントを接続］ページでは、ドロップダウンメニューから既存の認証情報セットを選択できます。
   
   ヒント：新しい認証情報セットを追加できます。新しい認証情報については、を参照してください。 新しい認証情報の追加 」セクションで説明されている手順を使用して差し込むことができます。
   ヒント：既存の認証情報のセットを選択してQualtrics Social ConnectアカウントをXM Discoverに接続するときに認証コードが期限切れになる場合は、［再認証］ボタンをクリックして新しいコードを発行します。
2. [次へ] をクリックします。

ステップ 4: データ型とトピックを選択

1. [データタイプとトピックの選択] ページで、アップロードするデータの種類を選択します。使用可能なオプションは以下のとおりです。

• 文書としての個別メンションの処理：個別のメンションを個別の文書として処理します。
• 会話として解決済みケースを処理する：ケース全体を会話用ドキュメントとして処理する。
  
  ヒント：これは解決済みのケースにのみ有効です（進行中のケースはアップロードされません）。

2. アップロードに使用するプロジェクトおよびトピックを選択します。
   
   ヒント：プロジェクトの名前を展開すると、利用可能なすべてのトピック、その検索定義、監視対象のプロファイルが表示されます。
3. [次へ] をクリックします。
   ヒント：トピックはジョブの作成後に更新できます。

ステップ 5: クエリ設定 (オプション)

1. ［照会設定］ページでは、Qualtrics Social Connect で作成したフィルタをメニューから選択して、検索クエリーをさらに絞り込むことができます。
   
2. [次へ] をクリックします。

ステップ6：XM Discoverへの目的のフィールドのマッピング

1. XM Discoverに目的のフィールドをマッピングページで、［ソースマッピング］タブを選択し、ソースデータフィールドをXM Discoverプロジェクトのデータフィールドに接続します。
   
2. デフォルトのソースマッピングセクションで、XM Discoverのすべての文書が共有するデフォルトのデータフィールドを設定します。デフォルトソースマッピングの詳細については、を参照してください。 デフォルトソースマッピング 」セクションで説明されている手順を使用して差し込むことができます。
3. ソースマッピングセクションで、ファイルからの追加データフィールドを設定します。対話型データフィールドの詳細については、「」を参照してください。 会話型データフィールド 」セクションで説明されている手順を使用して差し込むことができます。
   
   ヒント：データマッピングの詳細については、「データマッピングの設定」を参照してください。
4. [次へ] をクリックします。

ステップ 7: データ代入および編集 (オプション)

1. データ置換およびレッドアクションページでは、カスタマフィードバックおよびインタラクションで、機密データを非表示にしたり、特定の単語およびフレーズを自動的に置換したりするための代替ルールと編集ルールを指定することができます。
   
   ヒント：データの置換と編集の詳細については、「データの差し替えと削減」を参照してください。
2. [次へ] をクリックします。

ステップ 8: フィルタの指定 (オプション) およびレコード制限

1. [フィルタの指定] ページでは、ジョブに対するフィルタ条件を定義して、それを満たすレコードのみをロードすることができます (オプション)。
   
   ヒント：フィルターの適用の詳細については、「コネクターフィルター」を参照してください。
2. [レコード制限の指定]ボックスでレコード制限を指定できます。また、すべてのレコードを 1 回のプッシュで返す場合は、レコード制限をデフォルトのすべてのままにしておくこともできます。
   
   ヒント：レコード制限は、ジョブの実行ごとの制限です。1,000 に設定すると、ジョブは設定した任意のスケジュールで実行され、1,000 件のレコードを取得した後に停止します。日次に設定すると、1 日に 1 回実行され、1 日あたり最大 1,000 件のレコードが取得されます。
   ヒント：会話データの場合、上限は行ではなく会話に基づいて適用されます。
3. [次へ] をクリックします。

ステップ 9: 通知設定 (オプション)

1. [通知設定] ページでは、以下に一覧表示されたイベントのいずれかが発生した場合に、ジョブの参照者が受信する通知を選択することができます。
   • ゼロレコードがプロジェクトにロードされたときに通知
   • 連続する欠落値が見つかった場合に通知
   • ジョブ実行失敗時に通知
   • ジョブ実行が部分的に成功した場合に通知
   • ジョブがタイムアウトで終了した場合に通知
   • このジョブが失敗した場合、サポートに通知する
     

2. [次へ] をクリックします。

ステップ 10: ジョブの追加オプションの設定

1. [ジョブの追加オプションの設定] ページの [新規および既存のドキュメントの処理中] セクションで、[新規および既存のドキュメントを処理する] セクションで以下のチェックボックスの 1 つを選択して、重複するドキュメントの処理方法を選択します。

• • 既存の伝票の重複を却下し、新規伝票の新規レコードを登録する
  • 既存文書の構造化属性の更新および新規文書の新規レコードの登録
  • 既存の文書の構造化属性を更新し、新規文書のレコードを登録しない
    

2. ジョブの追加オプションの設定ページの履歴/増分ジョブのスケジュールセクションで、以下のオプションの 1 つを選択します。

• 差分データインポートのスケジュールを設定するには、[差分実行スケジュール] を選択します。
  ヒント：追加実行のスケジュールの詳細については、「ジョブスケジュール」を参照してください。
• ワンタイムプルを設定して、ワンタイムデータインポートを実行します。

3. [次へ] をクリックします。

ステップ 11: すべてのジョブ設定の確認

1. すべてのジョブ設定の確認ページでは、データアップロードを実行する前に、ジョブのすべての設定の概要を表示し、必要に応じて設定を編集することができます。
   
2. データアップロードを実行するには、データアップロードを実行する準備ができたら、終了ボタンをクリックします。ジョブが正常に送信されたことを確認する確認メッセージが表示されます。

終了をクリックすると、1 回限りのプルが即時に実行されます。[ジョブを作成するがデータを取得しない] オプションを有効にしていない場合、スケジュールされたプルはすぐに実行されてから、定義したスケジュールに従って実行されるように設定されます。ジョブの監視

の詳細については、ジョブページ概要を参照してください。

新しい認証情報の追加

1. 新しい一連の認証情報を追加するには、認証情報ドロップダウンメニューから新規追加を選択します。
   
2. 新しい認証情報セットの名前を CONNECTION NAME ボックスに入力します。
3. 接続する環境を Qualtrics SOCIAL CONNECT ENVIRONMENT ドロップダウンメニューから選択します。利用可能な環境オプションは以下のとおりです。

• アプリ：EMEA（app.engagor.com）
• us: US (us.engagor.com)

4. 適切なアカウントを使用して Qualtrics Social Connect にログインしていることを確認し、［認証］をクリックします。
   
   
5. 共有される情報をレビューし、アプリ認証をクリックします。
   
6. 特定の期間が経過すると認証情報が期限切れになるように設定できます (オプション)。この認証情報セットの有効期限を定義し、すべてのジョブ参照者にリマインダを設定するには、[有効期限に関する通知を送信する] を選択します。これにより、[有効期限までの日数] ボックスが有効になります。
   
7. [有効期限前の日数] ボックスに値を入力して、通知が有効期限切れになるまでの日数を設定します。使用可能な値は 1 日から 100 日です。
   ヒント：このリマインダーは、有効期限が［有効期限までの日数］ボックスで設定された日数未満になると、ジョブが実行されるたびにトリガーされます。
8. カレンダ日付ピッカーから有効期限を選択します。その後、有効期限が [有効期限] ボックスに追加されます。

デフォルトソースマッピング

以下は、Qualtrics Social Connect 受信コネクタのデフォルトデータフィールドです。

1. natural_id はドキュメントの一意の識別子として機能し、重複するドキュメントを適切に処理することができます。自然IDの場合、XM Discoverはカスタム変換を介してコネクタ名の接頭辞が付いたソース ID を使用します。Natural ID = Connector-name;Source-ID
   
2. document_date は、ドキュメントに関連付けられている主要な日付フィールドです。この日付は、XM Discoverのレポート、トレンド、アラートなどで使用されます。伝票日付で、以下のいずれかのオプションを選択します。

• date.added (デフォルト): 投稿が Qualtrics Social Connect によってインデックス処理されたときの UNIX タイムスタンプ (UTC)。
• date.published: 投稿が公開された UNIX タイムスタンプ (UTC)。
  
• ソースデータに他の日付項目が含まれている場合は、項目名列で日付項目を選択することで、そのうち 1 つを伝票日付として設定することができます。
  ヒント：カスタムフィールドを追加して特定の日付を設定することもできます。詳細については、特定の伝票日付の設定を参照してください。

3. feedback-provider は、特定のプロバイダから取得したデータを識別するのに役立ちます。Qualtrics Social Connectの文書では、この属性の値はQualtrics Social Connectに設定されます。
4. source を使用すると、特定のソースから取得したデータを識別できます。これは、サーベイやモバイルマーケティングキャンペーンの名称など、データの発生源を示すあらゆるものにできます。デフォルトでは、この属性の値はQualtrics Social Connectに設定されていますが、［ハードコーディングされた値］列に独自の値を指定できます。
5. feedack_type は、データ型に基づいてデータを識別するのに役立ちます。これは、プロジェクトにさまざまなタイプのデータ（アンケートやソーシャルメディアフィードバックなど）が含まれる場合にレポートに役立ちます。Qualtrics Social Connectドキュメントの場合、この属性の値は［ソーシャル］に設定されます。
6. job_name は、アップロードに使用されたジョブの名前に基づいてデータを識別するのに役立ちます。設定時に各ページの上部に表示されるジョブ名フィールドを使用して、この属性の値を変更することができます。
7. loadDateは、ドキュメントがXM Discoverにアップロードされた日付を示します。この項目は自動的に設定されます。

会話型データフィールド

ソースマッピングセクションでは、以下の対話型データフィールドを設定できます。

1. richVerbatim：会話データ（通話やチャットインタラクションなど）の場合、XM Discover では、richVerbatim フィールドに会話形式の言葉を使用します。この形式では、会話ビジュアライゼーションのロックを解除するために必要なダイアログ固有のメタデータ (講演者回転、沈黙、会話イベントなど) および拡張 (開始時刻、期間など) がサポートされます。この完全一致フィールドには、クライアント側と代表者の会話側を追跡するための「子」フィールドが含まれます。

• clientVerbatim は、クライアントの会話側を追跡します。
• agentVerbatim は、会話の担当者 (エージェント) 側を追跡します。
• unknown は、会話の未知の側を追跡します。
  
  ヒント：会話形式のフィールドでは変換がサポートされていません。
  ヒント：異なるタイプの会話データに同じ言葉を使用することはできません。プロジェクトで複数のタイプの会話がホストされるようにする場合は、会話タイプごとに別々の会話言語ペアを使用します。

2. clientVerbatim (対話データ用): クライアント側の対話をコールおよびチャットインタラクションで追跡します。デフォルトでは、このフィールドは以下にマッピングされます。

• clientVerbatimChat (デジタルインタラクションの場合)
• clientVerbatimCall (コールインタラクションの場合)。
  ヒント：必要に応じて、このフィールドを別の単語型フィールドにマッピングできます。

3. agentVerbatim (対話データ用): コールおよびチャットインタラクションで担当者の会話側を追跡します。デフォルトでは、このフィールドは以下にマッピングされます。

• agentVerbatimChat (デジタルインタラクションの場合)
• コールインタラクションの agentVerbatimCall。
  ヒント：必要に応じて、このフィールドを別の単語型フィールドにマッピングできます。

4. 不明 (対話データ用): コールおよびチャットインタラクションで会話の不明な側を追跡します。デフォルトでは、このフィールドは以下にマッピングされます。

• デジタルインタラクションのための UnknownVerbatimChat
• コールインタラクションの unknownVerbatimCall。
  ヒント：必要に応じて、このフィールドを別の単語型フィールドにマッピングできます。

Qualtrics Social Connect の求人に関するトピックの更新

Qualtrics Social Connectジョブのトピック（ストリームとも呼ばれます）を更新して、ストリームを追加または削除し、XM Discoverにデータを取り込むことができます。

1. コネクタにサインインします。
2. JOBS タブが開いていることを確認します。
   
3. 更新するジョブを見つけます。
4. ジョブの横にあるアクションメニューを展開します。
5. ［トピックを更新］を選択します。
6. 開いた [トピックの更新] ウィンドウで、アップロードするデータの種類を選択します。
   • 文書としての個別メンションの処理：個別のメンションを個別の文書として処理します。
   • 会話として解決済みケースを処理する：ケース全体を会話用ドキュメントとして処理する。
     
     ヒント：解決されたケースのみが処理されます。進行中のケースはアップロードされません。
7. アップロードに使用するプロジェクトおよびトピックを選択します。
   
   ヒント：プロジェクトの名前を展開すると、利用可能なすべてのトピック、その検索定義、監視対象のプロファイルが表示されます。
8. OK をクリックします。