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

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

Qualtrics 送信コネクタを使用して、以下のタスクを実行することができます。

• XM Discoverの拡張で既存のクアルトリクスアンケートを更新します。
• XM DiscoverのエクスポートデータをJSONイベント経由でクアルトリクスに送信して、クアルトリクスワークフローをトリガします。

追加のガイダンスが必要な場合は、クアルトリクスアカウントチームにお問い合わせください。

開始前

前提条件

Qualtrics 送信コネクタを使用してジョブを設定する前に、以下の条件が満たされていることを確認してください。

• XM Discoverのエンリッチメントのデータフィールドは、クアルトリクスアンケートレコードに含める必要があります。
  ヒント：XM Discoverのエンリッチメント用データフィールドをアンケートに追加する方法の詳細については、「埋め込みデータ」を参照してください。
• 調査送信コネクタータイプを使用する場合、XM DiscoverのドキュメントにはアンケートIDのデータフィールドが含まれている必要があります。

必要な認証情報:

QualtricsおよびXM Discoverのアカウントに関して、次の情報が必要になります。

• クアルトリクスインスタンスのアドレス。
• クアルトリクスAPIトークン。
• XM DiscoverのエクスポートAPIエンドポイント。

接続の設定

1. コネクタにサインインします。
2. [ジョブ] ページの右上隅にある [新しいジョブ] ボタンをクリックします。
3. [コネクタ] ページで、[SELECT A SOURCE] セクションに移動します。
4. ［Qualtrics送信］ボタンをクリックします。

Qualtrics 送信コネクタジョブの設定

接続を設定したら、以下のステップに従ってジョブを設定します。

• ステップ 1: ジョブ名の入力
• ステップ 2: プロジェクトと説明の指定
• ステップ3：クアルトリクスのデータタイプを選択
• ステップ4：クアルトリクス認証情報の提供
• ステップ5：XM Discoverのエクスポート認証情報を設定
• ステップ 6: クエリ設定
• ステップ 7: 設定の調査の選択 (SURVEY データ型の場合のみ) -OR – JSON イベントエンドポイントの指定 (JSON EVENTデータ型の場合のみ)
• ステップ 8: 送信クエリ設定
• ステップ9：Qualtricsへの目的のフィールドのマッピング
• ステップ 10: フィルタの指定 (オプション) およびレコード制限
• ステップ 11: 通知設定 (オプション)
• ステップ 12: ジョブの追加オプションの設定
• ステップ 13: すべてのジョブ設定の確認

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

1. ページの左上の [ジョブ名] ボックスに、認識可能なジョブ名を入力します。
   注意:ジョブ名ボックスに入力した名前は、job_name 属性のハードコーディングされた値として、このジョブを介してアップロードされたすべての文書に追加されます。
   ヒント：設定時に各ページの上部に表示される [ジョブ名] フィールドを使用して、設定時にジョブ名を変更することができます。
2. [次へ] をクリックします。

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

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

ステップ3：クアルトリクスのデータタイプを選択

1. Qualtrics データタイプの選択ページで、アップロードするデータのタイプを 1 つ選択します。
   • アンケート：XM Discoverのエンリッチメントで既存のクアルトリクスアンケートを更新するには、このデータタイプを選択します。
   • JSONイベント：XM DiscoverのエクスポートデータをJSONイベント経由でクアルトリクスに送信し、XM Discoverのあらゆるデータソースからエンリッチメントを使用するxFlow自動化タスクをトリガーするには、このデータの種類を選択します。
     ヒント：詳細については、「JSONイベント」を参照してください。
2. [次へ] をクリックします。

ステップ4：クアルトリクス認証情報の提供

Qualtrics 認証情報の指定ページで、ドロップダウンメニューから既存の認証情報のセットを選択するか、新しい認証情報のセットを追加することができます。

