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

スイート

Customer Experience Employee Experience Strategy & Research

製品

Qualtrics

このページの内容

クエリ文字列について

クエリ文字列を使用すると、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 の形式でフィールドを追加すると、クエリ文字列をさらに追加できます。

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

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

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

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

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

その結果、「クライアント」フィールドの値は「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へのデータの追加

アンケートの匿名リンクをコピーし、Wordやメモ帳などのテキストエディターに貼り付けます。https://survey.qualtrics.com/jfe/form/SV_123456789

疑問符（?）をURLの末尾に入力します。 https://survey.qualtrics.com/jfe/form/SV_123456789?

疑問符の後に、埋め込みデータフィールドの名前（「state」や「city」など）を入力します。 https://survey.qualtrics.com/jfe/form/SV_123456789?city

等号 (=) を追加 https://survey.qualtrics.com/jfe/form/SV_123456789?city=

フィールドの値を入力します（例：「Utah」や「Provo」） https://survey.qualtrics.com/jfe/form/SV_123456789?city=Provo

追加するフィールドがある場合は、ステップ2～5を繰り返します。その際、疑問符(?)ではなくアンパサンド(&)を使用してください。 https://survey.qualtrics.com/jfe/form/SV_123456789?city=Provo&state=Utah

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

アンケートの編集中に、左側のナビゲーションバーにあるアンケートフローアイコンをクリックして、アンケートフローに移動します。

navigating to the survey flow by clicking the survey flow icon on the left navigation bar

［こちらに新しい要素を追加］をクリックします。

The survey flow. click Add a new element here

埋め込みデータ要素を選択します。

a new survey flow element. select embedded data

URLから取得するフィールドの名前を入力します。これらの項目に値を割り当てないでください。これらのフィールドについては、「コンタクトの属性情報もしくはURLにある引数の値がセットされます」と表示されます。

an embedded data element with 2 fields corresponding to our query string

ヒント：フィールドの大文字と小文字は区別されます。アンケートフローのフィールドが、URL内のフィールドの大文字と小文字と一致していることを確認してください。

埋め込みデータ要素をアンケートフローの上部に移動します。これは、埋め込みデータフィールドをロジックで使用する場合や、テキストの差し込みで値を表示する場合に特に重要です。埋め込みデータ要素は、それを参照するアンケートフローの要素の前に表示する必要があります。

the embedded data element has been moved to the top of the survey flow

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

注意：クエリ文字列の埋め込みデータ値は、常にアンケートの冒頭で保存されます。これは、埋め込みデータの値がアンケートフローの後半で参照されている場合でも同様です。

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

リダイレクトURLに情報を追加することで、アンケートから別のウェブサイト、またはアンケートから別のアンケートに情報を渡すことができます。これは、第三者のパネルプロバイダーと連携する場合によく行われます。

注意: リダイレクトの宛先で、URLで渡された情報が受け入れられるように設定する必要があります。設定されていないと、渡された情報は取得されません。URLで渡された情報を受け入れるようにアンケートを構成する方法については、前述の「アンケートに情報を渡す」を参照してください。

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

受け渡すデータごとにテキストの差し込みコードを生成します（アンケートの質問への回答、埋め込みデータ、回答とともに収集されたその他の情報など）。これらのコードをコピーし、後で使用するために保存します。

