Passaggio di informazioni tramite stringhe di query

Informazioni sulle stringhe di query

Una stringa di query consente di passare informazioni da e verso un sito Web semplicemente aggiungendo o “allegando” tali informazioni alla fine di un URL. Queste informazioni vengono memorizzate nella stringa di query e acquisite dal sito Web quando legge l’URL.

I dati possono essere passati in un sondaggio utilizzando una stringa di query. Una volta passati, i dati possono essere salvati come dati incorporati con la risposta del sondaggio. Alla fine di un sondaggio, le stringhe di query possono essere utilizzate per passare i dati a un altro sito web o sondaggio.

Struttura stringa query

Struttura stringa query generale

Le stringhe di query seguono una sintassi molto specifica. Vengono aggiunti alla fine di un URL nel formato generale di ?FieldName=FieldValue. FieldName è il nome del campo dati, mentre FieldValue è il valore dati specifico del campo. Vediamo un esempio di URL con una stringa di query aggiunta. La stringa della query è in grassetto.

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

Quando un partecipante partecipa al sondaggio con il link precedente, il campo dati “Sorgente” con il valore “Facebook” verrà salvato con la risposta.

Stringhe query multiple in un URL

Le stringhe di query consentono di trasmettere più elementi di dati all’interno di un unico URL. Tuttavia, se l’URL contiene più stringhe di query, la sintassi è leggermente diversa. Vediamo un URL con più stringhe di query aggiunte. Le stringhe della query sono in grassetto.

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

La seconda stringa di query inizia con una e commerciale (&) invece di un punto interrogativo (?). Questo perché gli URL possono supportare un solo punto interrogativo. È possibile aggiungere ulteriori stringhe di query aggiungendo altri campi nel formato &FieldName=FieldValue.

Combinazione di valori stringa di query nei dati di risposta

È possibile trasferire più valori per lo stesso campo all’interno di una stringa di query. Il risultato sarà un campo combinato nei dati della risposta separato da virgole.

Ad esempio, se si passa la seguente stringa di query:

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

Il risultato sarà che il campo “Client” ha un valore di “ATT,Sprint”.

Trasmissione delle informazioni a un sondaggio

È possibile utilizzare stringhe di query per passare informazioni a un sondaggio Qualtrics. È possibile salvare queste informazioni come dati incorporati, quindi utilizzare questo campo nella diramazione e nella logica di visualizzazione insieme al salvataggio dei dati con la risposta del partecipante al sondaggio.

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

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

L’invio di informazioni a un sondaggio tramite stringhe di query richiede una configurazione in due parti. La prima parte consiste nell’aggiungere dati al tuo URL con stringhe di query, mentre la seconda parte consiste nella creazione di elementi di dati incorporati nel flusso del sondaggio per acquisire le informazioni dall’URL.

Parte 1: Aggiunta di dati all’URL di un sondaggio

1. Copia il collegamento anonimo per il tuo sondaggio e incollalo in un editor di testo, come Word o Blocco note.

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

2. Aggiungi un punto interrogativo (?)alla fine dell’URL.

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

3. Digita il nome del campo Dati incorporati (ad es., “stato” o “città”) dopo il punto interrogativo.

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

4. Aggiungi un segno di uguale (=)

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

5. Digitare il valore del campo (es. “Utah” o “Provo”)

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

6. Per eventuali campi aggiuntivi che si desidera aggiungere, ripetere i passaggi da 2 a cinque utilizzando una e commerciale (&) anziché un punto interrogativo (?).

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

Parte 2: Acquisizione di informazioni da un URL come dati incorporati

1. Durante la modifica del sondaggio, passare a Flusso del sondaggio facendo clic sull’icona del flusso del sondaggio nella barra di navigazione a sinistra.
   
2. Fai clic su Aggiungi un nuovo elemento qui.
   
3. Selezionare Dati incorporati elemento.
   
4. Inserisci il nome dei campi che desideri acquisire dall’URL. Non attribuire alcun valore a questi campi. Per questi campi, dovrebbe essere impostato il valore dal panel o dall’URL.
   
   Qtip: La capitalizzazione dei tuoi campi conta! Assicurati che i tuoi campi nel flusso del sondaggio corrispondano alle maiuscole dei campi nel tuo URL.
5. Sposta l’elemento dati incorporato nella parte superiore del flusso del sondaggio. Ciò è particolarmente importante se si desidera utilizzare i campi di dati incorporati nella logica o visualizzare i valori con testo trasferito. L’elemento dati incorporato deve apparire prima degli elementi nel flusso del sondaggio che vi fanno riferimento.
   
   Esempio: nel blocco della domanda Introduzione, vogliamo inserire il valore di “città” in un testo della domanda. Pertanto, dobbiamo spostare l’elemento dati incorporato in prima del blocco delle domande di Introduzione nel flusso del sondaggio.

Passaggio di informazioni da un sondaggio

