Modello di articolo

Che cos’è un progetto Website / App Insights e perché lo usiamo sul nostro sito?

Qualtrics Website / App Insights aiuta le organizzazioni a misurare e migliorare l’esperienza di un visitatore web all’interno dei loro media digitali. Con un progetto Website / App SONDAGGIO potete presentare sul vostro sito web grafiche interessanti con collegamenti al sondaggio incorporato per ottenere un feedback sull’esperienza dei vostri visitatori, informarli sulle vostre ultime offerte e promozioni e altro ancora!

Voi e i vostri colleghi avete il potere sull’aspetto del grafico (noto anche come editor di intercettazioni), sulle condizioni in cui viene visualizzato (intercettazioni) e sul codice di distribuzione.

Una volta che il codice del progetto è stato aggiunto al sito web, è possibile apportare qualsiasi tipo di modifica senza dover mai cambiare il codice o avvisare il team IT. Basta fare il lavoro in QUALTRrics e le creatività e le intercettazioni dei vostri siti web cambieranno di conseguenza.

È sicuro?

Non trasferiamo alcun dato ai server Qualtrics a meno che non siano necessari per la logica di destinazione. Detto ciò, non conserviamo nessuno di questi dati nel nostro sistema.

Per assicurare questi dati attraverso il cavo e proteggerli da attacchi Man-in-the-middle, Qualtrics utilizza sempre il protocollo “HTTPS”. Il protocollo fa riferimento al modo in cui il contenuto è consegnato ai visitatori del browser web.

Dove posso collocare il codice di progetto per la distribuzione?

Il codice di distribuzione (o codice di distribuzione del progetto) si trova nella scheda Distribuzione del progetto. Puoi semplicemente copiare il codice e inviarlo al team di sviluppo per l’implementazione. Non è necessario effettuare alcuna modifica al codice.

Il codice di distribuzione visualizza qualsiasi intercetta costruita all’interno dell’intero progetto.

Come funziona il codice?

Il codice di deployment è asincrono, ciò significa che funziona soltanto dopo che tutto il resto della pagina è stato caricato. Ciò significa che il codice di deployment non impedirà il caricamento di ogni altro aspetto della tua pagina poiché funzionerà soltanto in seguito all’attivazione dell’evento onLoad.

Esaminiamo il processo di ciò che accade quando un visitatore visualizza nel suo browser una pagina che contiene codice di distribuzione:

• Il codice di distribuzione (solitamente collocato nella testa dell’HTML) viene eseguito subito dopo il caricamento della pagina e inserisce un altro tag <script> alla fine del corpo dell’Html quando viene attivato l’evento onLoad della pagina.
• Questo tag <script> richiede codice JavaScript (Orchestrator) dai server di Qualtrics che viene memorizzato nella cache di una rete di distribuzione dei contenuti (CDN).
• L’Orchestrator effettua una chiamata di destinazione ai server di Qualtrics per determinare quali creatività mostrare. Questa chiamata non è salvata nella cache nel CDN.
  • Se necessario, viene inviata una seconda richiesta di destinazione ai server per ottenere i dati richiesti (ad esempio, espressione JavaScript o cookie di destinazione).
  • Qualtrics ottiene la definizione di Website / App Insights dal database e costruisce il codice in modo appropriato.
• Sulla base della risposta di destinazione, l’Orchestratore effettua chiamate aggiuntive per ottenere diversi contenuti da restituire su questa pagina. Il numero di richieste effettuate varia in base al numero di creatività da mostrare che superano la logica di destinazione. Tutto questo contenuto è salvato nella cache nella CDN, così sarà facile caricarlo.
• L’editor o gli editor di intercettazioni appaiono sulla pagina.

Il codice di distribuzione è dinamico, il che significa che le modifiche apportate alle intercette e alle creatività dall’interfaccia del progetto Website / App Insights non causeranno la modifica del codice stesso. In questo modo, è possibile apportare modifiche ai progetti di Website/App Insights dall’interno di un account e non è necessario scambiare il codice sul sito web per visualizzare le modifiche.

Come si distribuisce un progetto di sito web/app Insights?

1. Aggiungere codice direttamente alle pagine web

Il codice di deployment può essere aggiunto ovunque su una pagina web. Siccome il codice funziona in modo asincrono, inizierà a caricarsi soltanto quando una pagina web ha completamente caricato tutto il contenuto (incluse immagini, file di script, file CSS, ecc.).

Le nostre richieste iniziano a verificarsi una volta che l’evento onLoad viene triggerato: https://www.w3schools.com/jsref/event_onload.asp

