Übergabe von Informationen über Query-Strings (2023)

Query-Strings im Überblick

Mit Query-Strings können Sie Informationen an und von Websites übergeben, indem Sie diese Informationen einfach am Ende einer URL hinzufügen bzw. „anhängen“. Diese Informationen sind im Query-String gespeichert und werden von der Website erfasst, wenn die URL gelesen wird.

Daten können über einen Query-String an eine Umfrage übergeben werden. Nach der Übergabe können die Daten alseingebettete Datenmit der Umfrageantwort gesichert werden. Am Ende einer Umfrage können Query-Strings dazu verwendet werden, Daten an eine andere Website oder Umfrage zu übergeben.

Aufbau von Query-Strings

Allgemeiner Aufbau von Query-Strings

Query-Strings haben eine sehr spezifische Syntax. Sie werden am Ende einer URL im allgemeinen Format vonhinzugefügt.FieldName=FieldValue. „FieldName“ ist der Name des Datenfelds und „FieldValue“ der spezifische Datenwert des Felds. Nachstehend ist eine Beispiel-URL aufgeführt, an die ein Query-String angehängt ist. Der Query-String ist fett formatiert.

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

Wenn ein Teilnehmer die Umfrage über den obigen Link aufruft, wird das Datenfeld „Source“ mit dem Wert „Facebook“ mit der Antwort gespeichert.

Mehrere Query-Strings in einer URL

Mit Abfragezeichenfolgen können Sie mehrere Daten innerhalb einer einzigen URL übergeben. Bei einer URL mit mehreren Query-Strings sieht die Syntax jedoch ein wenig anders aus. Nachstehend ist eine URL aufgeführt, an die mehrere Query-Strings angehängt sind. Die Query-Strings sind fett formatiert.

https://survey.qualtrics.com/jfe/form/SV_123456789?Quelle = Facebook&Kampagne=Mobile

Der zweite Query-String beginnt mit einem kaufmännischen Und-Zeichen (&) anstelle eines Fragezeichens (?). Der Grund hierfür ist, dass URLs nur ein Fragezeichen unterstützen. Zusätzliche Abfragezeichenfolgen können angehängt werden, indem weitere Felder im Format&FieldName=Feldwerthinzugefügt werden.

Achtung:Während es keine Qualtrics-Grenze für die Datenmenge gibt, die Sie über Abfragezeichenfolgen übergeben können, gelten für Webbrowser keine Längenbeschränkungen für URL-Zeichen. Diese Grenzwerte variieren je nach Browser. Wir empfehlen, URLs auf eine Länge von weniger als 2.000Zeichen zu beschränken. Informationen zu den Grenzwerten eines bestimmten Browsers finden Sie in der Hilfedokumentation des jeweiligen Browsers.

Kombinieren von Query-String-Werten in Antwortdaten

Sie können in einem Query-String mehrere Werte für dasselbe Feld übergeben. Das Ergebnis ist ein kombiniertes Feld in IhrenAntwortdaten, das durch Kommas getrennt ist.

Beispiel: Sie übergeben den folgenden Query-String:

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

Ergebnis: Das Feld „Client“ enthält den Wert „ATT,Sprint“.

Übergeben von Informationen an eine Umfrage

Sie können Query-Strings verwenden, um Informationen an eine Qualtrics-Umfrage zu übergeben. Sie können diese Informationen alseingebettete Datenspeichern und dann dieses Feld inVerzweigungs-undAnzeigelogikzusammen mit der Speicherung der Daten mit der Antwort des Umfrageteilnehmers verwenden.

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

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

Die Übergabe von Informationen an eine Umfrage über Abfragezeichenfolgen erfordert ein zweiteiliges Setup. Der erste Teil besteht darin, Daten mit Query-Strings an eine URL anzuhängen. Im zweiten Teil müssen eingebettete Datenelemente im Umfragenverlauf erstellt werden, damit die Informationen aus der URL erfasst werden.

Teil 1: Daten an eine Umfrage-URL anhängen

1. Kopieren Sie denanonymen Linkfür Ihre Umfrage, und fügen Sie ihn in einen Texteditor wie Word oder Notepad ein.

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

2. Fragezeichen hinzufügen (?)an das Ende der URL.

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

3. Geben Sie nach dem Fragezeichen den Namen des eingebetteten Datenfelds (z.B. „state“ oder „city“) ein.

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

4. Gleichheitszeichen (=) hinzufügen

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

5. Geben Sie den Wert des Felds ein (z.B. „Utah“ oder „Provo“).

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

