クエリ文字列を使用した情報の受け渡し

クエリ文字列について

クエリ文字列を使用すると、URLの最後にその情報を追加または「付加」するだけで、ウェブサイトに情報を渡したり、ウェブサイトからの情報を受け取ったりできます。 この情報は、クエリ文字列に格納され、ウェブサイトがURLを読み取るときにキャプチャされます。

クエリ文字列を使用して、データをアンケートに渡すことができます。 クエリ文字列を使用して渡されたデータは、アンケートの回答とともに埋め込みデータ (英語)として保存できます。 アンケートの最後に、クエリ文字列を使用してデータを別のウェブサイトまたはアンケートに渡すことができます。

クエリ文字列の構造

一般的なクエリ文字列構造

クエリ文字列は、非常に特殊な構文に従います。 これらは、?fieldName=fieldValueという一般的な形式でURLの末尾に追加されます。 FieldNameはデータフィールドの名前で、FieldValueはフィールドの特定のデータ値です。 クエリ文字列を追加したURLの例を見てみましょう。 クエリ文字列は太字で表示されます。

https://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=Facebook

回答者が上記のリンクでアンケートを受けると、「Facebook」の値を持つ「Source」データフィールドが回答とともに保存されます。

1つのURLで複数のクエリ文字列

クエリ文字列を使用すると、1つのURL内で複数のデータをすべて渡すことができます。 ただし、URLに複数のクエリ文字列が含まれている場合、構文は少し異なります。 複数のクエリ文字列が追加されたURLを見てみましょう。 クエリ文字列は太字で表示されます。

https://survey.qualtrics.com/jfe/form/SV_123456789?Source=Facebook&Campaign=Mobile

2つ目のクエリ文字列は、疑問符（?）ではなくアンパサンド（&）で始まります。 これは、URLが疑問符を1つしかサポートできないためです。 &FieldName=FieldValueの形式でフィールドを追加することで、クエリ文字列を追加できます。

回答データでクエリ文字列の値を組み合わせる

クエリ文字列内の同じフィールドに複数の値を渡すことができます。 結果は、コンマで区切られた回答データ (英語)の結合フィールドになります。

たとえば、次のクエリ文字列を渡すとします。

https://survey.qualtrics.com/jfe/form/SV_9GfoihavJJR5R7U?Client=ATT&Client=Sprint

その結果、「Client」フィールドの値は「ATT、Sprint」になります。

アンケートに情報を渡す

クエリ文字列を使用して、クアルトリクスアンケートに情報を渡すことができます。 この情報を埋め込みデータ (英語)として保存し、このフィールドを分岐 (英語)と表示 (英語)ロジックで使用して、アンケート回答者の回答とともにデータを保存できます。

https://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=Facebook

https://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=LinkedIn

クエリ文字列を使用してアンケートに情報を渡すには、2つのステップで設定する必要があります。 最初のステップではクエリ文字列を使用してURLにデータを追加し、2つ目のステップではアンケートフローに埋め込みデータ要素を作成してURLから情報を取得します。

ステップ1： アンケートURLにデータを追加する

1. アンケートの匿名リンク (英語)をコピーし、Wordやメモ帳などのテキストエディターに貼り付けます。

   https://survey.qualtrics.com/jfe/form/SV_123456789

2. 疑問符（?）をURLの末尾に追加します。

   https://survey.qualtrics.com/jfe/form/SV_123456789?

3. 疑問符の後に、埋め込みデータフィールドの名前（「state」や「city」など）を入力します。

   https://survey.qualtrics.com/jfe/form/SV_123456789?city

4. 等号（=）を追加します。

   https://survey.qualtrics.com/jfe/form/SV_123456789?city=

5. フィールドの値を入力します（例：「Utah」や「Provo」）

   https://survey.qualtrics.com/jfe/form/SV_123456789?city=Provo

6. 追加フィールドについては、疑問符（?）の代わりにアンパサンド（&）を使用して、手順2～5を繰り返します。

   https://survey.qualtrics.com/jfe/form/SV_123456789?city=Provo&state=Utah

ステップ2： URLからの情報を埋め込みデータとしてキャプチャする

1. アンケートの編集中に、左側のナビゲーションバーのアンケートフローアイコンをクリックし、［アンケートフロー (英語)］に移動します。
   
2. ［こちらに新しい要素を追加］をクリックします。
   
3. ［埋め込みデータ (英語)］要素を選択します。
   
4. URLからキャプチャするフィールドの名前を入力します。 これらのフィールドには値を割り当てないでください。 これらのフィールドについては、「コンタクトの属性情報もしくはURLにある引数の値がセットされます」と表示されます。
   
   ヒント：大文字と小文字が区別されます。 アンケートフローのフィールドが、URL内のフィールドの大文字と小文字と一致していることを確認してください。
