Passaggio di informazioni tramite stringa query
Cosa puoi trovare in questa pagina
Informazioni sulle stringhe query
Una stringa query consente di passare informazioni a e da un sito web semplicemente aggiungendo, o "aggiungendo", tali informazioni alla fine di un URL. Queste informazioni sono memorizzate nella stringa query e vengono acquisite dal sito web quando legge l'URL.
I dati possono essere inseriti in un sondaggio tramite una stringa query. Una volta superati, i dati possono essere salvati come dati integrati con la risposta al sondaggio. Al termine di un sondaggio, le stringhe query possono essere utilizzate per passare i dati a un altro sito web o sondaggio.
Struttura della Stringa query
Struttura generale della stringa query
Le stringhe query seguono una sintassi molto specifica. Vengono aggiunti alla fine di un URL nel formato generale di ?FieldName=FieldValue. NOME CAMPO è il nome del campo dati, mentre VALORE CAMPO è il valore specifico del campo dati. Vediamo un esempio di URL con una stringa query aggiunta. La stringa query è in grassetto.
https://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=Facebook
Quando un rispondente effettua il collegamento al sondaggio con il link di cui sopra, il campo dati "Origine" con il valore "Facebook" verrà salvato con la risposta.
Stringhe query multiple in un unico URL
Le stringhe query consentono di passare più dati all'interno di un singolo URL. Tuttavia, quando l'URL contiene più stringhe query, la sintassi è leggermente diversa. Vediamo un URL con più stringhe query aggiunte. Le stringhe query sono in grassetto.
https://survey.qualtrics.com/jfe/form/SV_123456789?Source=Facebook&Campagna=Mobile
La seconda stringa query inizia con un ampersand (&) invece che con un punto interrogativo (?). Questo perché gli URL possono supportare un solo punto interrogativo. È possibile aggiungere ulteriori stringhe query aggiungendo altri campi nel formato &FieldName=FieldValue.
Attenzione: Sebbene non vi sia alcun limite di Qualtrics alla quantità di dati che è possibile trasmettere tramite le stringhe query, i browser web hanno limiti di lunghezza dei caratteri degli URL. Questi limiti variano a seconda del browser. Si consiglia di mantenere gli URL al di sotto dei 2.000 caratteri. Per informazioni sui limiti di un browser specifico, consultare la documentazione della guida del browser.
Combinazione dei valori della stringa query nei dati delle risposte
È possibile passare più valori per lo stesso campo all'interno di una stringa query. Il risultato sarà un campo combinato nei dati di risposta, separato da virgole.
Ad esempio, se si passa la seguente stringa query:
https://survey.qualtrics.com/jfe/form/SV_9GfoihavJJR5R7U?Client=ATT&Client=Sprint
Il risultato sarà che il campo “Cliente” avrà come valore “ATT,Sprint”.
Passaggio di informazioni in un sondaggio
È possibile utilizzare stringhe query per passare informazioni in un sondaggio di Qualtrics. È possibile salvare queste informazioni come dati integrati e quindi utilizzare questo campo nella logica di diramazione e di visualizzazione, oltre a salvare i dati con la risposta del partecipante al sondaggio.
Esempio: È possibile utilizzare una stringa query per individuare da quale fonte un partecipante accede a un sondaggio. Supponiamo che stiate conducendo un sondaggio su più siti di social media. Se si desidera monitorare quali partecipanti provengono da Facebook e quali da LinkedIn, si possono creare 2 link personalizzati (stringa query in grassetto).
https://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=Facebookhttps://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=LinkedInQueste stringhe query salveranno 2 valori diversi per il campo "Sorgente". Questi valori sono "Facebook" e "LinkedIn". È quindi possibile utilizzare questi dati nei rapporti, inserirli nelle domande da visualizzare per i rispondenti e basarsi sulla logicadi diramazione e visualizzazione per mostrare o nascondere le domande pertinenti.
Suggerimento: se stai utilizzando un campo dati incorporato all'interno di una stringa query in un collegamento al sondaggio, ma hai dimenticato di aggiungere il campo come campo dati incorporato nel flusso del sondaggio, puoi comunque accedere ai valori del campo nei tuoi dati. Aggiungi il campo al flusso del sondaggio e i valori corrispondenti verranno aggiunti retroattivamente ai dati delle risposte relative alle risposte che hanno utilizzato il link.
Il passaggio di informazioni in un sondaggio tramite stringhe query richiede una configurazione in due parti. La prima parte consiste nell'aggiungere dati all'URL con stringhe query, mentre la seconda consiste nel creare elementi di dati integrati nel flusso del sondaggio per catturare le informazioni dall'URL.
Parte 1: Aggiunta di dati a un URL di sondaggio
Parte 2: Acquisizione di informazioni da un URL come dati integrati
Attenzione: i valori dei dati integrati nella stringa query verranno sempre salvati all'inizio del sondaggio. Ciò vale anche se il valore dei dati integrati viene richiamato più avanti nel flusso del sondaggio.
Passaggio di informazioni da un sondaggio
È possibile trasferire le informazioni da un sondaggio a un altro sito web o da un sondaggio a un altro sondaggio aggiungendo tali informazioni all'URL di reindirizzamento. Si tratta di una pratica comune quando si lavora con un fornitore di pannelli di terze parti.
Attenzione: La destinazione del reindirizzamento deve essere configurata in modo da accettare le informazioni passate nell'URL. In caso contrario, le informazioni passate non verranno acquisite. Vedere Passaggio di informazioni in un sondaggio sopra per imparare a configurare un sondaggio per accettare le informazioni passate nell'URL.
Per trasmettere le informazioni di un sondaggio
Dopo aver creato il link di reindirizzamento, è necessario assicurarsi che il sito web di reindirizzamento sia in grado di acquisire le informazioni dalle stringhe query. Se si sta reindirizzando a un sondaggio di QUALTRICS, i dettagli sulla preparazione del sondaggio per catturare le informazioni si trovano nella Parte 2 della sezione Passaggio di informazioni in un sondaggio, qui sopra.
Aggiunta di stringhe query ai link inviati via e-mail
Alcuni editor di Qualtrics contengono testo trasferito per il link al sondaggio invece del link stesso. Ciò include gli inviti ai sondaggi inviati via e-mail , insieme all'attività e-mail "Invia sondaggio via e-mail". È possibile aggiungere stringhe di query al testo trasferito per questi collegamenti, in modo che le stringhe di query vengano aggiunte al collegamento durante l'invio dell'e-mail. Uno scenario utile è quello in cui si inviano molte distribuzioni simili e si vuole tracciare quali risposte provengono da quale distribuzione. È necessario adottare ulteriori misure per assicurarsi che il link sia creato e collegato correttamente nelle e-mail di Qualtrics.
Avviso: le stringhe query potrebbero non funzionare in modo coerente se si codifica o si aggiunge codice HTML alle e-mail prima di distribuire il sondaggio.
Codifica degli URL per le stringhe query
Consiglio Q: questa soluzione funziona solo per i flussi di lavoro che iniziano con un evento di risposta al sondaggio. Ad esempio, se si utilizza la risposta a un sondaggio per attivare un'attività e-mail.
Esiste una stringa query che non sembra funzionare? Potrebbe dipendere dalla formattazione del testo trasferito. Gli URL non sono sempre in grado di leggere i caratteri speciali, come gli spazi e i simboli, quindi è necessario assicurarsi che l'URL capisca come elaborare tali caratteri codificandoli.
La pratica consigliata consiste nell 'aggiungere “?format=urlencode” alla fine dei valori di testo trasferiti, prima dell'ultima parentesi. Questo assicura che i valori con spazi e caratteri speciali vengano riportati correttamente nella stringa query.
Esempio: Per inserire i dati integrati chiamati Dipartimento nella stringa query, utilizzare ${e://Field/Department?format=urlencode} invece di ${e://Field/Department}.
Attenzione:Non aggiungere ?format=urlencode ai campi E-mail. Questo convertirà il simbolo @ in %40.
Attenzione:Non aggiungere ?format=urlencode al testo trasferito per l'URL del sondaggio. Aggiungerlo invece a un URL completo del sondaggio che abbia un testo trasferito nella stringa query. Un esempio di uso corretto sarebbe https://qunivocalize.co1.qualtrics.com/jfe/form/SV_xxxxxxx?Department=${e://Field/Department?format=urlencode}&Office=${e://Field/Office?format=urlencode}
Utilizzare solo un punto interrogativo prima della formattazione della codifica URL. Non utilizzare la virgola ( & ) o qualsiasi altro carattere.
Come utilizzare Q_EED
Q_EED può essere usato come parametro URL per passare parametri dati integrati offuscati (o codificati Base64URL). Uno dei casi d'uso più comuni è quello di passare dati JSON in formato binario attraverso un URL.
Nell'esempio riportato di seguito, comunicheremo il sesso (Maschio) e l'età (32) di un partecipante a un sondaggio Qualtrics utilizzando "Q_EED" aggiunto alla fine del collegamento al sondaggio come stringa query.
Consiglio Q: non variare l'ortografia, la punteggiatura o la sensibilità alle maiuscole delle variabili. Se nel flusso del sondaggio compare la voce “Sesso”, la “S” deve essere sempre scritta in maiuscolo affinché questa informazione venga codificata correttamente e quindi trasferita.
Attenzione: Per motivi di sicurezza, le stringhe codificate non possono contenere segni più ( + ), altrimenti i dati integrati non verranno registrati. Usa invece i trattini ( – ).
Come utilizzare Q_PopulateResponse
Q_PopulateResponse viene utilizzato come parametro URL per pre-popolare le risposte del sondaggio.
I valori vengono passati attraverso l'URL come campi formattati in JSON:
YourSurveyURL?Q_PopulateResponse={"QID1":"6","QID2":"4","QID3":"questo è il mio testo","QID4":"1"}
Se desideri inserire le risposte dell'anno scorso nei sondaggi di quest'anno, puoi caricare le risposte come dati integrati in un elenco di contatti e quindi creare un Collegamento individuale che faccia riferimento a tali risposte. Per prima cosa, inserisci del testo cliccabile nell'e-mail di distribuzione, poi recupera il testo con l'URL del sondaggio inserito tramite pipe e, infine, usa il pulsante "link" nell'editor per contenuti avanzati per creare un collegamento simile a 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 dell'URL, poiché ciò disabiliterebbe il testo trasferito.
Questo link visualizzerà le risposte dell'anno scorso. Se la persona modifica alcune di queste risposte predefinite e poi esce dal sondaggio, quando rientra nel sondaggio, il salvataggio più recente sovrascrive quello che l'URL dichiara debba essere popolato. Inoltre, se c'è una logica di visualizzazione su una domanda, questa verrà compilata, ma non verrà registrata, a meno che la persona non scelga la logica corretta per la visualizzazione della domanda.
Consiglio Q: consultare le FAQ in fondo alla pagina per un aiuto sulla formattazione di JSON.
Casi comuni
Di seguito sono riportati alcuni casi d'uso comuni di Qualtrics che utilizzano le stringhe query. Per ulteriori informazioni, visitate le pagine collegate.
- Estrarre i dati in un secondo sondaggio (sondaggi longitudinali)
- Integrazione con un'azienda di Panel
- Creare un link di ripresa
Tipi di progetti con cui è possibile utilizzare le stringhe query
Le stringhe query possono essere utilizzate con qualsiasi tipo di progetto che contenga un link. Sono inclusi:
- Progetti di sondaggio
- Coinvolgimento
- 360
- Ciclo di vita
- Ricerca dipendente ad hoc
- Sondaggio d'opinione
- Soluzioni XM
- Analisi congiunte
- MaxDiff
Consiglio Q: questa pagina di supporto è stata scritta pensando ai progetti di sondaggio. Non tutti i casi d'uso discussi in questa pagina sono rilevanti per ogni tipo di progetto.
FAQs
Devo compilare ogni domanda del sondaggio con Q_PopulateResponse?
Devo compilare ogni domanda del sondaggio con Q_PopulateResponse?
Come faccio a capire la formattazione JSON di una domanda?
Come faccio a capire la formattazione JSON di una domanda?
Scelta multipla (formato breve): "ID domanda":"ID opzione"
Scelta multipla (formato completo): "ID domanda":[{"Valore":"ID opzione","Testo":"testo"}]
Inserimento testo: "ID domanda":"Questo è un campo di testo"
Selezione multipla (formato breve): "ID domanda":"ID opzione,ID opzione,ID opzione"
Formato completo a selezione multipla: "ID domanda":[{"Valore": "ID opzione"}, {"Valore":"ID opzione", "Testo": "Testo"}]
Formato breve di matrice: "QuestionID":{"StatementID":"ScaleID(s)","StatementID":"ScaleID(s)","StatementID":"ScaleID(s)"}
Consiglio Q: per la selezione multipla della Matrice, gli ScaleID sono separati da virgole. Ad esempio: {"QID1":{"1":{"Value":"1,2,3"}}}
Formato completo della matrice: "QuestionID":{"StatementID":{"Value": "ScaleID(s)", "Text": "Text1"},"StatementID":{"Value": "ScaleID(s)", "Text": "Text2"}}
Consiglio Q: per la selezione multipla della Matrice, gli ScaleID sono separati da virgole. Ad esempio: {"QID1":{"1":{"Value":"1,2,3"}}}
Inserimento testo a matrice e somma costante a matrice: "QuestionID":{"StatementID":{"ScaleID": "Text"},"StatementID":{"ScaleID": "Text2"}}
Formato completo per l'inserimento testo a matrice e la somma costante a matrice: "QuestionID":{"StatementID":{"Value": {"ScaleID": "Text"}, "Text": "Consenti inserimento di testo"},"StatementID": {"Value": {"ScaleID": "Text2"}}}
Somma costante: "QuestionID":{"StatementID":"numero","StatementID":"numero","StatementID":"numero"}
Formato completo della somma costante: "ID domanda":{"ID opzione":{"Valore":"numero","Testo":"Consenti inserimento testo"},"ID opzione":{"Valore":"numero"}}
Affiancati:"ID domanda":{"ID colonna":{"ID affermazione":"ID scala","ID affermazione":"ID scala"},"ID colonna":{"ID affermazione":"ID scala","ID affermazione":"ID scala"}}
Ordine di classificazione: "ID domanda":{"ID opzione":{"Valore":"ID classificazione"},"ID opzione":{"Valore":"ID classificazione"},"ID opzione":{"Valore":"ID classificazione"}}
Scelta gruppo e classificazione: "QuestionID":{"ChoiceID":{"GroupID":"Rank", "Text":"Consenti inserimento testo"},"ChoiceID":{"GroupID":"Rank"}}
Inserimento di testo affiancato: "QuestionID":{"ColumnID":{"StatementID":{"ScaleID":"Text1"},"StatementID":{"ScaleID":"Text2"}},"ColumnID":{"StatementID":"ScaleID","StatementID":"ScaleID"}}
Campo del modulo: "QuestionID":{"StatementID":"Text1","StatementID":"Text1"},
Cursore: "QuestionID":{"StatementID":"ScaleID","StatementID":"ScaleID"}
Scala a scorrimento: "QuestionID":"ChoiceID"
Formato completo della scala a scorrimento: "QuestionID":{"Value": "ChoiceID"}
Somma costante: "QuestionID":{"ChoiceID": "Numero", "ChoiceID": "Numero"}
Formato completo della somma costante: "ID domanda":{"ID opzione":{"Testo":"Valore testo","Valore":"Numero"},"ID opzione":{"Valore":"Numero"}}
Esempio: "QID4":{"1":{"Text":"exampleText","Value":"13"},"2":{"Value":"50"}}
Hot spot: "QuestionID":{"SpotID":"ScaleID","SpotID":"ScaleID"}
Consiglio Q: gli ID di SpotID partono da 4 e potrebbe essere necessario ispezionare l'elemento per individuare gli ID. Gli ScaleID sono 1/2 per On/Off e 1/2/3 per Mi piace/Non mi piace.
Formato completo Hot spot: "QuestionID":{"SpotID":{"Value":"ScaleID"},"SpotID":{"Value":"ScaleID"}}
Consiglio Q: gli ID di SpotID partono da 4 e potrebbe essere necessario ispezionare l'elemento per individuare gli ID. Gli ScaleID sono 1/2 per On/Off e 1/2/3 per Mi piace/Non mi piace.
Heat map: "QuestionID":[{"x":numero, "y":numero},{"x":numero, "y":numero}]
Menù a tendina: "QuestionID":{"ChoiceID":"AnswerID","ChoiceID":"AnswerID"}
Menù a tendina in formato completo: "QuestionID":{"ChoiceID":{"Value":"AnswerID"},"ChoiceID":{"Value":"AnswerID"}}
Evidenziazione: l’evidenziazione è un caso speciale di matrice in cui le parole sono affermazioni e i colori sono punti di valutazione.
Consiglio Q: la prima parola inizia alla posizione 4 e potrebbe essere necessario ispezionare l'elemento per individuare gli ID.
Caricamento file e firma: "QuestionID": {Size: numero, Filename: 'nome', FileType: 'mimetype', FileThumbnail: , FileData: , FileID: 'FileID', S3: true};
Se utilizzato con un collegamento anonimo e in caso di nuovo accesso a un sondaggio parzialmente compilato, Q_PopulateResponse sovrascriverà le risposte inserite manualmente nella sessione precedente?
Se utilizzato con un collegamento anonimo e in caso di nuovo accesso a un sondaggio parzialmente compilato, Q_PopulateResponse sovrascriverà le risposte inserite manualmente nella sessione precedente?
Come funziona Q_PopulateResponse con la logica di visualizzazione?
Come funziona Q_PopulateResponse con la logica di visualizzazione?
Esiste un limite alla lunghezza dell'URL che può essere utilizzato con Q_PopulateResponse?
Esiste un limite alla lunghezza dell'URL che può essere utilizzato con Q_PopulateResponse?
È fantastico! Grazie per il tuo feedback!
Grazie per il tuo feedback!