Documentazione tecnica Analisi sito web/app

Cos’è un progetto Website / App Insights e perché lo stiamo utilizzando sul nostro sito?

Qualtrics Website / App Insights aiuta le organizzazioni a misurare e migliorare l’esperienza che un visitatore web ha all’interno dei propri media digitali. Con un progetto Website / App Insights puoi presentare fantastiche grafiche sul tuo sito web con link e sondaggi incorporati per ottenere un feedback sull’esperienza dei tuoi visitatori, fargli sapere le tue ultime offerte e promozioni e altro ancora!

Voi e i vostri colleghi avete potere sull’aspetto del grafico (noto anche come creativo), sulle condizioni in cui appare (l’intercetta) e sul codice utilizzato per distribuirlo.

Una volta aggiunto il codice del progetto al tuo sito web, puoi fare ogni genere di modifica senza dover mai cambiare il codice o dover avvisare il tuo team IT. Fate solo il lavoro in Qualtrics, e i creativi e le intercettazioni del tuo sito 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 il codice di distribuzione del progetto) può essere trovato accedendo alla scheda Distribuzione all’interno 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 tutte le intercette che sono state costruite 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 una pagina nel proprio browser che contiene il codice di distribuzione:

• Il codice di deployment (solitamente inserito nella testata HTML) viene eseguito subito dopo il caricamento della pagina e inserirà un altro tag <script> alla fine del corpo Html quando viene attivato l’evento onLoad della pagina.
• Questo tag <script> richiede il codice JavaScript (Orchestrator) dai server Qualtrics memorizzati nella cache di una Content Delivery Network (CDN).
• L’Orchestratore effettua una chiamata di destinazione ai server Qualtrics per determinare quali creativi mostrare. Questa chiamata non è salvata nella cache nel CDN.
  • Se necessario, viene inviata una seconda richiesta di targeting ai server per ottenere i dati richiesti (es: espressione JavaScript o destinazione cookie).
  • Qualtrics ottiene la definizione di Analisi Sito Web / App 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 a seconda del numero di creativi per mostrare quella logica di targeting pass. Tutto questo contenuto è salvato nella cache nella CDN, così sarà facile caricarlo.
• Gli editor di intercetta appaiono sulla pagina.

Il codice di distribuzione è dinamico, il che significa che le modifiche apportate alle intercettazioni e agli editor di intercetta dall’interno dell’interfaccia del progetto Website / App Insights non causeranno la modifica del codice stesso. Pertanto, è possibile apportare modifiche ai progetti Analisi sito Web / app dall’interno di un account e non sarà necessario scambiare codice sul sito Web per visualizzare le modifiche.

Come distribuisco un progetto Website/App Insights?

1. Aggiungi codice direttamente alle tue 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 attivato l’evento onLoad: https://www.w3schools.com/jsref/event_onload.asp

Inoltre, la posizione in cui i creativi appaiono effettivamente sulla pagina web è determinata dalle impostazioni determinate all’interno dell’interfaccia Qualtrics. (Vedi informazioni su Posizione personalizzata.) Pertanto, la posizione del codice all’interno della pagina non influisce sul punto in cui apparirà il contenuto della pagina.

2. Intestazione/Piè di pagina globale (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 modo più semplice per eseguire la distribuzione perché non è necessario aggiungere ripetutamente codice a più pagine mentre si procede, il che può essere un processo lungo. Se il codice è stato aggiunto globalmente al tuo sito in questo modo, puoi quindi utilizzare la Logica URL corrente all’interno di un’intercetta per controllare su quali pagine appare effettivamente un’intercetta.

3. Utilizza Tag Manager

Un’altra opzione è aggiungere il codice di deployment a un sistema 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 comuni sistemi di Tag Management che i nostri clienti utilizzano in combinazione con Website / App Insights sono Adobe Launch, Tealium, Ensighten e Google Tag Manager. Tealium in particolare ha un wizard costruito che permette 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 Qualtrics.

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

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

Chi è generalmente 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 sta riscontrando interruzioni o problemi, le intercettazioni semplicemente non compariranno sulla pagina. Oltre a ciò, non ci sarà alcun impatto sull’esperienza del visitatore sui tuoi 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à varierà in base alla posizione geografica dell’utente e a quante intercettazioni e creativi ha un progetto.

Apertura della finestra di debug

È possibile utilizzare la finestra di debug per diagnosticare il motivo per cui un’intercetta non è visualizzata in una pagina Web specifica. Questa finestra mostra tutte le condizioni necessarie affinché l’intercetta venga visualizzata e se le condizioni sono state superate o non sono riuscite.

Il modo in cui apri la finestra di debug dipenderà da quando è stata implementata la tua intercetta.

Intercettazioni implementate 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 di queryQ_DEBUG all’URL. Questa stringa di query deve essere aggiunta con ? o &, come illustrato negli esempi seguenti:

Intercettazioni implementate dopo marzo 2019

Per le intercette il cui codice di distribuzione è stato implementato dopo marzo 2019, attenersi alla seguente procedura per aprire la finestra di debug:

1. Apri gli strumenti per sviluppatori del tuo 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’intercetta e logica del set di azioni

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

Cronologia revisioni

Assicurarsi che la versione pubblicata sia la più recente (o la versione prevista).

Guarda per la richiesta di rete Insights Sito Web / App

1. Apri Strumenti sviluppatore sul tuo browser.
2. Esaminare la richiesta di rete per?Q_ZID ecc.
   • Nessuna richiesta di rete: l’implementazione non funziona.
   • Richiesta di rete: verificare la presenza di inconsistenze nei parametri della richiesta. 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 network con un errore: controlla se il progetto è attivato.

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

1. Fai clic con il tasto destro in un qualsiasi punto del browser.
2. Selezionare Controlla elemento.
3. Scegliere Console (dove vengono visualizzati gli errori).

FAQ