クアルトリクスアウトバウンドコネクター
スイート
Customer Experience
製品
Qualtrics
このページの内容
クアルトリクスアウトバウンドコネクターについて
クアルトリクスアウトバウンドコネクターを使用すると、クアルトリクスアカウントで以下のアクションを実行できます：
- 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:会話データの場合、制限は行ではなく会話に基づいて適用されます。
［次へ］をクリックします。
［次へ］をクリックします。
［次へ］をクリックします。
セットアップを評価する。特定の設定を変更する必要がある場合は、[Edit]ボタンをクリックして、コネクタ設定のそのステップに移動します。
Finishをクリックしてジョブを保存する。
ジョブが保存されると、設定したスケジュールに基づいて、指定したデータがクアルトリクスにエクスポートされます。JSONイベントをトリガーする場合、ワークフローの実行を制限する条件や、ワークフローの出力を決定するタスクの追加など、ワークフローの残りの部分を構築してください。
当サポートサイトの日本語のコンテンツは英語原文より機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は十分な注意を払っていますが、もし、英語・日本語翻訳が異なる場合は英語版が正となります。英語原文と機械翻訳の間に矛盾があっても、法的拘束力はありません。
素晴らしい！ フィードバックありがとうございます！
フィードバックありがとうございます！