Qualtrics Platform
Customer Journey Optimizer
XM Discover
Qualtrics Social Connect

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.

Attenzione: sebbene non vi sia alcun limite Qualtrics alla quantità di dati che puoi trasferire tramite stringhe di query, i browser Web non hanno limiti di lunghezza dei caratteri dell’URL. Questi limiti variano in base al browser. Si consiglia di provare a mantenere gli URL al di sotto di 2.000 caratteri. Per informazioni sui limiti di uno specifico browser, consultare la documentazione di supporto del browser.

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.

Esempio: è possibile utilizzare una stringa di query per tracciare da quale fonte un partecipante sta accedendo a un sondaggio. Supponiamo che tu stia eseguendo un sondaggio su più siti di social media. Se si desidera tracciare quali partecipanti provengono da Facebook e quali da LinkedIn, è possibile creare 2 collegamenti personalizzati (stringhe di query in grassetto).

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

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

Queste stringhe di query salveranno 2 valori diversi per il campo “Origine”. Questi valori sono “Facebook” e “LinkedIn”. Puoi quindi utilizzare questi dati nel tuo rapporto, convogliarli in domande da visualizzare per i partecipanti e basare la diramazione e la logica di visualizzazione su di esso per mostrare o nascondere le domande rilevanti.

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

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
```
Aggiungi un punto interrogativo (?)alla fine dell’URL.
```
https://survey.qualtrics.com/jfe/form/SV_123456789?
```
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à
```

Aggiungi un segno di uguale (=)

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

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

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

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

Durante la modifica del sondaggio, passare a Flusso del sondaggio facendo clic sull’icona del flusso del sondaggio nella barra di navigazione a sinistra.
Fai clic su Aggiungi un nuovo elemento qui.
Selezionare Dati incorporati elemento.
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.
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.

Attenzione: la destinazione di reindirizzamento deve essere configurata per accettare le informazioni trasferite nell’URL. In caso contrario, le informazioni trasferite non verranno acquisite. Vedere il passaggio di informazioni in un sondaggio sopra per imparare a configurare un sondaggio per accettare le informazioni trasmesse nell’URL.

Per passare le informazioni di un sondaggio

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}.
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
Aggiungi un punto interrogativo (?) alla fine dell’URL.
```
https://www.survey.panelcompany.com?
```
Digitare il nome della variabile che si desidera trasmettere.
```
https://www.survey.panelcompany.com?Q7Answer
```
Aggiungere un segno di uguale (=) alla fine dell’URL
```
https://www.survey.panelcompany.com?Q7Risposta=
```

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

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

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}.
```
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.

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.
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.
Fai clic sull’icona del testo trasferito {A} e seleziona Collegamenti al sondaggio → URL del sondaggio.
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.
Copiare il collegamento appena creato ed evidenziarlo nell’editor messaggi.
Fare clic sul pulsante di collegamento ipertestuale.
Nella casella URL, incollare il collegamento copiato.
Modificare il protocollo in <other>.
Se lo desideri, cambia il Testo visualizzato del link, ad esempio, “Fai clic qui per partecipare al sondaggio”.
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.

Aggiungi i dati incorporati Genere ed Età al Flusso del sondaggio.
Scrivere le informazioni da trasmettere in formato JSON. Ad esempio:
```
{"Sesso":"Maschio","Età":32}
```
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==
```
Aggiungere la stringa della fase 3 come valore del campo Q_EED:
```
Q_EED=eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==
```
Ottieni l’URL del tuo sondaggio.
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.
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==
```

Qtip: Non variare l’ortografia, la punteggiatura o la distinzione tra maiuscole e minuscole delle tue variabili. Se il flusso del sondaggio dice “Sesso”, la lettera G deve sempre essere maiuscola per codificare correttamente e quindi riportare queste informazioni.

Avviso: per motivi di sicurezza, le stringhe codificate non possono contenere segni più ( + ) o i dati incorporati non verranno registrati. Utilizzare invece i trattini ( – ).

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.

Qtip: vedere le domande frequenti in fondo alla pagina per assistenza nella formattazione JSON.

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.

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:

Consiglio Q: Questa pagina di supporto è stata scritta pensando ai progetti di sondaggio. Non tutti i casi di utilizzo discussi in questa pagina sono rilevanti per ogni tipo di progetto.

FAQ

Molte delle pagine di questo sito sono state tradotte dall'originale in inglese mediante traduzione automatica. Sebbene in Qualtrics abbiamo profuso il massimo impegno per avere le migliori traduzioni automatiche possibili, queste non sono mai perfette. Il testo originale inglese è considerato la versione ufficiale, e qualsiasi discrepanza tra questo e le traduzioni automatiche non è legalmente vincolante.