Puoi passare le informazioni da un sondaggio a un altro sito web o da 1 sondaggio a un altro sondaggio aggiungendo informazioni all’URL di reindirizzamento. Questa operazione viene comunemente eseguita quando si lavora con un fornitore di panel di terze parti.

Per passare le informazioni di un sondaggio

1. Genera il codice di testo trasferito per ogni dato che desideri trasmettere (ad esempio, risposte alle domande del sondaggio, dati incorporati o qualsiasi altra informazione raccolta con la risposta). Copiare questi codici e salvarli per un secondo momento.
   Esempio: Vogliamo trasmettere la risposta del partecipante a due delle domande del sondaggio. Il testo trasferito per le domande del sondaggio selezionate è ${q://QID7/ChoiceGroup/SelectedChoices} e ${q://QID3/ChoiceGroup/SelectedChoices}.
2. Copiare l’URL di reindirizzamento. Questo è l’URL a cui vuoi inviare i partecipanti al sondaggio e sarà il sito web che acquisisce le informazioni.
   Esempio: Stiamo reindirizzando da un sondaggio Qualtrics a un fornitore di panel di terze parti, quindi il nostro URL è https://www.survey.panelcompany.com
3. Aggiungi un punto interrogativo (?) alla fine dell’URL.

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

4. Digitare il nome della variabile che si desidera trasmettere.

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

5. Aggiungere un segno di uguale (=) alla fine dell’URL

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

6. Incolla il codice del testo trasferito per il valore della variabile.

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

7. Ripetere i passaggi da 3 a 6 per eventuali variabili aggiuntive che si desidera trasmettere. Utilizzare una e commerciale (&) invece di un punto interrogativo (?) per variabili supplementari.

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

8. Incolla l’URL completato dal passo 7 nell’area di conclusione appropriata del sondaggio (ad esempio, l’elemento predefinito o il flusso del sondaggio).
   Qtip: hai una stringa di query che sembra non funzionare? Potrebbe dipendere dalla modalità di formattazione del testo trasferito. La procedura consigliata è quella di aggiungere “?format=urlencode’ fino alla fine dei valori di testo trasferito, prima dell’ultima parentesi. Ciò garantisce che i valori con spazi e caratteri speciali vengano riportati correttamente nella stringa di query. Ad esempio, estrarre i dati incorporati chiamati Dipartimento nella stringa di query utilizzando ${e://Field/Department?format=urlencode} invece di ${e://Field/Department}. Tuttavia, non aggiungere format=urlencode ai campi della posta elettronica. Questo convertirà il simbolo @ in %40.

Dopo aver creato il collegamento di reindirizzamento, sarà necessario assicurarsi che il sito Web di reindirizzamento possa acquisire le informazioni dalle stringhe di query. Se stai reindirizzando a un sondaggio Qualtrics, i dettagli sulla preparazione del sondaggio per acquisire le informazioni sono disponibili nella Parte 2 delle informazioni che passano nella precedente sezione del sondaggio.

Aggiunta di stringhe di query ai collegamenti inviati tramite posta elettronica

Alcuni degli editor e-mail Qualtrics contengono testo trasferito per il collegamento al sondaggio invece del collegamento stesso al sondaggio. Questo include inviti al sondaggio inviati per posta elettronica insieme al task Directory XM. È possibile aggiungere stringhe di query al testo trasferito per questi collegamenti in modo che le stringhe di query vengano aggiunte al collegamento quando l’e-mail viene inviata. Uno di questi scenari in cui ciò è utile è se stai inviando molte distribuzioni simili e vuoi tracciare quali risposte provengono da quale distribuzione. È necessario adottare ulteriori misure per assicurarti che il tuo collegamento sia costruito e il collegamento ipertestuale correttamente nelle tue e-mail Qualtrics.

1. Aprire l’editor di posta elettronica e iniziare a comporre un messaggio. Questo potrebbe essere l’editor e-mail per gli inviti al sondaggio via e-mail o l’attività Directory XM.
2. Se il tuo messaggio ha già un codice di testo trasferito per un sondaggio, elimina il codice. Il codice del testo trasferito del collegamento al sondaggio è generalmente nel formato ${l://SurveyURL}. Lo facciamo per garantire che il link che costruiamo sia privo di errori.
   
   
3. Fai clic sull’icona del testo trasferito {A} e seleziona Collegamenti al sondaggio → URL del sondaggio.
   
4. Costruisci il tuo link utilizzando le istruzioni della Parte 1 per passare le informazioni in un sondaggio. Il codice del testo trasferito inserito fungerà da URL.
   Consiglio Q: quando si creano le stringhe di query, assicurarsi di utilizzare un & per ogni stringa, poiché il collegamento del singolo sondaggio conterrà già stringhe di query.
   Esempio: Supponiamo di inviare un sondaggio a ondate e di voler tracciare il wave di cui faceva parte un partecipante. Il nostro URL nell’editor e-mail avrà il seguente aspetto: ${l://SurveyURL}&Wave=wave1
   Qtip: è anche possibile utilizzare il testo trasferito per le variabili e i valori della stringa di query. Tuttavia, per assicurarsi che i valori trasferiti siano codificati correttamente, è necessario aggiungere &format=urlencode alla fine dei valori di testo trasferito, prima dell’ultima parentesi. Ciò garantisce che i valori con spazi e caratteri speciali vengano riportati correttamente nella stringa di query. Ad esempio, è possibile estrarre i dati incorporati chiamati Dipartimento nella stringa di query utilizzando ${e://Field/Department&format=urlencode} anziché ${e://Field/Department}. Tuttavia, non aggiungere format=urlencode ai campi della posta elettronica. Questo convertirà il simbolo @ in %40. Inoltre, non aggiungere format=urlencode al testo trasferito per l’URL del sondaggio.
5. Copiare il collegamento appena creato ed evidenziarlo nell’editor messaggi.
   
6. Fare clic sul pulsante di collegamento ipertestuale.
7. Nella casella URL, incollare il collegamento copiato.
   
8. Modificare il protocollo in <other>.
9. Se lo desideri, cambia il Testo visualizzato del link, ad esempio, “Fai clic qui per partecipare al sondaggio”.
10. Fare clic su OK.

Come usare Q_EED

Q_EED può essere utilizzato come parametro URL per passare parametri di dati incorporati offuscati (o con codifica Base64). Uno dei casi di utilizzo più comuni è il trasferimento di dati JSON in formato binario tramite un URL.

Nell’esempio seguente, comunicheremo il genere e l’età di un intervistato (maschile) ed età (32) a un sondaggio Qualtrics utilizzando Q_EED aggiunto alla fine di un collegamento al sondaggio come stringa di query.

1. Aggiungi i dati incorporati Genere ed Età al Flusso del sondaggio.
2. Scrivere le informazioni da trasmettere in formato JSON. Ad esempio:

   {"Sesso":"Maschio","Età":32}

3. Ora Base64 codifica l’intero formato JSON, dalla parentesi alla parentesi. Assicurarsi di selezionare Esegui codifica sicura per gli URL durante la codifica dei dati. Una volta codificato, il JSON della fase 2 ha il seguente aspetto:

   eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==

4. Aggiungere la stringa della fase 3 come valore del campo Q_EED:

   Q_EED=eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==
   

5. Ottieni l’URL del tuo sondaggio.
6. Se l’URL ha un punto interrogativo (?) in qualsiasi punto, aggiungere una e commerciale (&) alla fine. Se non è presente alcun punto interrogativo, aggiungere un punto interrogativo (?) fino alla fine.
7. Aggiungere il risultato della fase 4 alla fine dell’URL. Ora dovrebbe avere il seguente aspetto:

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

Come utilizzare Q_PopulateResponse

Q_PopulateResponse viene utilizzato come parametro URL per precompilare le risposte del sondaggio.

I valori vengono passati attraverso l’URL come campi con formato JSON:

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

Se si desidera inserire le risposte dell’anno scorso ai sondaggi di quest’anno, è possibile caricare le risposte come dati integrati in un elenco di contatti, quindi configurare un collegamento individuale personalizzato che faccia riferimento a queste risposte. Innanzitutto, scrivi un testo cliccabile nella tua e-mail di distribuzione, poi ottieni il testo trasferito per l’URL del sondaggio, quindi utilizza il pulsante di collegamento nell’editor di contenuti avanzati per collegarti a qualcosa come questo:

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

Questo esempio fa riferimento ai campi di contatto QID1, QID2 e QID3. Assicurati di codificare le virgolette (“) con %22, ma non codificare l’intera stringa URL, poiché disabiliterà il testo trasferito.

Questo collegamento popolerà le risposte dell’anno scorso. Se la persona modifica alcune di queste risposte di default e chiude il questionario, quando rientra nel questionario, il salvataggio più recente sostituisce gli stati dell’URL da alimentare. Inoltre, se c’è una logica di visualizzazione su una domanda, la compilerà, ma non sarà registrata a meno che la persona non scelga la logica corretta che mostrerebbe quella domanda.

Casi comuni

Di seguito sono riportati alcuni casi di utilizzo comuni di Qualtrics che utilizzano stringhe di query. Visitare le pagine collegate per ulteriori informazioni.

• Rileva dati in un secondo sondaggio (sondaggi longitudinali)
• Integrazione con una società di panel
• Creazione di un link di ripresa

Tipi di progetti con cui è possibile utilizzare le stringhe di query

Le stringhe di query possono essere utilizzate con qualsiasi tipo di progetto con un collegamento. Ciò include:

• Progetti di sondaggio
• Coinvolgimento
• 360
• Ciclo di vita
• Ricerca dipendente ad hoc
• Sondaggio d’opinione
• Soluzioni XM
• Analisi congiunte
• MaxDiff

FAQ