1. 新しい認証情報セットを追加するには、認証情報ドロップダウンメニューから新規追加を選択し、以下の表に示す接続パラメータを対応するボックスに入力します。
2. 新しい認証情報セットの名前を CONNECTION NAME ボックスに入力します。
3. Qualtrics アカウントに接続された API トークンを QUALTRICS OUTBOUND API TOKEN ボックスに提供します。
4. Qualtrics インスタンスのアドレスを [QUALTRICS OUTBOUND DATACENTER ID] ボックスに入力します。
5. 特定の期間が経過した後に有効期限が切れるように認証情報を設定できます (オプション)。
6. この一連の認証情報に有効期限を定義し、すべてのジョブ参照者にリマインダを設定するには、[有効期限の通知を送信する] チェックボックスにチェックを付けます。[有効期限前の日数] ボックスが有効になります。
7. [有効期限前の日数] ボックスに値を入力して、通知が有効期限切れになるまでの日数を設定します。使用可能な値は 1 日から 100 日です。
   ヒント：このリマインダーは、有効期限が［有効期限までの日数］ボックスで設定した日数未満になると、ジョブが実行されるたびにトリガーされます。
8. カレンダ日付ピッカーから有効期限を選択します。これにより、有効期限が [有効期限] ボックスに追加されます。
9. [次へ] をクリックします。

ステップ5：XM Discoverのエクスポート認証情報を設定

1. XM Discoverのエクスポート認証情報を設定ページで、HOST ボックスに XM Discover エクスポートAPIエンドポイントを指定します。
2. [次へ] をクリックします。

ステップ 6: クエリ設定

クエリ設定ページでは、Qualtrics サーベイの更新 (データ型として SURVEY を選択した場合)、または JSON イベントを介して Qualtrics への送信 (データ型として JSON イベントを選択した場合) に使用するデータを指定することができます。

1. [データレベルを選択] プルダウンリストから以下のいずれかを選択して、送信データに関連付けられたデータの粒度レベルを選択します。
   • 文：文レベルのデータを使用します。
   • ドキュメント: ドキュメントレベルのデータを使用します。
2. [クエリを入力] ボックスで、送信データをフィルタするクエリを指定します (オプション)。Designer でデータを検索する場合と同じ構文を使用します。
   例: 次の構文を使用して、選択した調査レコードのみを更新する調査 ID を 1 つ以上指定できます: surveyid:sv_01
3. 送信データに適用されるプロジェクトのフィルタの名称を Enter the filter name ボックスに入力します (オプション)。
4. 送信ジョブが最後に実行されてから登録されたレコードを更新するには、Choose what records to retrieve で Default: Load new records を選択します。送信ジョブが最後に実行されてから登録または更新されたレコードを更新するには、新規および更新済レコードのロードを選択します。送信ジョブが最後に実行されてから更新されたレコードのみを更新するには、更新されたレコードのロードを選択します。
   ヒント：分類を実行または再実行すると、XM Discoverシステムのレコードが更新されます。
5. 送信データに含める分類データを定義することができます (オプション)。プロジェクトで利用可能なすべてのモデルの分類データを含めるには、すべてのモデルチェックボックスを選択します。選択したモデルのみを含める場合は、すべてのモデルチェックボックスを選択しないでください。すべてのモデルオプションが選択されていない場合は、ドロップダウンメニューから送信データに含める特定のモデルを選択することができます。
6. モデルルールを適用してフィルタ結果ドロップダウンメニューから、以下のいずれかのオプションを選択します。
   • 無視: 選択したモデルに基づくフィルタリングは適用されません。
   • 現在分類済: 最新の分類実行時に、選択したモデルによって分類された文/文書を返します。
   • 分類済: 選択したモデルによって任意の時点で分類された文/文書を返します。
7. カテゴリ名ではなくカテゴリ ID を返すかどうか (false) チェックボックスを選択して、カテゴリ名の代わりにカテゴリ ID を使用します (オプション)。
8. すべての最下位ノードパスを含むフィルタクエリを適用して結果を選択し、”leaf_only flag” パラメータが設定された複数のモデルをエクスポート API 呼出に追加します (オプション)。
9. 送信値のすべてが空の場合にコネクタで調査ドキュメントの更新をスキップする場合は、[空の値を無視] を選択します (オプション)。
10. [次へ] をクリックします。