例：2つのアンケート質問の回答を渡します。選択したアンケートの質問のテキストの差し込みは${q://QID7/ChoiceGroup/SelectedChoices}および${q://QID3/ChoiceGroup/SelectedChoices}です。

リダイレクトURLをコピーします。これは、アンケート回答者に送るURLで、情報を取得するウェブサイトです。

例：あるクアルトリクスアンケートからサードパーティのパネルプロバイダーにリダイレクトするため、URLは https://www.survey.panelcompany.comです。

疑問符（?）をURLの末尾に入力します。 https://www.survey.panelcompany.com?

渡す変数の名前を入力します。 https://www.survey.panelcompany.com?Q7Answer

URLの末尾に等号（=）を追加します。 https://www.survey.panelcompany.com?Q7Answer=

変数の値のテキストの差し込みコードを貼り付けます。 https://www.survey.panelcompany.com?Q7Answer=${q://QID7/ChoiceGroup/SelectedChoices}

追加の変数を渡す場合は、手順3～6を繰り返します。追加の変数には、疑問符(?)ではなくアンパサンド(&)を使用してください。

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

手順7で記入したURLを適切なアンケート終了領域に貼り付けます（デフォルトやアンケートフロー要素など）。

ヒント：機能していないと思われるクエリ文字列はありますか？URLエンコーディングに関するセクションを参照してください。

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

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

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

メールエディターを開き、メッセージの作成を開始します。これは、メールでのアンケート招待のメールエディター、またはメールでアンケートを送信するタスクである可能性があります。

メッセージにすでにアンケート用の差し込みテキストコードがある場合は、そのコードを削除します。アンケートリンクの差し込みテキストコードは通常、${l://SurveyURL}の形式です。これは、構築するリンクにエラーがないことを確認するために行います。

the email editor with piped text for survey links

テキストの差し込みアイコン{A} をクリックし、［アンケートリンク］→［アンケートURL］の順に選択します。

the email editor. click the piped text button --> survey links --> survey URL to insert the correct piped text

「アンケートに情報を渡す」のパート1の指示に従って、リンクを作成します。挿入したテキストの差し込みコードは、URLとして機能します。

ヒント：クエリ文字列を作成する際は、個々のアンケートリンクにすでにクエリ文字列が含まれているため、各文字列に「&」を使用してください。

例：アンケートを段階的に送信し、回答者がどの段階に参加したかを追跡するとします。メールエディター内のURLは、${l://SurveyURL}&Wave=wave1のようになります。

ヒント：機能していないと思われるクエリ文字列はありますか？URLエンコーディングに関するセクションを参照してください。

新しく作成したリンクをコピーし、メッセージエディターでそのリンクをハイライトします。

highlight your URL in your email editor and click the hyperlink button to hyperlink the URL

ハイパーリンクボタンをクリックします。

［URL］ボックスに、コピーしたリンクを貼り付けます。

プロトコルを<other>に変更します。

必要に応じて、リンクの表示テキストを変更します (例: 「ここをクリックしてアンケートに回答」)。

［OK］をクリックします。

警告：アンケートを配信する前にメールをエンコードしたり、HTMLを追加したりすると、クエリ文字列が正常に機能しない場合があります。

クエリ文字列のURLエンコーディング

ヒント：このソリューションは、アンケート回答イベントで開始するワークフローでのみ機能します。例えば、アンケートの回答を使用してメールタスクをトリガーする場合などです。

動作していないように見えるクエリ文字列がある場合は、差し込みテキストの形式に関係している可能性があります。URLは、スペースや記号などの特殊文字を常に読み取れるとは限りません。そのため、URLがこれらの文字を処理する方法を理解できるよう、エンコードする必要があります。

ベストプラクティスは、最後の括弧の前に「?format=urlencode」をテキストの差し込みの値の末尾に追加することです。これにより、スペースと特殊文字を含む値がクエリ文字列に正しく引き継がれます。

例：${e://Field/Department}の代わりに${e://Field/Department?format=urlencode}を使用することで、Departmentという埋め込みデータをクエリ文字列に取り込みます。

警告：メールアドレスのフィールドに?format=urlencodeを追加しないでください。追加すると、「@」記号が「%40」に変換されます。

警告：アンケートURLのテキストの差し込みに「?format=urlencode」を追加しないでください。代わりに、クエリ文字列にテキストの差し込みが含まれている完全なアンケートURLに追加してください。正しい使用例は次のようになります：https://qunivocalize.co1.qualtrics.com/jfe/form/SV_xxxxxxx?Department=${e://Field/Department?format=urlencode}&Office=${e://Field/Office?format=urlencode}

URLエンコード形式の前にのみクエスチョンマークを使用してください。アンパサンド(&)やその他の文字は使用しないでください。

Q_EEDの使用方法

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

以下の例では、アンケートリンクの末尾にクエリ文字列としてQ_EEDを追加し、回答者の性別(男性)と年齢(32)をクアルトリクスのアンケートに渡します。

埋め込みデータの性別と年齢をアンケートフローに追加します。

渡す情報をJSON形式で書き出します。例：{"Gender":"Male","Age":32}

次に、JSON形式全体を、始めの角括弧から終わりの角括弧までBase64でエンコードします。URLセーフエンコーディングを実行するオプションに必ずチェックを入れてください。エンコードされると、ステップ2のJSONは次のようになります。eyJHZW5kZXIiOiJNYWxlIiwiQWdlIjozMn0

Q_EED 項目の値として、ステップ3の文字列を追加します。

Q_EED=eyJHZW5kZXIiOiJNYWxlIiwiQWdlIjozMn0

アンケートURLを取得します。

URLのいずれかの場所に疑問符(?)が含まれている場合は、末尾にアンパサンド(&)を追加します。疑問符がない場合は、末尾に疑問符（?）を追加します。

URLの最後にステップ4の結果を追加します。以下のようになります。 https://survey.qualtrics.com/jfe/form/SID=SV_1234?Q_EED=eyJHZW5kZXIiOiJNYWxlIiwiQWdlIjozMn0

ヒント：変数のスペル、句読点、大文字小文字の区別は変更しないでください。アンケートフローに「Gender」と表示されている場合、情報を正常にエンコードして引き継ぐには、Gを常に大文字にする必要があります。

警告：セキュリティ上の理由から、エンコードされた文字列にプラス記号（ + ）を含めることはできません。プラス記号を含めると、埋め込みデータは記録されません。代わりにダッシュ(–)を使用してください。

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の状態が上書きされます。また、質問に表示ロジックがある場合、その質問は入力されますが、回答者がその質問を表示する正しいロジックを選択しない限り、その質問は記録されません。

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

一般的なユースケース

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

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

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

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

FAQs

アンケートのすべての質問にQ_PopulateResponseを設定する必要がありますか？

いいえ、質問はいくつでも好きな数だけ選択できます。

質問のJSONフォーマットはどのように確認すればよいですか？

以下の例を参考にしてください。QuestionIDはデータをエクスポートする際の質問のインポートIDであり、ChoiceIDは特定の回答の選択肢に割り当てられた識別値です。

多項目選択式（短縮形式）：「QuestionID」：「ChoiceID」

多項目選択式（完全形式）：「QuestionID」:[{"Value":"ChoiceID","Text":"text"}]

テキスト入力：「QuestionID」：「これはテキストフィールドです」

複数回答（短縮形式）：「QuestionID」：「ChoiceID,ChoiceID,ChoiceID」

複数回答（完全形式）：「QuestionID」:[{"Value": "ChoiceID"}, {"Value":"ChoiceID", "Text": "Text"}]

マトリックス（短縮形式）：「QuestionID」:{"StatementID":"ScaleID(s)","StatementID":"ScaleID(s)","StatementID":"ScaleID(s)"}

ヒント：マトリックス複数選択の場合、ScaleIDはカンマで区切られます。例：{"QID1":{"1":{"Value":"1,2,3"}}}

マトリックス完全形式：「QuestionID」:{"StatementID":{"Value": "ScaleID(s)", "Text": "Text1"},"StatementID":{"Value": "ScaleID(s)", "Text": "Text2"}}

ヒント：マトリックス複数選択の場合、ScaleIDはカンマで区切られます。例：{"QID1":{"1":{"Value":"1,2,3"}}}

マトリックステキスト入力 & マトリックス定数和: "QuestionID":{"StatementID":{"ScaleID": "テキスト"},"StatementID":{"ScaleID": "テキスト2"}}

マトリックステキスト入力 & マトリックス定数和フルフォーマット: "QuestionID":{"StatementID":{"Value": {"ScaleID": "Text"}, "Text": "テキスト入力を許可"},"StatementID": {"Value": {"ScaleID": "Text2"}}}

コンスタントサム: "QuestionID":{"StatementID":"number","StatementID":"number","StatementID":"number"}

コンスタントサム（合計値固定）フルフォーマット: "QuestionID":{"ChoiceID":{"Value":"number","Text":"自由回答を許可"},"ChoiceID":{"Value":"number"}}

並列表示: "QuestionID":{"ColumnID":{"StatementID":"ScaleID","StatementID":"ScaleID"},"ColumnID":{"StatementID":"ScaleID","StatementID":"ScaleID"}}

ランク順: "QuestionID":{"ChoiceID":{"Value":"RankID"},"ChoiceID":{"Value":"RankID"},"ChoiceID":{"Value":"RankID"}}

ピック、グループ化、ランク付け: "QuestionID":{"ChoiceID":{"GroupID":"Rank", "Text":"テキスト入力を許可"},"ChoiceID":{"GroupID":"Rank"}}

並列テキスト入力: "QuestionID":{"ColumnID":{"StatementID":{"ScaleID":"テキスト1"},"StatementID":{"ScaleID":"テキスト2"}},"ColumnID":{"StatementID":"ScaleID","StatementID":"ScaleID"}}

フォームフィールド: "QuestionID":{"StatementID":"Text1","StatementID":"Text1"},

スライダー: "QuestionID":{"StatementID":"ScaleID","StatementID":"ScaleID"}

スライダースケール: "QuestionID":"ChoiceID"

スライダースケール（フルフォーマット）: "QuestionID":{"Value": "ChoiceID"}

コンスタントサム: "QuestionID":{"ChoiceID": "数値", "ChoiceID": "数値"}

コンスタントサム（合計値配分）フルフォーマット: "QuestionID":{"ChoiceID":{"Text":"TextValue","Value":"Number"},"ChoiceID":{"Value":"Number"}}

例： "QID4":{"1":{"Text":"exampleText","Value":"13"},"2":{"Value":"50"}}

ホットスポット：「QuestionID」:{"SpotID":"ScaleID","SpotID":"ScaleID"}

ヒント: SpotIDは4から始まり、IDを見つけるにはエレメントを検証する必要がある場合があります。ScaleIDは、オン/オフの場合は1/2、高評価/低評価の場合は1/2/3です。

ホットスポット完全形式：「QuestionID」:{"SpotID":{"Value":"ScaleID"},"SpotID":{"Value":"ScaleID"}}

ヒント: SpotIDは4から始まり、IDを見つけるにはエレメントを検証する必要がある場合があります。ScaleIDは、オン/オフの場合は1/2、高評価/低評価の場合は1/2/3です。

ヒートマップ: "QuestionID":[{"x":number, "y":number},{"x":number, "y":number}]

ドリルダウン: "QuestionID":{"ChoiceID":"AnswerID","ChoiceID":"AnswerID"}

ドリルダウン（フルフォーマット）: "QuestionID":{"ChoiceID":{"Value":"AnswerID"},"ChoiceID":{"Value":"AnswerID"}}

ハイライト: ハイライトは、単語がステートメントで、色がスケールポイントである特殊なケースのマトリックスです。

ヒント：最初の単語は4から始まり、IDを見つけるには要素を検証する必要がある場合があります。

ファイルアップロードと署名: "QuestionID": {Size: number, Filename: 'name',FileType: 'mimetype',FileThumbnail: ,FileData: ,FileID: 'FileID',S3: true};

匿名リンクで使用し、一部回答済みのアンケートに再度アクセスした場合、Q_PopulateResponseは前回のセッションで手動入力された回答を上書きしますか？

いいえ、URLは手動で入力されていないフィールドにのみ入力します。

Q_PopulateResponseは表示ロジックとどのように連携しますか？

表示ロジックをトリガーするロジックを入力すると、質問が表示され、入力されます。Q_PopulateResponseで値が指定されていても、回答者に表示されない質問の場合、その質問の値は記録されません。あたかも実際の人間がアンケートに回答しているかのように機能します。

Q_PopulateResponseで使用できるURLの長さに制限はありますか？

上限は、ブラウザによって設定された上限です。Internet Explorerの上限が最も短く、2,000文字です。

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

この記事は役に立ちましたか

いただいたフィードバックはこのページの改善の目的のみに利用します。

素晴らしい！フィードバックありがとうございます！

フィードバックありがとうございます！