Qualtrics Platform
Customer Journey Optimizer
XM Discover
Qualtrics Social Connect

記事テンプレート

クアルトリクスアウトバウンドコネクターについて

クアルトリクスアウトバウンドコネクターを使用すると、クアルトリクスアカウントで以下のアクションを実行できます：

JSONワークフローイベントをトリガーし、クアルトリクスワークフローでXM Discoverデータを使用します。
XM Discover から DISCOVER エンリッチメントを含む回答をエクスポートし、クアルトリクスのアンケート調査データセットにインポートします。

要件

接続設定の前に、クアルトリクスアカウントから以下の情報が必要です：

クアルトリクスのデータセンターIDです。
クアルトリクスのAPIトークンです。
XM Discover Export API エンドポイント。

JSONイベント・ジョブズ

クアルトリクスアウトバウンドコネクターでJSONイベントをトリガーするには、JSONイベントのエンドポイントが必要です。クアルトリクスのワークフローでJSONイベントを編集する際に「Copy URL」をクリックすると、エンドポイントをコピーできます。

回答エクスポートの仕事

クアルトリクスのアンケートデータセットに回答をエクスポートする場合は、データが次の要件を満たしていることを確認する必要があります：

アンケート調査データセットには、エクスポートする XM DISCOVER エンリッチメントに対応するフィールドが必要です。これらのフィールドが存在しない場合は、埋め込みデータとして追加するか、カスタムフィールドを使用して作成することができます。
XM Discover からエクスポートするドキュメントには、回答をインポートするアンケートのアンケート IDに対応するフィールドが必要です。

クアルトリクスアウトバウンドコネクタジョブの作成

Qtip:ジョブを作成するには “マネージャー “権限が必要です。

求人情報ページで、新規求人をクリックします。
クアルトリクスアウトバウンドコネクタを選択します。
自分の仕事に名前をつけて、ITと識別できるようにする。
データをロードするプロジェクトを選択します。
自分の仕事を説明し、その目的がわかるようにする。
［次へ］をクリックします。
エクスポートするクアルトリクスのデータタイプを選択します：
- アンケート調査：回答データをエクスポートしてアンケート調査データセットにインポートします。
- JSONイベント：JSONワークフローイベントをトリガーするデータをエクスポートします。
［次へ］をクリックします。
ドロップダウンを使用して既存のクアルトリクス接続を選択するか、[新規追加] を選択して新規接続を作成します。

Qtip:既存の接続を編集または削除するには、アカウント設定にアクセスしてください。
新しい接続を追加する場合は、以下のように入力する：
- 接続名：後で接続を識別できるように、接続に名前を付けます。
- クアルトリクスデータセンターID：クアルトリクスのデータセンターIDを入力してください。
- クアルトリクスAPIトークン：クアルトリクスアカウントのAPIトークンを入力します。
一定期間後に接続を失効させたい場合は、Send Expiration Notifications オプションを有効にします。有効期限フィールドを使用して、クレデンシャルの有効期限を選択します。Days prior expiration（期限切れ前の日数）］ボックスには、接続の期限切れを通知する期間を100日先まで入力します。
［次へ］をクリックします。
XM Discover Export APIエンドポイントを指定します。
［次へ］をクリックします。
エクスポートするデータのレベルを選択します：
- 文章：文レベルのデータを使用する。
- 文書：文書レベルのデータを使用する。
  Qtip:Query Configurationページの残りのステップはオプションで、エクスポートされるデータを絞り込むのに役立ちます。
送信データをフィルターする検索クエリを指定する。Designer でデータを検索するときに使用する構文と同じ構文を使用します。すべてのデータを含めるには、このフィールドを空にします。
例次の構文を使用して、1 つまたは複数のアンケート ID を指定し、選択したアンケートレコードのみを更新することができます。
送信データに適用するプロジェクトのフィルター名を入力します。データにフィルタをかけたくない場合は、このフィールドを空白のままにしてください。
インポートするレコードを選択します：
- 新しいレコードをロードする：前回アウトバウンドジョブが実行されてから作成されたレコード。
- 新規および更新されたレコードをロードする：前回アウトバウンドジョブが実行されてから作成または更新されたレコード。
- 更新されたレコードをロードする：前回アウトバウンドジョブが実行された後に更新されたレコード。
ドロップダウンメニューを使用して、データに含める分類モデルを選択します。プロジェクトで利用可能なすべてのモデルの分類データを含めるには、All Modelsチェックボックスを選択します。
分類がデータのフィルタリングにどのように影響するかを選択します：
- 無視する：選択したモデルに基づくフィルターは適用されない。
- 現在分類済み：最新の分類実行時に、選択したモデルによって分類されたレコードを返します。
- Ever Classified：選択したモデルで分類されたことのあるレコードを返します。
使用したい追加エクスポートオプションを選択します：
- カテゴリー名（false）の代わりにカテゴリーID（true）を返すかどうか：カテゴリー名の代わりにカテゴリーIDをエクスポートする
- すべてのリーフ・ノードのパスでフィルタ・クエリを適用して結果をフィルタします：leaf_onlyフラグ」パラメータを持つ複数のモデルをExport API呼び出しに追加します。
- 空の値を無視する空の値を無視する：送信値がすべて空の場合、アンケート調査の更新をスキップします。
［次へ］をクリックします。
次へのステップは、アンケートデータをエクスポートするか、ワークフローをトリガーするために JSON エンドポイントにデータを送信するかによって異なります：
- アンケート調査：データをエクスポートするアンケートを選択し、次へをクリックします。
  
  次に、クアルトリクスアンケート ID を含む XM Discover 属性を選択します。
  
  Qtip:前のステップで選択したアンケート調査と一致するアンケートIDを持つドキュメントのみが更新されます。
- JSONイベント：JSONイベントのJSONエンドポイントを入力します。
XM Discoverからクアルトリクスにフィールドをマッピングします。空のボックスをクリックし、クアルトリクスに送信するXM Discover属性を選択します。
クアルトリクスにおけるフィールドの埋め込みデータ変数タイプに対応する、フィールドをエクスポートするデータタイプを選択します：
- マッピングしない：変数タイプ指定なし。
- Number属性：変数タイプ： Number。
- テキスト属性：テキストセット変数タイプ。
- 日付属性：日付変数タイプ。
- バーベイタム：テキスト変数タイプ。
選択したXM Discover属性の値を入力するクアルトリクスからの埋め込みフィールド名を入力します。
必要に応じて、プラス（＋）とマイナス（-）の記号を使ってフィールドを追加したり削除したりします。
［次へ］をクリックします。
必要であれば、コネクタ・フィルタを追加して受信データをフィルタリングし、インポートするデータを制限できます。
また、Specify Record Limitボックスに数値を入力することで、1回のジョブでインポートするレコード数を制限することもできます。すべてのレコードをインポートする場合は「All」を入力してください。
Qtip:会話データの場合、制限は行ではなく会話に基づいて適用されます。
［次へ］をクリックします。
通知を希望するタイミングを選択してください。詳しくは求人通知をご覧ください。
［次へ］をクリックします。
ジョブが実行されるタイミングを選択します。1回限りのプルでも、定期的なプルの設定でも構いません。詳細はジョブ・スケジューリングを参照。
［次へ］をクリックします。
セットアップを評価する。特定の設定を変更する必要がある場合は、[Edit]ボタンをクリックして、コネクタ設定のそのステップに移動します。
Finishをクリックしてジョブを保存する。