Übergabe von Informationen über Query-Strings

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 als eingebettete Daten mit 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 ?FieldName=FieldValue hinzugefügt. „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?Source=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=Mobil

Der zweite Abfragestring beginnt mit einem kaufmännischen Und (&) 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=FieldValue hinzugefügt werden.

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 Ihren Antwortdaten, 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 als eingebettete Daten sichern und dieses Feld dann in der Verzweigungs- und Anzeigelogik zusammen mit dem Sichern der Daten mit der Antwort des Umfrageteilnehmers verwenden.

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

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

Die Übergabe von Informationen an eine Umfrage über Query-Strings muss in zwei Teilen konfiguriert werden. 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 den anonymen Link für Ihre Umfrage, und fügen Sie ihn in einen Texteditor ein, z. B. Word oder Notepad.

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

2. Fügen Sie ein Fragezeichen (?) am Ende der URL hinzu.

   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?city

4. Fügen Sie ein Gleichheitszeichen (=)
   hinzu.

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

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 die Schritte 2 bis fünf für alle zusätzlichen Felder, die Sie hinzufügen möchten, 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 zu Umfragenverlauf indem Sie auf das Umfragenverlaufssymbol in der linken Navigationsleiste klicken.
   
2. Klicken Sie auf Neues Element hier hinzufügen.
   
3. Wählen Sie die Registerkarte Eingebettete Daten Element.
   
4. Geben Sie den Namen aller Felder ein, die Sie aus der URL erfassen möchten. Ordnen Sie diesen Feldern keinen Wert zu. Für diese Felder sollte Wert wird aus Panel oder URL gesetzt lauten.
   
   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 Sie das 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 Datenelement muss vor den Elementen im Umfragenverlauf erscheinen, 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 von einer Umfrage an eine andere Website oder von einer Umfrage an eine andere Umfrage übergeben, indem Sie Informationen an die Umleitungs-URL anhängen. Dies geschieht in der Regel, wenn Sie mit einem Drittanbieter von Panels.

So übergeben Sie Informationen aus einer Umfrage

1. Generieren Sie den dynamischen Textcode fü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 URL https://www.survey.panelcompany.com.
3. Fügen Sie am Ende der URL ein Fragezeichen (?) hinzu.

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

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

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

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 Schritte 3 bis 6 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- oder Umfragenverlaufselement).
   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 zum Beispiel eingebettete Daten namens Abteilung in Ihren Abfrage-String, indem Sie ${e://Field/Department?format=urlencode} anstelle von ${e://Field/Department} verwenden. 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 Informationen in eine Umfrage weiterleiten oben.

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ören E-Mail-Umfrageeinladungen zusammen mit der XM-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ür E-Mail-Umfrageeinladungen oder die XM-Directory-Aufgabe sein.
2. Wenn Ihre Nachricht bereits Code für dynamischen Text für eine Umfrage enthält, löschen Sie den Code. Der dynamische Textcode 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 dynamische Textsymbol {A}, und wählen Sie Umfragelinks → Umfrage-URL.
   
4. Erstellen Sie Ihren Link mithilfe der Anweisungen aus Teil 1 von Informationen in eine Umfrage weiterleiten. Der eingefügte Code für dynamischen Text fungiert als URL.
   Tipp: Stellen Sie beim Erstellen Ihrer Abfragezeichenfolgen sicher, dass Sie für jede Zeichenfolge & verwenden, da der einzelne Umfragelink bereits Abfragezeichenfolgen enthält.
   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}&Wave=wave1
   Tipp: Sie können auch dynamischen Text für Ihre Query-String-Variablen und -Werte verwenden. Um sicherzustellen, dass Ihre dynamischen Werte korrekt kodiert sind, müssen Sie &format=urlencode am Ende der dynamischen Textwerte vor der letzten Klammer hinzufügen. Hierdurch wird sichergestellt, dass Werte mit Leer- und Sonderzeichen ordnungsgemäß in den Query-String übertragen werden. Ziehen Sie beispielsweise eingebettete Daten mit dem Namen Abteilung in Ihre Abfragezeichenfolge, indem Sie ${e://Field/Department&format=urlencode} anstelle von ${e://Field/Department} verwenden. 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 <other>.
9. Ändern Sie ggf. den Anzeigetext des Links, z. B. in „Zur Teilnahme an der Umfrage hier klicken“.
10. Klicken Sie auf OK.

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 Daten Geschlecht und Alter zu 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 kodiert nun das gesamte JSON-Format von der Klammer bis zur Klammer. Stellen Sie sicher, dass Sie URL-sichere Kodierung durchführen markieren, wenn Sie Ihre Daten kodieren. Nach der Kodierung sieht der JSON-String aus Schritt 2 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 ein Fragezeichen (?) enthält Fügen Sie an einer beliebigen Stelle ein kaufmännisches Und (&) 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==

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":"this is my text","QID4":"1"}

Wenn Sie die Antworten des letzten Jahres in die diesjährigen Umfragen einfügen möchten, können Sie die Antworten als eingebettete Daten in eine Kontaktliste hochladen und dann einen benutzerdefinierten individuellen Link einrichten, der auf diese Antworten verweist. Schreiben Sie zunächst anklickbaren Text in Ihre Verteilungs-E-Mail, rufen Sie dann den dynamischen Text für die Umfrage-URL ab, und verwenden Sie dann die Linkschaltfläche im Rich-Content-Editor, um einen Link wie den folgenden zu erstellen:

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

Dieses Beispiel verweist auf die Kontaktfelder QID1, QID2 und QID3. Stellen Sie sicher, dass Sie die Anführungszeichen (“) mit %22 kodieren, aber nicht die 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.

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

Arten von Projekten, mit denen Sie Abfragezeichenfolgen verwenden können

Abfragezeichenfolgen können mit allen Projekttypen verwendet werden, die eine Verknüpfung haben. Dazu gehören:

• Umfrageprojekte
• Engagement
• 360
• Lebenszyklus
• Ad-hoc-Mitarbeiterforschung
• Puls
• XM-Lösungen
• Conjoints
• MaxDiff

Häufig gestellte Fragen