Single Page Application (applicazione singola pagina)
Informazioni sulle applicazioni a pagina singola
Single Page Applications (SPA) sono un tipo speciale di app Web. Una SPA caricherà una sola pagina quando si inserisce un sito Web e, da quel momento in poi, si caricheranno tutti i contenuti successivi nella stessa pagina in cui si naviga. Questo sembrerà funzionare come un normale sito web, ma quando si passa da una pagina all’altra, la pagina in realtà non viene ricaricata.
Per impostazione predefinita, il codice di distribuzione viene eseguito non appena viene caricata una pagina Web. Tuttavia, poiché gli accordi SPA non vengono aggiornati quando si naviga tra le pagine, il codice di distribuzione non verrà rivalutato quando si naviga tra le pagine. Utilizzando le tecniche descritte di seguito, è possibile abilitare il codice di distribuzione a funzionare senza soluzione di continuità sul sito SPA.
Rivalutazione automatica della logica dell’intercettazione alla modifica dell’URL
Se la tua applicazione a pagina singola dipende dall’instradamento lato client per la navigazione degli utenti, puoi forzare la rivalutazione delle intercette alle successive modifiche all’URL abilitando la logica di rivalutazione delle intercette quando l’URL cambia l’impostazione a livello di progetto Website Feedback. La verifica di questa impostazione consentirà la valutazione logica dell’intercetta oltre alla valutazione che si verifica al caricamento della pagina iniziale.
Per abilitare la rivalutazione automatica della logica dell’intercetta, attenersi alla seguente procedura:
- Nel progetto Website Feedback, vai alle Impostazioni.
- Fare clic su Gestisci progetto.
- Selezionare Opzioni progetto dal menu a discesa.
- Assicurarsi che la logica Rivaluta intercetta quando viene controllata la modifica dell’URL nella sezione Supporto app pagina singola (SPA).
Attenzione: se decidi di utilizzare questa impostazione SPA in combinazione con l’opzione a livello di intercetta per visualizzare con codice Javascript personalizzato (manualmente), allora dovrai ancora chiamare
QSI.API.run();
per ottenere l’intercetta da visualizzare su ogni pagina SPA.
Implementazione manuale con API JavaScript
Questo metodo descrive come passare all’esecuzione manuale del codice di distribuzione. Ciò significa che il codice di distribuzione non verrà eseguito o valuterà la logica associata fino all’avvio della richiesta dell’API JavaScript appropriata.
Per l’implementazione manuale
- Navigare alla scheda Impostazioni.
- Fare clic sull’elenco a discesa Gestisci progetto.
- Selezionare Opzioni progetto.
- Abilitare l’opzione Carica manualmente progetto.
- Torna alla scheda Intercettazioni e, se lo desideri, imposta la logica sulla tua intercettazione o sul set di azioni.
- Posizionare il codice di distribuzione nel sito Web, preferibilmente in un’intestazione o in un piè di pagina globale in modo che venga caricato su tutte le pagine.
- Aggiungi le richieste API JavaScript appropriate in base al numero di volte in cui desideri che il tuo sito web faccia riferimento all’intercettazione. Vedere la sezione sottostante per queste richieste.
Richieste API JavaScript
Se desideri che Qualtrics valuti il tuo progetto in una singola istanza, utilizza queste due richieste:
- Questa richiesta carica il codice di distribuzione per qualsiasi intercetta e creativo sulla pagina. L’API di “caricamento” equivale a ricaricare una pagina che ha un codice su di essa.
QSI.API.load();
Qtip: se hai abilitato Caricamento manuale progetto nelle impostazioni del progetto, non dovrai chiamare questa API per caricare il codice di distribuzione al caricamento della pagina iniziale. Sarà necessario solo forzare il caricamento per contabilizzare le modifiche di stato sulla pagina che si verificano senza ricaricare. - Questo avvia la valutazione del codice di distribuzione e fa apparire qualsiasi creativo se supera le condizioni di visualizzazione.
QSI.API.run();
Se desideri che Qualtrics valuti il tuo codice progetto più di una volta sulla stessa pagina, ripeti le tre fasi seguenti ogni volta:
- Questa richiesta rimuove il codice di distribuzione per qualsiasi intercetta o creativo presente nella pagina.
QSI.API.unload();
- Questo carica il codice di distribuzione per qualsiasi intercetta o creativo sulla pagina. Questo equivale a ricaricare la pagina.
QSI.API.load();
- Questo avvia la valutazione del codice di distribuzione e fa apparire qualsiasi creativo se supera le condizioni di visualizzazione.
QSI.API.run();