6. Wiederholen Sie für alle zusätzlichen Felder, die Sie hinzufügen möchten, die Schritte 2 bis 5, indem Sie ein kaufmännisches Und (&) anstelle eines Fragezeichens (?) verwenden.

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

Teil 2: Informationen aus einer URL als eingebettete Daten erfassen

1. Navigieren Sie beim Bearbeiten Ihrer Umfrage zuUmfragenverlaufindem Sie auf das Umfragenverlaufssymbol in der linken Navigationsleiste klicken.
   
2. Klicken Sie aufNeues Element hier hinzufügen.
   
3. Wählen Sie die RegisterkarteEingebettete DatenElement.
   
4. Geben Sie den Namen aller Felder ein, die Sie aus der URL erfassen möchten.Ordnen Sie diesen Feldern keinenWert zu. Für diese Felder sollte derWert aus dem Panel oder der URL festgelegt werden.
   

   Tipp:Die Groß- und Kleinschreibung Ihrer Felder ist wichtig! Stellen Sie sicher, dass die Felder im Umfragenverlauf mit der Groß- und Kleinschreibung der Felder in der URL übereinstimmen.

5. Verschieben Siedas eingebettete Datenelement an den Anfang Ihres Umfragenverlaufs. Dies ist besonders wichtig, wenn Sie die eingebetteten Datenfelder in Logik verwenden oder die Werte mit dynamischem Text anzeigen möchten. Das eingebettete Datenelementmussvor den Elementen im Umfragenverlauf angezeigt werden, die es referenzieren.
   

   Beispiel:Im Fragenblock Einführung möchten wir den Wert für „city“ in einen Fragetext einfügen. Daher muss das eingebettete Datenelement vor den Fragenblock „Introduction“ im Umfragenverlauf verschoben werden.

Übergeben von Informationen aus einer Umfrage

Sie können Informationen aus einer Umfrage an eine andere Website oder von einer Umfrage an eine andere Umfrage weiterleiten, indem Sie Informationen an dieUmleitungs-URLanhängen. Dies geschieht in der Regel, wenn Sie mit einemDrittanbieter von Panels.

So übergeben Sie Informationen aus einer Umfrage