Inoltre, la posizione in cui le creatività appaiono effettivamente sulla pagina web è determinata dalle impostazioni stabilite nell’interfaccia di Qualtrics. (Pertanto, la posizione del codice all’interno della pagina non influisce sulla posizione del contenuto della pagina stessa.

2. Intestazione globale/Footer (consigliato)

Vi consigliamo di aggiungere il codice di deployment o all’Intestazione o al Pié di pagina globali. Ciò applica il codice globalmente a tutto il sito in una sola volta. Questo metodo è il più semplice per la distribuzione, perché non è necessario aggiungere ripetutamente il codice a più pagine, il che può essere un processo lungo. Se il codice è stato aggiunto globalmente al sito in questo modo, è possibile utilizzare la logica dell’URL corrente all’interno di un’intercetta per controllare su quali pagine appare effettivamente un’intercetta.

3. Usare i Tag Manager

Un’altra opzione è quella di aggiungere il codice di distribuzione a un sistema di Tag Management, invece di applicarlo direttamente al codice del sito. Il codice può essere copiato e incollato dall’interfaccia Qualtrics direttamente in un Tag Manager.

I sistemi di Tag Management più comuni che i nostri clienti utilizzano insieme a Website / App Insights sono Adobe Launch, Tealium, Ensighten e Google Tag Manager. Tealium, in particolare, dispone di una procedura guidata che consente una facile implementazione di Website / App Insights. Avrete semplicemente bisogno di un ID Area per il progetto che stai implementando e il tuo ID Organizzazione.

L’ID Organizzazione può essere ottenuto andando su Impostazioni account e selezionando la scheda ID di Qualtrics.

L’ID Area inizierà con ZN_ e si può trovare:

1. Nell’URL del progetto quando ci si trova al suo interno, oppure
   
2. nel codice di distribuzione del progetto.
   

Chi è tipicamente coinvolto nell’implementazione di Website/App Insights?

Qualcuno all’interno della tua organizzazione che ha l’accesso per aggiungere contenuti al tuo sito web aziendale. Generalmente questi sono individui di team IT, team Web Content, ecc.

Website / App Insights rallenterà il nostro sito?

Il codice di deployment è asincrono, ciò significa che funziona soltanto dopo che tutto il resto della pagina è stato caricato. Ciò significa che il codice di deployment non impedirà il caricamento di ogni altro aspetto della tua pagina poiché funzionerà soltanto in seguito all’attivazione dell’evento onLoad.

Che cosa accade se Qualtrics è inattivo? Ciò causerà problemi al nostro sito web?

Se Qualtrics subisce interruzioni o problemi, le intercettazioni non vengono visualizzate sulla pagina. Oltre a questo, non ci sarà alcun impatto sull’esperienza del visitatore sui vostri siti.

Con che velocità il codice funzionerà sul mio sito web?

Ci aspettiamo che il codice di deployment si carichi entro 300 millisecondi per più del 50% delle richieste e entro 750 millisecondi per più del 90% delle richieste. La velocità varia in base alla posizione geografica dell’utente e al numero di intercette e creazioni di un progetto.

Apertura della finestra di debug

È possibile utilizzare la finestra di debug per diagnosticare il motivo per cui un’intercetta non è stata visualizzata in una pagina web specifica. Questa finestra mostra tutte le condizioni richieste per la comparsa dell’intercetta e se le condizioni sono state superate o meno.

Il modo in cui si apre la finestra di debug dipende da quando è stata implementata l’intercetta.

Intercettazioni attuate prima di marzo 2019

Per le intercette il cui codice di distribuzione è stato implementato prima di marzo 2019, è possibile abilitare la finestra di debug aggiungendo la stringa queryQ_DEBUG all’URL. Questa stringa query deve essere completata con un ? o un &amp;, come illustrato negli esempi seguenti:

Intercettazioni attuate dopo marzo 2019

Per le intercette il cui codice di distribuzione è stato implementato dopo marzo 2019, seguire questi passaggi per aprire la finestra di debug:

1. Aprite gli strumenti per gli sviluppatori del vostro browser.
2. Eseguire il seguente comando JavaScript
   :QSI.API.unload();
QSI
   .isDebug = true;
QSI
   .API.load();
QSI
   .API.run();

Consigli di risoluzione dei problemi

Logica dell’intercettamento e logica dell’insieme di azioni

• Assicurati che i valori siano corretti.
• Esaminate l’uso di “è” rispetto a “è”. “Contiene”
• Esaminate l’uso della tua logica e/o
• Controllate gli spazi nei valori

Cronologia revisioni

Assicuratevi che la versione pubblicata sia la più recente (o quella che vi aspettereste).

Attenzione alla richiesta di rete di siti web/app Insights

1. Aprire Strumenti per sviluppatori sul browser.
2. Osservare la richiesta di rete per “Q_ZID” e così via.
   • Nessuna richiesta di rete: L’implementazione non funziona.
   • Richiesta di rete: Controllare che i parametri della richiesta non siano incoerenti. A volte il codice è implementato usando un sistema tag management. Ci sono casi in cui questa implementazione dà problemi con i parametri nella nostra richiesta delle URL attuali, ecc.
   • Richiesta di rete con un errore: Controllare se il progetto è attivato.

Cercare altre richieste di script sospese che potrebbero interferire con il nostro script

1. Fai clic con il tasto destro in un qualsiasi punto del browser.
2. Selezionare Ispeziona elemento.
3. Scegliere Console (è qui che appaiono gli errori).

FAQ