-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Modello di articolo
Informazioni sulle applicazioni a pagina singola
Le applicazioni a pagina singola (SPA) sono un tipo speciale di applicazioni web. Una SPA carica una singola pagina quando si entra in un sito web e, da quel momento in poi, carica tutti i contenuti successivi in quella stessa pagina durante la navigazione. Sembra funzionare come un normale sito web, ma quando si passa da una “pagina” all’altra, la pagina non viene ricaricata.
Per impostazione predefinita, il codice di distribuzione viene eseguito non appena viene caricata una pagina web. Tuttavia, poiché le SPA non vengono aggiornate durante la navigazione tra le pagine, il codice di distribuzione non viene rivalutato durante la navigazione tra le pagine. Utilizzando le tecniche descritte di seguito, è possibile consentire al codice di distribuzione di funzionare sul sito SPA senza problemi.
Rivalutazione automatica della logica di intercettazioni in caso di modifica dell’URL
Se l’applicazione a pagina singola dipende dal routing lato client per la navigazione dell’utente, è possibile forzare la rivalutazione delle intercettazioni alle successive modifiche dell’URL, abilitando l’impostazione Rivaluta l’ insieme logico delle intercettazioni quando l’URL cambia a livello di progetto Website Feedback. Selezionando questa impostazione, è possibile effettuare una valutazione della logica di intercettazione in aggiunta alla valutazione che avviene al caricamento iniziale della pagina.
Per abilitare la rivalutazione automatica della logica di intercettazioni, procedere come segue:
- Nel progetto Website Feedback, passare alle Impostazioni.
- Fare clic su Manager Progetti.
- Selezionare Opzioni progetto dal menu a discesa.
- Assicurarsi che nella sezione Supporto per le app a pagina singola (SPA) sia selezionata l’opzione Rivaluta la logica di intercettazione quando l’URL cambia.
Attenzione: Se si decide di utilizzare questa impostazione SPA in combinazione con l’opzione a livello di intercettazioni per la visualizzazione con codice Javascript personalizzato (manualmente), sarà comunque necessario richiamare il parametro
QSI.API.run();per ottenere l’intercetta da visualizzare in ogni pagina SPA.
Implementazione manuale con JavaScript API
Questo metodo spiega come cambiare il codice di distribuzione per eseguirlo manualmente. Ciò significa che il codice di distribuzione non eseguirà o valuterà la logica associata finché non verrà avviata la richiesta API JavaScript appropriata.
Per implementare manualmente
- Passare alla scheda Impostazioni.
- Fare clic sul menu a tendina Manager Progetti.
- Selezionare PROGETTI.
- Attivare l’opzione Carica manualmente il progetto.
- Tornare alla scheda Intercettazioni e, se lo si desidera, impostare la logica sull’intercettazione o sul set di azioni.
- Inserite il codice di distribuzione nel vostro sito web, preferibilmente in un’intestazione o in un piè di pagina globale, in modo che venga caricato su tutte le pagine.
- Aggiungere le richieste API JavaScript appropriate in base al numero di volte in cui si desidera che il sito web faccia riferimento all’Intercetta. Per queste richieste si veda la sezione sottostante.
Richieste API in JavaScript
Se volete che Qualtrics valuti il vostro progetto in un’unica istanza, utilizzate queste due richieste:
- Questa richiesta carica il codice di distribuzione delle Intercette e delle Creazioni presenti nella pagina. L’API “load” equivale a ricaricare una pagina contenente del codice.
QSI.API.load();Consiglio Q: se nelle impostazioni del progetto è stato abilitato il caricamento manuale del progetto, non sarà necessario chiamare questa API per caricare il codice di distribuzione al primo caricamento della pagina. Sarà necessario forzare il caricamento solo per tener conto dei cambiamenti di stato della pagina che avvengono senza ricaricarla. - Questo avvia la valutazione del codice di distribuzione e farà apparire qualsiasi Creativo se supera le condizioni di visualizzazione.
QSI.API.run();
Se volete che Qualtrics valuti il codice del vostro progetto più di una volta sulla stessa pagina, ripetete ogni volta i tre passaggi seguenti:
- Questa richiesta rimuove il codice di distribuzione di eventuali Intercette o Creazioni presenti nella pagina.
QSI.API.unload(); - Carica il codice di distribuzione per qualsiasi Intercetta o Creativa presente nella pagina. Ciò equivale a ricaricare la pagina.
QSI.API.load(); - Questo avvia la valutazione del codice di distribuzione e farà apparire qualsiasi Creativo se supera le condizioni di visualizzazione.
QSI.API.run();