1. Generieren Sie denPiped-Text-Codefür jeden Teil der Daten, den Sie übergeben möchten (z. B. Antworten auf Fragen der Umfrage, eingebettete Daten oder andere Informationen, die mit der Antwort gesammelt wurden). Kopieren Sie diese Codes und speichern Sie sie für später.

   Beispiel:Wir möchten die Antwort des Teilnehmers auf zwei unserer Umfragefragen weitergeben. Der dynamische Text für unsere ausgewählten Umfragefragen lautet ${q://QID7/ChoiceGroup/SelectedChoices} und ${q://QID3/ChoiceGroup/SelectedChoices}.

2. Kopieren Sie die Umleitungs-URL. Dies ist die URL, zu der Sie die Umfrageteilnehmer lenken möchten, und die Website, auf der die Informationen erfasst werden.

   Beispiel:Wir leiten von einer Qualtrics-Umfrage zu einem Drittanbieter-Panel-Anbieter um, daher lautet unsere URLhttps://www.survey.panelcompany.com.

3. Fragezeichen hinzufügen (?) an das Ende der URL.

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

4. Geben Sie den Namen der Variablen ein, die Sie übergeben möchten.

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

5. Fügen Sie am Ende der URL ein Gleichheitszeichen (=) hinzu.

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

6. Fügen Sie den Code für dynamischen Text für den Wert der Variablen ein.

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

7. Wiederholen Sie die Schritte3 bis6 für alle weiteren Variablen, die Sie übergeben möchten. Verwenden Sie ein kaufmännisches Und (&) anstelle eines Fragezeichens (?) für zusätzliche Variablen.

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

8. Fügen Sie die ausgefüllte URL aus Schritt 7 in den entsprechenden Beendigungsbereich der Umfrage ein (z. B.Standard-oderUmfragenverlaufselement).

   Tipp:Haben Sie einen Query-String, der scheinbar nicht funktioniert? Möglicherweise hängt dies mit der Formatierung des dynamischen Texts zusammen. Eine bewährte Vorgehensweise besteht darin, den Code „?format=urlencode“ am Ende der dynamischen Textwerte vor der letzten Klammer hinzuzufügen. Hierdurch wird sichergestellt, dass Werte mit Leer- und Sonderzeichen ordnungsgemäß in den Query-String übertragen werden. Ziehen Sie beispielsweise eingebettete Daten namens Abteilung mithilfe von ${e://Feld/Abteilung? in Ihre Abfragezeichenfolge.format=urlencode} statt ${e://Field/Department}. Fügen Sie „format=urlencode“ jedoch nicht E-Mail-Feldern hinzu. Hierdurch wird das Symbol „@“ in „%40“ konvertiert.

Nachdem Sie den Umleitungs-Link erstellt haben, müssen Sie sicherstellen, dass die Informationen aus den Query-Strings von der Umleitungs-Website erfasst werden können. Wenn Sie zu einer Qualtrics-Umfrage umleiten, finden Sie Details zur Vorbereitung Ihrer Umfrage zur Erfassung der Informationen in Teil 2 des Abschnitts zumÜbergeben von Informationen an eine Umfrageoben.

Hinzufügen von Query-Strings zu per E-Mail versendeten Links

Einige der Qualtrics-E-Mail-Editoren enthalten für Umfrage-Links dynamischen Text anstelle des eigentlichen Umfrage-Links. Dazu gehörenE-Mail-Umfrageeinladungenzusammen mit derXM-Directory-Aufgabe. Sie können dem dynamischen Text für diese Links Query-Strings hinzufügen, damit die Query-Strings an den Link angehängt werden, wenn die E-Mail gesendet wird. Dies ist z.B. nützlich, wenn Sie viele ähnliche Verteilungen senden und nachverfolgen möchten, welche Antworten aus welcher Verteilung stammen. Sie müssen zusätzliche Schritte ausführen, um sicherzustellen, dass Links in Qualtrics-E-Mails richtig erstellt und verknüpft werden.

1. Öffnen Sie den E-Mail-Editor und beginnen Sie mit dem Verfassen einer Nachricht. Dies kann der E-Mail-Editor fürE-Mail-Umfrageeinladungenoder dieXM Directory-Aufgabesein.
2. Wenn Ihre Nachricht bereits Code für dynamischen Text für eine Umfrage enthält, löschen Sie den Code. Der Piped-Text-Code des Umfragelinks hat im Allgemeinen das Format${l://SurveyURL}.Damit stellen wir sicher, dass der von uns erstellte Link fehlerfrei ist.
   
   
3. Klicken Sie auf das Piped-Symbol {A}, und wählen SieUmfragelinks → Umfrage-URL.
   
4. Erstellen Sie Ihren Link mithilfe der Anweisungen aus Teil 1 zumÜbergeben von Informationen an eine Umfrage. Der eingefügte Code für dynamischen Text fungiert als URL.

   Beispiel:Angenommen, wir senden eine Umfrage in Wellen und möchten nachverfolgen, zu welcher Welle ein Teilnehmer gehört hat. Unsere URL im E-Mail-Editor sieht wie folgt aus:${l://SurveyURL}?Welle = Wellen1

   Tipp:Sie können auch dynamischen Text für Ihre Query-String-Variablen und -Werte verwenden. Um sicherzustellen, dass die dynamischen Werte ordnungsgemäß codiert werden, müssen Sie jedoch den Code „?format=urlencode“ am Ende der dynamischen Textwerte vor der letzten Klammer hinzuzufügen. Hierdurch wird sichergestellt, dass Werte mit Leer- und Sonderzeichen ordnungsgemäß in den Query-String übertragen werden. Ziehen Sie beispielsweise eingebettete Daten namens Abteilung mithilfe von ${e://Feld/Abteilung? in Ihre Abfragezeichenfolge.format=urlencode} statt ${e://Field/Department}. Fügen Sie „format=urlencode“ jedoch nicht E-Mail-Feldern hinzu. Hierdurch wird das Symbol „@“ in „%40“ konvertiert. Fügen Sie „format=urlencode“ außerdem nicht dem dynamischen Text für die Umfrage-URL hinzu.

5. Kopieren Sie den neu erstellten Link und heben Sie den Link im Nachrichteneditor hervor.
   
6. Klicken Sie auf die Hyperlink-Schaltfläche.
7. Fügen Sie den kopierten Link in das Feld „URL“ ein.
   
8. Ändern Sie das Protokoll in.
9. Ändern Sie bei Bedarf denAnzeigetextdes Links, z. B. „Klicken Sie hier, um an der Umfrage teilzunehmen“.
10. Klicken Sie aufOK.

Verwendung von Q_EED

Q_EED kann als URL-Parameter dazu verwendet werden, unkenntlich gemachte (oder Base64-kodierte) eingebettete Datenparameter zu übergeben. Einer der häufigsten Anwendungsfälle ist die Übergabe von JSON-Daten in einem binären Format über eine URL.

Im folgenden Beispiel werden wir das Geschlecht (Male) und das Alter (32) eines Teilnehmers an eine Qualtrics-Umfrage übergeben, indem wir Q_EED als Query-String an das Ende eines Umfrage-Links anhängen.

1. Fügen Sie die eingebetteten DatenGeschlechtundÄndernzu Ihrem Umfragenverlauf hinzu.
2. Schreiben Sie die Informationen, die Sie übergeben möchten, im JSON-Format aus. Zum Beispiel:

   {"Geschlecht":"Männlich","Alter":32}

3. Base64 kodiertnun das gesamte JSON-Format von der Klammer bis zur Klammer. Nach der Kodierung sieht der JSON-String aus Schritt2 wie folgt aus:

   eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==

4. Fügen Sie den String aus Schritt 3 als Wert des Feldes Q_EED hinzu:

   Q_EED=eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==

5. Rufen Sie Ihre Umfrage-URL ab.
6. Wenn die URL an einer beliebigen Stelle ein Fragezeichen (?) enthält, fügen Sie ein kaufmännisches Und-Zeichen (&) am Ende hinzu. Wenn kein Fragezeichen vorhanden ist, fügen Sie ein Fragezeichen (?) am Ende hinzu.
7. Fügen Sie das Ergebnis von Schritt 4 am Ende Ihrer URL hinzu. Die URL sollte jetzt so aussehen:

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

Tipp:Ändern Sie nicht die Schreibweise, Interpunktion oder Berücksichtigung der Groß-/Kleinschreibung Ihrer Variablen. Wenn im Umfragenverlauf „Gender“ steht, muss das G immer großgeschrieben werden, damit diese Information erfolgreich kodiert und dann übertragen wird.

Warnung:Aus Sicherheitsgründen dürfen kodierte Zeichenfolgen keine Pluszeichen (+) enthalten, oder die eingebetteten Daten werden nicht aufgezeichnet. Verwenden Sie stattdessen Bindestriche (–).

Verwendung von Q_PopulateResponse

Q_PopulateResponse wird als URL-Parameter zur Vorausfüllung von Umfrageantworten verwendet.

Werte werden über die URL als Felder im JSON-Format übergegeben:

Ihre SurveyURL?Q_PopulateResponse={"QID1":"6","QID2":"4","QID3":"das ist mein Text","QID4":"1"}

Wenn Sie die Antworten des letzten Jahres in die Umfragen dieses Jahres einfügen möchten, können Sie die Antworten als eingebettete Daten in eineKontaktlistehochladen und dann einen benutzerdefinierten individuellen Link einrichten, der diese Antworten referenziert. Schreiben Sie zunächst einen anklickbaren Text in IhreVerteilungs-E-Mail,rufen Sie dann den dynamischen Textfür die Umfrage-URL ab, und verwenden Sie dann dieLink-Schaltfläche im Rich-Content-Editor, um einen Link wie den folgenden zu verwenden:

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

In diesem Beispiel werden die KontaktfelderQID1,QID2undQID3referenziert. Stellen Sie sicher, dass Sie die Anführungszeichen (“) mit %22 kodieren, abernichtdie gesamte URL-Zeichenfolge, da dadurch der dynamische Text deaktiviert wird.

Über diesen Link werden die Antworten aus dem letzten Jahr eingefügt. Wenn ein Umfrageteilnehmer einige dieser Standardantworten ändert und anschließend die Umfrage beendet, werden beim erneuten Aufrufen der Umfrage die Inhalte, die gemäß der URL eingetragen werden sollten, durch die zuletzt gespeicherten Inhalte überschrieben. Beachten Sie auch Folgendes: Wenn in einer Frage eine Anzeigelogik verfügbar ist, wird diese Frage eingetragen; die Frage wird jedoch erst aufgezeichnet, wenn der Umfrageteilnehmer die Logik wählt, durch die die entsprechende Frage angezeigt wird.

Tipp: Hilfe zurJSON-Formatierung finden Sie in den FAQs unten auf der Seite.

Gängige Anwendungsbeispiele

Nachfolgend sind einige häufige Qualtrics-Anwendungsfälle aufgeführt, in denen Query-Strings verwendet werden. Besuchen Sie die verknüpften Seiten, um weitere Informationen zu erhalten.

• Abrufen von Daten in eine zweite Umfrage (Längsschnittumfragen)
• Integration mit Stichproben-Anbietern
• Erstellen eines Links zum Wiederholen einer Umfrage