5. 埋め込みデータ要素を (英語)アンケートフローの最上部に移動します。 これは、埋め込みデータフィールドをロジックで使用する場合や、テキストの差し込みで値を表示する場合に特に重要です。 埋め込みデータ要素は、それを参照するアンケートフローの要素の前に表示する必要があります。
   
   例： イントロダクション質問ブロックで「city」の値を質問文に差し込む場合、 埋め込みデータ要素をアンケートフローのイントロダクション質問ブロックの前に移動する必要があります。

アンケートから情報を渡す

リダイレクトURL (英語)に情報を追加することで、アンケートから別のウェブサイト、またはアンケートから別のアンケートに情報を渡すことができます。 これは通常、サードパーティのパネルプロバイダーと提携するときに行われます。

アンケートから情報を渡すには

1. 渡したい各データ（アンケートの質問への回答、埋め込みデータ、回答とともに収集されたその他の情報）について、テキストの差し込み (英語)コードを生成します。  これらのコードをコピーし、後で使用するために保存します。
   例： 回答者の回答に沿って2つのアンケート質問を渡したいと考えています。 選択したアンケートの質問の差し込みテキストは${q://QID7/ChoiceGroup/SelectedChoices}と${q://QID3/ChoiceGroup/SelectedChoices}です。
2. リダイレクトURLをコピーします。 これは、アンケート回答者を送る宛先のURLで、情報をキャプチャするウェブサイトです。
   例： クアルトリクスアンケートからサードパーティのパネルプロバイダーにリダイレクトする場合、URLはhttps://www.survey.panelcompany.comになります。
3. 疑問符（?）をURLの末尾に入力します。

   https://www.survey.panelcompany.com?

4. 渡す変数の名前を入力します。

   https://www.survey.panelcompany.com?Q7Answer

5. URLの末尾に等号（=）を追加します

   https://www.survey.panelcompany.com?Q7Answer=

6. 変数の値のテキストの差し込みコードを貼り付けます。

   https://www.survey.panelcompany.com?Q7Answer=${q://QID7/ChoiceGroup/SelectedChoices}

7. 追加の変数を渡す場合は、手順3～6を繰り返します。 追加の変数については、疑問符（?）の代わりにアンパサンド（&）を使用します。

   https://www.survey.panelcompany.com?Q7Answer=${q://QID7/ChoiceGroup/SelectedChoices}&Q3Answer=${q://QID3/ChoiceGroup/SelectedChoices}.

8. 手順7で記入したURLを適切なアンケートの終了エリア（アンケートのオプション (英語)やアンケートの終わり (英語)要素など）に貼り付けます。
   ヒント： 動作していないように見えるクエリ文字列がある場合は、 差し込みテキストの形式に関係している可能性があります。 差し込みテキストの値の末尾（最後のかっこの前）に「?format=urlencode」を追加することをお勧めします。 これにより、スペースと特殊文字を含む値がクエリ文字列に正しく引き継がれます。 たとえば、${e://Field/Department?format=urlencode}を${e://Field/Department}の代わりに使用して、Departmentという埋め込みデータをクエリ文字列に書き込みます。 ただし、「format=urlencode」はメールフィールドに追加しないでください。 追加すると、「@」記号が「%40」に変換されます。

リダイレクトリンクを作成したら、リダイレクトウェブサイトがクエリ文字列から情報をキャプチャできることを確認する必要があります。 クアルトリクスアンケートにリダイレクトする場合、情報をキャプチャするためのアンケートの準備の詳細については、前述の「アンケートに情報を渡す (英語)」のパート2を参照してください。

メールで送信したリンクへのクエリ文字列の追加

クアルトリクスメールエディターの中には、アンケートリンク自体ではなく、アンケートリンクの差し込みテキストが含まれているものがあります。 これには、メールで送信されるアンケート招待 (英語) とともにXM Directoryタスク (英語)が含まれます。 メールの送信時にクエリ文字列がリンクに追加されるように、これらのリンクの差し込みテキストにクエリ文字列を追加できます。 たとえば、同様の配信を多数送信し、どの回答がどの配信から来ているかを追跡する場合にこの方法を使用します。 クアルトリクスメールでリンクが適切に構築され、ハイパーリンクが設定されていることを確認するために、追加の手順を実行する必要があります。

1. メールエディターを開き、メッセージの作成を開始します。 これは、メールアンケートの招待 (英語)用のメールエディター、またはXM Directory (英語)タスクです。
2. メッセージにすでにアンケート用の差し込みテキストコードがある場合は、そのコードを削除します。 アンケートリンクのテキストの差し込みコードは、通常、${l://SurveyURL}の形式です。 こうすることによって、確実にエラーのないリンクを構築できます。
   
   
3. テキストの差し込みアイコンを選択します。 {A}をクリックし、［アンケートリンク］→［アンケートURL］を選択します。
   
4. 「アンケートに情報を渡す (英語)」のパート1の指示に従って、リンクを作成します。 挿入したテキストの差し込みコードは、URLとして機能します。
   例： たとえば、アンケートをいくつかの段階（Wave）に分けて送信し、回答者がどの段階に含まれていたかを追跡したいとします。 メールエディターのURLは、「${l://SurveyURL}?Wave=wave1」のようになります
   ヒント： テキストの差し込みは、クエリ文字列変数と値に使用することもできます。 しかし、差し込まれた値が正しくエンコードされていることを確認するには、「?format=urlencode」をテキストの差し込み値の末尾、最後の括弧の前に追加する必要があります。 これにより、スペースと特殊文字を含む値がクエリ文字列に正しく引き継がれます。 たとえば、${e://Field/Department?format=urlencode}を${e://Field/Department}の代わりに使用して、Departmentという埋め込みデータをクエリ文字列に書き込みます。 ただし、「format=urlencode」はメールフィールドに追加しないでください。 追加すると、「@」記号が「%40」に変換されます。 また、アンケートURLの差し込みテキストに「format=urlencode」を追加しないでください。
5. 新しく作成したリンクをコピーし、メッセージエディターでそのリンクをハイライトします。
   
6. ハイパーリンクボタンをクリックします。
7. ［URL］ボックスに、コピーしたリンクを貼り付けます。
   
8. プロトコルを<other>に変更します。
9. 必要に応じて、リンクの表示テキストを、「アンケートに回答するにはここをクリック」などに変更します。
10. ［OK］をクリックします。

Q_EEDの使用方法

Q_EED は、難読化された（または Base64 エンコードされた）埋め込みデータパラメーターを渡すためのURLパラメーターとして使用できます。 最も一般的なユースケースの1つは、URLを介してJSONデータをバイナリ形式で渡すことです。

以下の例では、アンケートリンクの最後にクエリ文字列として付加したQ_EEDを使用して、回答者の性別（男性）と年齢（32）をクアルトリクスアンケートに伝達します。

1. 埋め込まれたデータの性別と 年齢をアンケートフローに追加します。
2. 渡す情報をJSON形式で書き出します。 例：

   {"Gender":"Male","Age":32}

3. 次に、JSON形式全体をブラケットからブラケットまで Base64でエンコード (英語)  します。 エンコードすると、ステップ2のJSONは次のようになります。

   eyJHZW5kZXIiOiJNYWxlIiwiQWdlIjozMn0=

4. アンケートURLを取得します。
5. URLのどこかに疑問符（?）が付いている場合は、末尾にアンパサンド（&）を追加します。 疑問符がない場合は、末尾に疑問符（?）を追加します。
6. ステップ3の結果をURLの最後に追加します。 以下のようになります。

   https://survey.qualtrics.com/jfe/form/SID=SV_1234?Q_EED=eyJHZW5kZXIiOiJNYWxlIiwiQWdlIjozMn0=

Q_PopulateResponseの使用方法

Q_PopulateResponseは、アンケートの回答を事前入力するためのURLパラメーターとして使用できます。

値は、JSON形式のフィールドとしてURLを通じて渡されます。

YourSurveyURL?Q_PopulateResponse={"QID1":"6","QID2":"4","QID3":"this is my text","QID4":"1"}

昨年の回答を今年のアンケートに差し込む場合は、回答を埋め込みデータとして連絡先リストにアップロードし、これらの回答を参照するカスタム個別リンクを設定します。 まず、配信メール (英語)にクリック可能なテキストを書き出し、アンケートURLの差し込みテキストを取得 (英語)してから、リッチコンテンツエディターのリンクボタン (英語)を使用して、次のようなリンクを作成します。

${l://SurveyURL}?Q_PopulateResponse={"QID1":"${e://Field/QID1}","QID2":"${e://Field/QID2}","QID3":"${e://Field/QID3}"}

この例では、連絡先フィールドQID1、QID2、QID3を参照しています。 引用符（"）は %22でエンコードしてください。ただし、テキストの差し込みが無効になるため、URL文字列全体をエンコードしないでください。

このリンクによって、昨年の回答が入力されます。 ユーザーがこれらのデフォルトの回答の一部を変更してアンケートを終了した場合は、アンケートを再開したとき、最新の保存内容によってURLの状態が上書きされます。 また、質問の表示ロジックがある場合、その質問は入力されますが、回答者がその質問を表示する正しいロジックを選択しない限り、その質問は記録されません。

一般的なユースケース

以下は、クエリ文字列を使用する一般的なクアルトリクスのユースケースの一部です。 詳細については、リンク先のページをご覧ください。

• 2つ目のアンケートにデータを流す（長期的なアンケート） (英語)
• パネル企業と統合する
• 再回答リンクを構築する (英語)