ステップ 7: 設定の調査の選択 – OR – JSON イベントエンドポイントの指定

設定のアンケートを選択

1. 更新可能な Qualtrics 調査の 1 つを選択します。
   ヒント：探しているアンケートが表示されない場合は、クアルトリクス環境内からAPIキーを生成したアカウントと共有されていることを確認してください。
2. [次へ] をクリックします。

JSON EVENT ENDPOINT の指定

1. JSON イベントを介して XM Discover エクスポートデータを Qualtrics に送信する JSON イベントエンドポイント URL を指定します。
2. ヒント：JSONイベントの設定の詳細については、「JSONイベント」を参照してください。
3. [次へ] をクリックします。

ステップ 8: 送信クエリ設定

1. クアルトリクスアンケートIDを保存するXM Discoverプロジェクトから属性を選択します。
   ヒント：前のステップで選択した調査に一致する調査 ID のドキュメントのみが更新されます。
2. [次へ] をクリックします。

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

XM Discoverへの希望フィールドのマッピングページでは、XM Discoverの属性と分類結果を、クアルトリクスで定義された埋め込みデータフィールドにマッピングできます。

1. 空のカスタムフィールドボックス内をクリックし、クアルトリクスのアンケートに追加するXM Discoverフィールドを選択します。
2. XM Engageで作成された対応する埋め込みフィールドのデータのタイプを［データタイプ］ドロップダウンメニューから選択します。
3. 選択したXM Discoverフィールドの値が入力されるXM Engageの埋め込みフィールドの名前を［属性名］ボックスに入力します。
4. プラスアイコン（+）をクリックしてカスタムフィールドをさらに追加し、必要に応じて埋め込みQualtricsフィールドにマッピングします。
5. [次へ] をクリックします。

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

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

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

1. [通知設定] ページでは、以下に示すいずれかのイベントが発生した場合に、ジョブの参照者が受信する通知を選択することができます。
   • プロジェクトにゼロレコードがロードされます。
   • 連続する欠落値が見つかりました。
   • ジョブの実行が失敗します。
   • ジョブの実行が部分的に成功した。
   • ジョブはタイムアウトで終了します。
   • ジョブが失敗します。
     ヒント：通知の任意の組み合わせを選択するか、通知を選択しないように決定することができます。この場合、ジョブの監視は通知を受信しません。
     ヒント：通知設定の詳細については、「ジョブ通知」を参照してください。
2. [次へ] をクリックします。

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

1. ジョブの追加オプション設定ページの履歴/増分ジョブのスケジュールセクションで、以下のいずれかのオプションを選択します。
   • 差分データインポートのスケジュールを設定するには、[差分実行スケジュール] を選択します。
     ヒント：データの更新前にジョブとその設定を検証する場合は、［ジョブを作成（ただし、データを取得しない）］オプションを使用します。増分実行のスケジュールの詳細については、ジョブスケジュールを参照してください。
   • ワンタイムプルを設定して、ワンタイムデータインポートを実行します。
     ヒント: スケジュール設定は後で変更できます。ワンタイム実行の詳細については、データ取得を参照してください。通常実行の詳細については、ジョブスケジュールを参照してください。
2. 追加増分データセクションでは、関連するすべての履歴データをアウトバウンド転送で使用できるように、増分実行中にプルする追加データ (日数または時間数) を指定することができます (オプション)。
   ヒント：このフィールドの最大値は 30 日です。
3. [次へ] をクリックします。

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

1. すべてのジョブ設定の確認ページでは、データアップロードを実行する前に、ジョブのすべての設定の概要を表示し、必要に応じて設定を編集することができます。データアップロードを実行するには、データアップロードを実行する準備ができたら、終了ボタンをクリックします。ジョブが正常に送信されたことを確認する確認メッセージが表示されます。
2. [終了] をクリックすると、[ワンタイムプル] が即座に実行されます。[ジョブを作成するがデータを取得しない] オプションを有効にしていない場合、スケジュールされたプルはすぐに実行されてから、スケジュールに従って実行されるように設定されます。

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