Single Page Application (applicazione singola pagina)

Question 1

Ho attivato la mia intercetta, ma non è visibile sul mio sito. Perché no?

Esistono numerose cause potenziali per cui un'intercetta potrebbe non apparire una volta implementata. Queste cause possono derivare dall'impostazione dell'intercetta stessa o dall'implementazione del codice.

Logica: la logica di destinazione dell'intercetta e la logica dell'insieme di azioni sono le condizioni che devono essere soddisfatte affinché un'intercetta venga visualizzata da un visitatore. La verifica di questa logica sarà utile per scoprire perché l'Intercetta non viene visualizzata nella pagina.
Insiemi logici che utilizzano "Contiene": Una causa comune di errore logico è l'uso di "Contains" rispetto a "Contain". "È" Dire che una condizione "Contiene" significa che il parametro su cui si basa la logica (ad esempio, l'URL corrente) avrà il valore specificato, oltre a ulteriori informazioni. Ad esempio, se avessi una logica di visualizzazione del tipo L'URL corrente contiene 'qualtrics', l'intercettazione verrebbe visualizzata su qualsiasi URL in cui è presente la parola qualtrics. L'altra possibilità che avete è quella di utilizzare l'URL corrente è [URL]. Questa condizione dipende dalla corrispondenza esatta dell'URL visitato. Eventuali differenze o caratteri aggiuntivi impediranno il passaggio della logica di intercettazione.
Revisioni delle intercettazioni: Quando si apportano modifiche alle intercettazioni, le modifiche non vengono rese effettive finché l'intercettazione non viene pubblicata. Quando si pubblica un'Intercetta, viene salvata una versione dell'intercetta, o una "revisione". Valutare le revisioni effettuate è molto utile per individuare eventuali modifiche che potrebbero aver improvvisamente impedito la comparsa dell'intercetta.
Finestra di debug: La finestra di debug è uno strumento prezioso per verificare perché un'intercetta non viene visualizzata in una determinata pagina.

Per le intercette il cui codice di distribuzione è stato implementato prima di marzo 2019, per abilitare la finestra di debug, aggiungere una stringa query a qualsiasi URL chiamata Q_DEBUG. Il prefisso deve essere preceduto da un ? o da una &, come negli esempi seguenti: https://www.qualtrics.com?Q_DEBUG, https://www.qualtrics.com/blog?item=value&Q_DEBUG.

Per le intercette il cui codice di distribuzione è stato implementato dopo marzo 2019, eseguire il seguente frammento JavaScript nella console della pagina web: QSI.API.unload(); QSI.isDebug = true; QSI.API.load(); QSI.API.run(); La finestra di debug scompone tutte le condizioni necessarie per la visualizzazione delle intercette in esecuzione sull'URL. Se si scopre che un'intercetta non viene visualizzata, individuarla nella finestra di debug e identificare eventuali avvisi di errore rossi.
Consiglio Q: il debugger di Website Insights non funziona se il codice è stato implementato con un tag manager. Inoltre, se l'URL ha già una stringa query con un ?, il debugger richiederà invece un &.
Richiesta di rete: La maggior parte dei browser possiede un menu di strumenti per sviluppatori che consente all'utente di vedere il codice sorgente, le risorse, i cookie e le chiamate di rete di un sito. Website Insights ha una presenza distinta nella sezione Rete di questi strumenti. Per verificare l'esecuzione di questi script, aprire gli strumenti per sviluppatori e navigare nella sezione Rete. Una volta qui, ricaricare la pagina web e il menu dovrebbe iniziare a popolarsi con tutte le richieste di rete effettuate dal sito web. Per identificare il codice di Website Insights, cercare le chiamate che iniziano con ?Q_ZID o ?Q_SID. È il codice stesso che esegue i controlli sulla logica di visualizzazione. Se non si trova nulla che corrisponda a questo formato, c'è un problema nell'implementazione del codice del progetto. È possibile consultare la nostra pagina di supporto sull'implementazione per avere consigli su dove è meglio posizionare il codice.
Problemi relativi ai criteri di sicurezza dei contenuti: Se si riceve un log della console che viola un criterio di sicurezza dei contenuti, è molto probabile che vi sia una restrizione sul vostro sito web che blocca la distribuzione delle nostre intercettazioni. Si consiglia di contattare il team di sviluppo web per risolvere il problema. Per garantire il funzionamento delle intercettazioni, in genere si consiglia di consentire l'inserimento dei seguenti elementi nelle intestazioni dei criteri di sicurezza dei contenuti:
- connect-src https://*.qualtrics.com
- frame-src https://*.qualtrics.com
- img-src https://siteintercept.qualtrics.com
- script-src https://*.qualtrics.com
Gestione degli URL SPA: Se il vostro sito utilizza un framework per applicazioni a pagina singola (SPA), assicuratevi che il vostro codice faccia triggerare history.pushState() durante la navigazione tra le viste. Alcuni framework possono renderizzare o aggiornare l'URL senza inserire una nuova voce nella cronologia, impedendo così l'attivazione delle intercettazioni. Se si utilizza useEffect o ganci simili per il lifecycle, assicurarsi che la logica di intercettazioni venga eseguita al termine della navigazione.

Question 2

Ho costruito la mia intercetta ma vorrei testarla prima dell'attivazione. Come posso farlo?

Esiste uno strumento chiamato bookmarklet che permette di testare qualsiasi intercettazione senza doverla attivare.

Single Page Application (applicazione singola pagina)

Informazioni sulle applicazioni a pagina singola

Valutatore della logica di intercettazione e dell’attività di tracciamento in caso di modifica dell’URL

Implementazione manuale con JavaScript API

Per implementare manualmente

Richieste API in JavaScript

FAQs

Get the latest news on XM events, research, and product launches