クアルトリクス受信コネクター
クアルトリクス受信コネクターについて
Qualtrics 受信コネクタを使用して、Qualtrics アカウントから調査を読み込むことができます。
クアルトリクスアカウントからXM Discoverにデータをアップロード
開始する前に
ヒント:この機能を使用するには、「ジョブの管理」権限が必要です。コネクタのユーザ権限の詳細については、権限を参照してください。
Qualtrics 受信コネクタを使用してジョブを設定する前に、Qualtrics アカウントに関連する以下の情報があることを確認してください。
- クアルトリクスインスタンスのアドレス。
- クアルトリクスAPIトークン。
- データのアップロード元となるアンケートの名前。
ヒント:詳細については、Qualtrics APIのドキュメントを参照してください。
接続の設定
Qualtrics 受信コネクタジョブの作成
接続を設定したら、以下のステップに従って、QualtricsアカウントからXM Discoverにアンケートをロードします。
- ステップ 1: ジョブ名の入力
- ステップ 2: プロジェクトと説明の指定
- ステップ3:クアルトリクス認証情報の提供
- ステップ4:クアルトリクスデータタイプ
- ステップ5:XM Discoverに目的のフィールドをマッピング
- ステップ 6: データ代替および編集 (オプション)
- ステップ 7: フィルタ指定 (オプション) およびレコード制限
- ステップ 8: 通知および設定 (オプション)
- ステップ 9: ジョブの追加オプションの設定
- ステップ 10: すべてのジョブ設定の確認
注意: 設定ステップは 1 回で完了する必要があります。
ステップ 1: ジョブ名の入力
ページの左上の
[ジョブ名] ボックスに、認識可能なジョブ名を入力します。
注意: ジョブ名ボックスに入力した名前は、job_name 属性のハードコーディングされた値として、このジョブを介してアップロードされたすべての文書に追加されます。
ヒント:設定時に各ページの上部に表示される [ジョブ名] フィールドを使用して、設定時にジョブ名を変更することができます。
ステップ 2: プロジェクトと説明の指定
ステップ3:クアルトリクス認証情報の提供
- [クアルトリクス認証情報を提供]ページで、ドロップダウンメニューから既存の認証情報セットを選択できます。
ヒント:クアルトリクス認証情報の新しいセットを追加できます。新しいクアルトリクス認証情報については、 新しいクアルトリクス資格情報の追加 」セクションで説明されている手順を使用して差し込むことができます。 - [次へ] をクリックします。
ステップ4:クアルトリクスデータタイプ
- [クアルトリクスデータタイプ]ページで、以下のいずれかのオプションを選択して、XM Discoverにアップロードするデータのタイプを指定します。
- アンケート:特定のQualtricsからデータをアップロードする方法詳細については、以下の「アンケート」サブセクションを参照してください。
- オンライン評価管理(ORM):Qualtrics 評価管理プロジェクトからレビューと場所データをアップロードします。詳細については、下記のオンライン評価管理 (ORM) サブセクションを参照してください。
- チケット:QualtricsEngageからチケットデータを取り込みます。詳細については、下記のチケットサブセクションを参照してください。
注意:組織がクアルトリクスエンゲージメントチケットデータをコネクターに取り込む場合、組織はクアルトリクスの[ループを閉じる]プログラムに登録する必要があります。
- [次へ] をクリックします。
アンケート
- [アンケート]を選択すると、[設定対象のアンケートを選択]ページに移動します。このページでは、データのアップロード元として使用可能な Qualtrics アンケートの 1 つを選択できます。
ヒント:探しているアンケートが表示されない場合は、クアルトリクス環境内からAPIキーを生成したアカウントと共有されていることを確認してください。 - 選択したアンケートでフィルターを使用できる場合は、メニューからクアルトリクスフィルターの1つを選択します(オプション)。詳細については、「回答のフィルタリング」を参照してください。
- アップロードに未終了の回答を含める場合は、”処理中” の回答を取得チェックボックスを選択します。完了した回答のみを取り込む場合は、このチェックボックスを選択しないでください。
ヒント:ジョブの作成後にクエリー設定を更新できます。
オンライン評価管理 (ORM)
オンライン評価管理 (ORM) を選択すると、ORM データセット ID の指定ページに移動します。このページでは、インポートしたデータプロジェクトの idpSourceId を IDP ソース ID ボックスに入力することができます。
ヒント:インポートされたデータプロジェクトの idpSourceId の取得については、「Imported Data Project API」を参照してください。
チケット
チケットを選択すると、 XM Discoverへの希望フィールドのマッピング XM Discoverプロジェクトのデータフィールドにソースデータフィールドを接続できるページです。
ステップ5:XM Discoverに目的のフィールドをマッピング
- XM Discoverに目的のフィールドをマッピングページで、[ソースマッピング]タブを選択し、ソースデータフィールドをXM Discoverプロジェクトのデータフィールドに接続します。
- デフォルトのソースマッピングセクションで、XM Discoverのすべての文書が共有するデフォルトのデータフィールドを設定します。デフォルトソースマッピングの詳細については、を参照してください。 デフォルトソースマッピング 」セクションで説明されている手順を使用して差し込むことができます。
- ソースマッピングセクションで、ファイルからの追加データフィールドを設定します。
ヒント:データマッピングの詳細については、「データマッピングの設定」を参照してください。 - [次へ] をクリックします。
ステップ 6: データ代入および編集 (オプション)
- データ置換およびレッドアクションページでは、カスタマフィードバックおよびインタラクションで、機密データを非表示にしたり、特定の単語およびフレーズを自動的に置換したりするための代替ルールと編集ルールを指定することができます。
ヒント:データの置換と編集の詳細については、「データの差し戻しと取り消し」を参照してください。 - [次へ] をクリックします。
ステップ 7: フィルタの指定 (オプション) およびレコード制限
- [フィルタの指定] ページでは、ジョブに対するフィルタ条件を定義して、それを満たすレコードのみをロードすることができます (オプション)。
ヒント:フィルターの適用の詳細については、「コネクターフィルター」を参照してください。 - [レコード制限の指定]ボックスでレコード制限を指定できます。また、すべてのレコードを 1 回のプッシュで返す場合は、レコード制限をデフォルトのすべてのままにしておくこともできます。
ヒント:レコード制限は、ジョブの実行ごとの制限です。1,000 に設定すると、ジョブは設定した任意のスケジュールで実行され、1,000 件のレコードを取得した後に停止します。日次に設定すると、1 日に 1 回実行され、1 日あたり最大 1,000 件のレコードが取得されます。ヒント:会話データの場合、上限は行ではなく会話に基づいて適用されます。
- [次へ] をクリックします。
ステップ 8: 通知設定 (オプション)
- [通知設定] ページでは、以下に一覧表示されたイベントのいずれかが発生した場合に、ジョブの参照者が受信する通知を選択することができます。
- プロジェクトにゼロのレコードがロードされたら通知します。
- 連続した欠損値が見つかった場合に通知します。
- ジョブの実行が失敗した場合に通知します。
- ジョブ実行が部分的に成功した場合に通知します。
- ジョブがタイムアウトで終了した場合に通知します。
- このジョブが失敗した場合は、サポートに通知します。
ヒント:通知の任意の組み合わせを選択するか、通知を選択しないことを決定できます。この場合、ジョブの監視は通知を受信しません。
ヒント:通知設定の詳細については、「ジョブ通知」を参照してください。
- [次へ] をクリックします。
ステップ 9: ジョブの追加オプションの設定
- ジョブの追加オプション設定ページの新規および既存文書の処理セクションで、新規および既存文書の処理セクションにある以下のチェックボックスの 1 つを選択して、重複文書の処理方法を選択します。
ヒント:重複検出モードの詳細については、「重複検出」を参照してください。
- ジョブの追加オプションの設定ページの履歴/増分ジョブのスケジュールセクションで、以下のオプションの 1 つを選択します。
- 差分データインポートのスケジュールを設定するには、[差分実行スケジュール] を選択します。
ヒント:追加実行のスケジュールの詳細については、「ジョブスケジュール」を参照してください。
- ワンタイムプルを設定して、ワンタイムデータインポートを実行します。
ステップ 10: すべてのジョブ設定の確認
- すべてのジョブ設定の確認ページでは、データアップロードを実行する前に、ジョブのすべての設定の概要を表示し、必要に応じて設定を編集することができます。
- データアップロードを実行するには、データアップロードを実行する準備ができたら、終了ボタンをクリックします。ジョブが正常に送信されたことを確認する確認メッセージが表示されます。
終了をクリックすると、1 回限りのプルが即時に実行されます。[ジョブを作成するがデータを取得しない] オプションを有効にしていない場合、スケジュールされたプルはすぐに実行されてから、定義したスケジュールに従って実行されるように設定されます。ジョブの監視
の詳細については、ジョブページ概要を参照してください。
新しいクアルトリクス資格情報の追加
- 新しい認証情報のセットを追加するには、認証情報メニューから新規追加を選択します。
- 新しい認証情報セットの名前を CONNECTION NAME ボックスに入力します。
- [クアルトリクスデータセンターID]ボックスにクアルトリクスデータセンターIDを入力します。
ヒント:データセンターの検索については、「クアルトリクスIDの検索」ページの「データセンターIDの検索」セクションを参照してください。
- クアルトリクスのAPIトークンをQUALTRICS APIトークンボックスに入力します。
ヒント:Qualtrics APIトークンを見つける方法については、「APIトークン認証」を参照してください。
- 特定の期間が経過すると認証情報が期限切れになるように設定できます (オプション)。この一連の認証情報に有効期限を定義し、すべてのジョブ参照者にリマインダを設定するには、[有効期限の通知を送信する] チェックボックスにチェックを付けます。[有効期限前の日数] ボックスが有効になります。
- [有効期限前の日数] ボックスに値を入力して、通知が有効期限切れになるまでの日数を設定します。使用可能な値は 1 日から 100 日です。
ヒント:このリマインダーは、有効期限が[有効期限までの日数]ボックスで設定された日数未満になると、ジョブが実行されるたびにトリガーされます。
- カレンダ日付ピッカーから有効期限を選択します。これにより、有効期限が [有効期限] ボックスに追加されます。
デフォルトソースマッピング
ヒント:次のデータフィールドは編集できません:natural_id、feedback_provider、feedback_type、loadDate。
以下は、Qualtrics 受信コネクタのデフォルトのデータフィールドオプションです。
- natural_id: Natural_id は、ドキュメントの一意の識別子として機能し、重複するドキュメントを適切に処理することができます。自然IDの場合、XM Discoverはカスタム変換を介してコネクタ名の接頭辞が付いたソース ID を使用します。Natural ID = Connector-name;Source-ID
- document_date: ドキュメント日付は、ドキュメントに関連付けられている主要な日付フィールドです。この日付は、XM Discoverのレポート、トレンド、アラートなどで使用されます。伝票日付で、以下のオプションの 1 つを選択します。
- endDate(デフォルト):回答者がアンケートを提出した日時。エントリが部分回答の場合、この値は、回答者が最後にアンケートにアクセスした日時を示します。
- startDate:回答者がアンケートリンクを最初にクリックした日時。
- recordedDate:クアルトリクスでアンケートの回答が開始、送信、更新されたときの記録です。
- job_name: ジョブ名は、アップロードに使用されたジョブの名前に基づいてデータを識別するのに役立ちます。設定時に各ページの上部に表示されるジョブ名フィールドを使用して、この属性の値を変更することができます。
- loadDate:ロード日は、ドキュメントがXM Discoverにアップロードされた日付を示します。この項目は自動的に設定されます。
- feedback_provider: フィードバック提供者は、特定のプロバイダから取得したデータを識別するのに役立ちます。Qualtrics ドキュメントの場合、この属性の値は Qualtrics に設定されます。
- feedback_type: フィードバックタイプは、データのタイプに基づいてデータを識別するのに役立ちます。これは、プロジェクトにさまざまなタイプのデータ(アンケートやソーシャルメディアフィードバックなど)が含まれる場合にレポートに役立ちます。Qualtrics ドキュメントの場合、この属性の値は[アンケート]に設定されます。
- source: ソースは、特定のソースから取得されたデータを識別するのに役立ちます。これは、サーベイやモバイルマーケティングキャンペーンの名称など、データの発生源を示すあらゆるものにできます。デフォルトでは、この属性の値は Qualtrics に設定されていますが、ハードコーディングされた値列に独自の値を指定することができます。