Qualtrics Platform
Customer Journey Optimizer
XM Discover
Qualtrics Social Connect

クアルトリクス送信コネクター

クアルトリクス送信コネクターについて

Qualtrics 送信コネクタを使用すると、Qualtrics アカウントで以下のアクションを実行できます。

JSONワークフローイベントをトリガーし、クアルトリクスワークフローでXM Discoverデータを使用します。
XM DiscoverからXM Discover拡張を使用して回答をエクスポートし、クアルトリクスアンケートデータセットにインポートします。

要件

接続を設定する前に、Qualtrics アカウントから以下の情報が必要です。

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

JSONイベントジョブ

Qualtrics Outbound Connector で JSON イベントをトリガするには、JSON イベントのエンドポイントが必要です。Qualtrics ワークフローで JSON イベントを編集する際に、URL をコピーをクリックしてエンドポイントをコピーすることができます。

回答をエクスポートするジョブ

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

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

Qualtrics 送信コネクタジョブの作成

ヒント：ジョブの作成を使用するには、「ジョブの管理」権限が必要です。

[ジョブ] ページで、[新規ジョブ] をクリックします。
Qualtrics Outbound コネクタを選択します。
ジョブを特定できるように、ジョブに名前を付けます。
データをロードするプロジェクトを選択します。
目的がわかるように、ジョブに説明を付けます。
[次へ] をクリックします。
エクスポートするクアルトリクスデータタイプを選択：
- アンケート：回答データをエクスポートして、アンケートデータセットにインポートします。
- JSON イベント: データをエクスポートして JSON ワークフローイベントをトリガします。
[次へ] をクリックします。
ドロップダウンを使用して既存の Qualtrics 接続を選択するか、新規追加を選択して新しい接続を作成します。

ヒント：既存の接続を編集または削除するには、アカウント設定に移動します。
新しい接続を追加する場合は、以下を指定します。
- 接続名: 後で識別できるように、接続の名前を指定します。
- クアルトリクスデータセンターID：クアルトリクスデータセンターIDを入力します。
- Qualtrics APIトークン：クアルトリクスアカウントのAPIトークンを入力します。
一定期間後に接続の有効期限が切れるようにするには、Send Expiration Notifications オプションを有効にします。[有効期限] フィールドを使用して、認証情報の有効期限が切れる日付を選択します。[有効期限までの日数] ボックスに、接続の有効期限をどの程度前に通知するのかを入力します (最大 100 日)。
[次へ] をクリックします。
XM DiscoverのエクスポートAPIエンドポイントを指定します。
[次へ] をクリックします。
エクスポートするデータのレベルを選択します。
- 文: 文レベルのデータを使用します。
- ドキュメント: ドキュメントレベルのデータを使用します。
  ヒント：［照会構成］ページの残りの手順は任意であり、エクスポートされるデータを絞り込むのに役立ちます。
検索クエリを指定して、送信データをフィルタリングします。Designer でデータを検索する場合と同じ構文を使用します。すべてのデータを含めるには、このフィールドを空白のままにします。
例: 次の構文を使用して、選択した調査レコードのみを更新する調査 ID を 1 つ以上指定できます: surveyid:sv_01
送信データに適用するプロジェクトからのフィルタの名称を入力します。データをフィルタリングしない場合は、この項目を空白のままにします。
インポートするレコードを選択します。
- 新規レコードのロード: 送信ジョブが最後に実行されてから登録されたレコード。
- 新規レコードおよび更新済レコードのロード: 送信ジョブの最終実行時以降に作成または更新されたレコード。
- 更新されたレコードのロード: 送信ジョブが最後に実行された後に更新されたレコード。
ドロップダウンメニューを使用して、データに含める分類モデルを選択します。プロジェクトで利用可能なすべてのモデルの分類データを含めるには、すべてのモデルチェックボックスを選択します。
分類によるデータフィルタリングへの影響を選択します。
- 無視: 選択したモデルに基づくフィルタリングは適用されません。
- 現在分類済: 最新の分類実行中に選択されたモデルによって分類されたレコードを返します。
- 分類済: 任意の時点で選択したモデルによって分類されたレコードを返します。
使用する追加のエクスポートオプションを選択します。
- カテゴリ名の代わりにカテゴリ ID (true) を返すかどうか (false): カテゴリ名の代わりにカテゴリ ID をエクスポートします。
- すべてのリーフノードパスを含むフィルタクエリを適用して結果をフィルタリングします。エクスポート API 呼び出しに “leaf_only” パラメータを使用して複数のモデルを追加します。
- 空の値を無視: 調査ドキュメントのすべての送信値が空の場合、調査ドキュメントの更新をスキップします。
[次へ] をクリックします。
次のステップは、アンケートデータをエクスポートするか、JSONエンドポイントにデータを送信してワークフローをトリガーするかによって異なります。
- アンケート：データのエクスポート先となるアンケートを選択し、［次へ］をクリックします。
  
  次に、QualtricsアンケートIDを含むXM Discover属性を選択します。
  
  ヒント：前のステップで選択した調査に一致する調査 ID のドキュメントのみが更新されます。
- JSON イベント: JSON イベントからの JSON エンドポイントを入力します。
XM Discoverのフィールドをクアルトリクスにマッピングします。空のボックスをクリックし、クアルトリクスに送信するXM Discover属性を選択します。
フィールドのエクスポートに使用するデータ型を選択します。これは、クアルトリクスのフィールドの埋め込みデータ変数タイプに対応します。
- マッピングしない: 変数タイプが指定されていません。
- 数値属性: 数値変数タイプ。
- テキスト属性: テキストセット変数タイプ。
- 日付属性: 日付変数タイプ。
- バーベイタム: テキスト変数タイプ。
選択したXM Discover属性の値が入力される必要があるクアルトリクスの埋め込みフィールドの名前を入力します。
必要に応じて項目を追加および削除するには、プラス ( + ) 符号とマイナス ( – ) 符号を使用します。
[次へ] をクリックします。
必要に応じて、受信データをフィルタリングするコネクタフィルタを追加して、インポートされるデータを制限することができます。
また、レコード制限の指定ボックスで数を入力して、1 つのジョブでインポートされるレコードの数を制限することもできます。すべてのレコードをインポートする場合は、”すべて” を入力します。
ヒント：会話データの場合、上限は行ではなく会話に基づいて適用されます。
[次へ] をクリックします。
通知を受け取るタイミングを選択します。詳細については、ジョブ通知を参照してください。
[次へ] をクリックします。
ジョブがいつ実行されるかを選択します。1 回限りのプルを実行することも、定期的なデータインポートを設定することもできます。詳細については、ジョブスケジュールを参照してください。
[次へ] をクリックします。
設定をレビューします。特定の設定を変更する必要がある場合は、編集ボタンをクリックして、コネクタ設定のそのステップに移動します。
[完了] をクリックしてジョブを保存します。