Skip to main content
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

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


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


クエリ文字列について

クエリ文字列を使用すると、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?ソース=Facebook&Campaign=モバイル

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

注意:クエリ文字列を介して渡すことができるデータ量にクアルトリクスの制限はありませんが、ウェブブラウザーにはURL文字の長さの制限があります。これらの制限はブラウザーによって異なります。URLは2,000文字以下にすることをおすすめします。ブラウザーごとの制限については、各ブラウザーのヘルプドキュメントを参照してください。

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

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

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

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

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

[記録された回答]セクションを拡大した画像

アンケートに情報を渡す

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

例:クエリ文字列を使用して、参加者がアンケートにアクセスしているソースを追跡できます。たとえば、複数のソーシャルメディアサイトでアンケートを実施するとします。Facebookから来ている参加者とLinkedInから来ている参加者を区別して追跡する場合は、2つのカスタマイズされたリンク(太字のクエリ文字列)を作成します。

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

これらのクエリ文字列は、「Source」フィールドに2つの異なる値を保存します。値はそれぞれ「Facebook」と「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=ユタ

パート2:URLから埋め込みデータとして情報を取り込む

  1. アンケートの編集中に、左側のナビゲーションバーのアンケートフローアイコンをクリックして アンケートフロー に移動します。
    左側のナビゲーションバーのアンケートフローアイコンをクリックして[アンケートフロー]に移動する
  2. こちらに新しい要素を追加]をクリックします。
    アンケートフローで[ここに新しい要素を追加]をクリック
  3. 埋め込みデータ ]要素を選択します。
    新しいアンケートフロー要素。埋め込みデータを選択
  4. URLから取得するフィールドの名前を入力します。これらの項目に値を割り当てないでください。これらのフィールドについては、「コンタクトの属性情報もしくはURLにある引数の値がセットされます」と表示されます。
    クエリ文字列に対応する2つのフィールドを持つ埋め込みデータ要素

    ヒント:フィールドを大文字にすることは重要です。アンケートフローのフィールドが、URL内のフィールドの大文字と小文字と一致していることを確認してください。
  5. 埋め込みデータ要素をアンケートフローの上部に移動します。これは、埋め込みデータフィールドをロジックで使用する場合や、テキストの差し込みで値を表示する場合に特に重要です。埋め込みデータ要素は、それを参照するアンケートフローの要素の前に表示する必要があります
    アンケートフローの最上部に移動された埋め込みデータ要素

    例:イントロダクション質問ブロックで、「city」の値を質問文に差し込みます。埋め込みデータ要素をアンケートフローのイントロダクション質問ブロックの前に移動する必要があります。

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

リダイレクトURLに情報を追加することで、アンケートから別のウェブサイト、または1件のアンケートから別のアンケートに情報を渡すことができます。これは通常、 サードパーティパネルプロバイダーと協力して作業する際に行われます。

注意: リダイレクトの宛先で、URLで渡された情報が受け入れられるように設定する必要があります。設定されていないと、渡された情報は取得されません。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}でなく${e://Field/Department?format=urlencode}を使用して、Departmentという埋め込みデータをクエリ文字列に取り込みます。ただし、「format=urlencode」はメールフィールドに追加しないでください。追加すると、「@」記号が「%40」に変換されます。

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

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

  1. メールエディターを開き、メッセージの作成を開始します。これは、メールアンケートの招待用のメールエディター、またはXM Directoryタスクです。
  2. メッセージにすでにアンケート用の差し込みテキストコードがある場合は、そのコードを削除します。アンケートリンクの差し込みテキストコードは通常、${l://SurveyURL}の形式です。これは、構築するリンクにエラーがないことを確認するために行います。
    アンケートリンク用のテキストの差し込みを含むメールエディター
  3. テキストの差し込みアイコン{A} をクリックし、[アンケートリンク]→[アンケートURL]の順に選択します。
    メールエディター。テキストの差し込みボタン -[アンケートリンク]-[アンケートURL]をクリックして、正しいテキストの差し込みを挿入する
  4. アンケートに情報を渡す」のパート1の指示に従って、リンクを作成します。挿入したテキストの差し込みコードは、URLとして機能します。
    ヒント:クエリ文字列を作成するときは、各文字列にアンプ(&amp)を使用してください。個別のアンケートリンクにはすでにクエリ文字列が含まれています。
    例:アンケートを段階的に送信し、回答者がどの段階に参加したかを追跡するとします。メールエディターの URL は ${l://SurveyURL}&Wave=wave1 のようになります。
    Qtip:クエリ文字列の変数と値にテキストの差し込みを使用することもできます。ただし、差し込み値を正しくエンコードするには、差し込みテキスト値の末尾に最後の角括弧の前に&format=urlencode を追加する必要があります。これにより、スペースと特殊文字を含む値がクエリ文字列に正しく引き継がれます。たとえば、Department という埋め込みデータを ${e://Field/Department} の代わりに ${e://Field/Department&format=urlencode} を使用してクエリ文字列に取り込みます。ただし、「format=urlencode」はメールフィールドに追加しないでください。追加すると、「@」記号が「%40」に変換されます。また、アンケートURLの差し込みテキストに「format=urlencode」を追加しないでください。
  5. 新しく作成したリンクをコピーし、メッセージエディターでそのリンクをハイライトします。
    メールエディターでURLをハイライトし、ハイパーリンクボタンをクリックしてURLをハイパーリンクする
  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でエンコードします。データをエンコードするときに URL セーフなエンコードを実行をオンにしてください。エンコードすると、ステップ2のJSONは次のようになります。
    eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==
  4. Q_EED 項目の値として、ステップ3の文字列を追加します。
    Q_EED=eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==
    
  5. アンケートURLを取得します。
  6. URL に疑問符 (?) がある場合アンパサンド (&) を末尾に追加します。疑問符がない場合は、末尾に疑問符(?)を追加します。
  7. URLの最後にステップ4の結果を追加します。以下のようになります。
    https://survey.qualtrics.com/jfe/form/SID=SV_1234?Q_EED=eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==
ヒント:変数のスペル、句読点、大文字小文字の区別は変更しないでください。アンケートフローで「Gender」と表示する場合、この情報を正常にエンコードして引き継ぐには、「G」を常に大文字にする必要があります。
警告:セキュリティ上の理由から、エンコードされた文字列にプラス記号( + )を含めることはできません。プラス記号を含めると、埋め込みデータは記録されません。代わりにダッシュ ( ) を使用してください。

Q_PopulateResponseの使用方法

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

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

YourSurveyURL?Q_PopulateResponse={"QID1":"6","QID2":"4","QID3":"これは私のテキストです","QID4":"1"}

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

${l://SurveyURL}などにリンクしますか?Q_PopulateResponse={"QID1":"${e://Field/QID1}","QID2":"${e://Field/QID2}","QID3":"${e://Field/QID3}"}

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

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

ヒント:JSON形式のヘルプについては、ページ下部のFAQを参照してください。

一般的なユースケース

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

クエリ文字列を使用できるプロジェクトのタイプ

クエリ文字列は、リンクがあるあらゆるタイプのプロジェクトで使用できます。含まれる内容は以下のとおりです:

ヒント:このサポートページは、アンケートプロジェクトを念頭に置いたものです。このページで説明するすべてのユースケースがすべてのプロジェクトタイプに関連するわけではありません。

FAQ

当サポートサイトの日本語のコンテンツは英語原文より機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は十分な注意を払っていますが、もし、英語・日本語翻訳が異なる場合は英語版が正となります。英語原文と機械翻訳の間に矛盾があっても、法的拘束力はありません。