Se nella pagina non viene visualizzato il contenuto previsto, puoi adottare alcune misure per eseguire il debug della distribuzione dei contenuti.
mboxDebug è particolarmente utile quando esegui la configurazione di Target sulla pagina per assicurarti che la richiesta di Target sia attiva e che il cookie sia impostato. Tuttavia, non fornisce il livello di dettaglio necessario durante il debug della distribuzione dei contenuti. Se l’attività non viene visualizzata nella pagina o un contenuto indesiderato viene visualizzato, esamina ed esegui il debug della pagina nel dettaglio tramite mboxTrace.
Dato che in mboxTrace e mboxDebug è possibile esporre dati sulla campagna e sul profilo a soggetti esterni, è necessario un token di autorizzazione. Il token di autorizzazione può essere recuperato nell’interfaccia utente di Target. Il token è valido per sei ore.
Per generare un token di autenticazione, è necessario disporre di una delle seguenti autorizzazioni utente:
Almeno il livello di autorizzazione Editor (o Approvatore)
Per ulteriori informazioni per i clienti Target Standard, consulta Specificare ruoli e autorizzazioni in Utenti. Per ulteriori informazioni per i clienti Target Premium, consulta Configurare le autorizzazioni aziendali.
Ruolo amministratore a livello di area di lavoro/profilo di prodotto
Le aree di lavoro sono disponibili solo per i clienti Target Premium. Per ulteriori informazioni, consulta Configurare le autorizzazioni aziendali.
Diritti di amministrazione (autorizzazione Sysadmin) a livello di prodotto Adobe Target
Per recuperare il token di autorizzazione:
Fai clic su Amministrazione > Implementazione.
Dalla sezione Strumenti di debug, fai clic su Genera nuovo token di autenticazione.
Aggiungi il token generato come parametro nell’URL per abilitare uno degli strumenti di debug avanzati.
mboxTrace consente di ricevere informazioni di trace collegate alle risposte di Target. Le informazioni di trace riflettono il risultato di una chiamata Target (ad esempio, una conversione o un’impression) ed eventuali dati ulteriori che possono aiutare a determinare perché sia stato ottenuto questo particolare risultato, ad esempio un insieme di rami disponibili tra i quali è stata effettuata la selezione in una campagna. Esegui il debug della distribuzione dei contenuti con queste informazioni.
Sono disponibili i seguenti parametri:
Opzioni mboxTrace | Risultato |
---|---|
?mboxTrace=console |
Visualizzazione nel registro della console come oggetti. Per at.js, invece di aprire una nuova finestra del browser o di eseguire l’output sulla console come in mbox.js, sarà necessario controllare la richiesta di rete e guardare in Anteprima (Chrome) o Risposta (Firefox). |
?mboxTrace=json |
Visualizzazione nel registro della console come stringa letterale JSON |
?mboxTrace=window |
Visualizzazione in una finestra popup come stringa JSON |
?mboxTrace=disable |
Disattiva la modalità di sessione di tracciamento |
Esempio di chiamata mboxTrace
https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6
L’output mostra informazioni dettagliate sul contenuto. mboxTrace mostra i dettagli della campagna o attività e sul profilo. Inoltre, fornisce un’istantanea del profilo prima dell’esecuzione e una di ciò che è stato modificato dopo l’esecuzione. In aggiunta, mostra quali campagne o attività sono state valutate per ogni posizione.
Alcune delle informazioni includono ID di destinazione e di segmento associati e non associati:
Utilizzo di mboxTrace su le pagine di consigli: l’aggiunta di mboxTrace come parametro di richiesta nelle pagine con i consigli sostituisce la progettazione dei consigli nella pagina con una finestra dei dettagli mboxTrace, che visualizza informazioni approfondite sui consigli, tra cui:
Non devi includere =console
, =json
o =window
nel parametro di query. Una volta completati i dettagli mboxTrace, aggiungi =disable
e premi Invio per tornare alla modalità di visualizzazione normale.
mboxTrace non influenza il normale funzionamento e aspetto del tuo sito. I visitatori vedranno la solita struttura dei consigli.
Per utilizzare mboxDebug, aggiungi un parametro mboxDebug alla fine dell’URL. Nella tabella seguente sono incluse informazioni sui parametri URL relativi a risposte di Target.
Alcuni parametri mboxDebug sono disponibili con o senza autenticazione.
Parametri URL | Finalità |
---|---|
mboxDebug=1 |
Debugger L’aggiunta di questo parametro a qualsiasi URL in cui sono definite delle richieste di Target determina l’apertura di una finestra a comparsa con dettagli utili al debug. Vengono inserite informazioni sui cookie, valori PCid e ID di sessione e sono visibili tutti gli URL. Fai clic su un URL con richiesta di Target per visualizzarne la risposta di Target. Maggiori dettagli sono disponibili in mbox_debug.pdf. |
mboxDisable=1 |
Disattiva le mbox sulla pagina |
mboxOverride.browserIp=<Insert IP address> |
Testa geotargeting Testa il geotargeting con questo parametro URL. Digita un indirizzo IP come valore per questo attributo e il geotargeting di Test&Target valuterà tale indirizzo IP rispetto a qualsiasi geotargeting o segmentazione impostata in una campagna. |
Assicurati che il frammento URL sia dopo i parametri della stringa di query. Qualsiasi elemento dopo il primo #
è un identificatore di frammento e causa il mancato funzionamento dei parametri di debug.
Il debugger di Adobe Experience Cloud facilita e velocizza la comprensione dell'implementazione di Target. Puoi visualizzare rapidamente la configurazione della libreria, esaminare le richieste per verificare che i parametri personalizzati vengano passati correttamente, attivare la registrazione della console e disattivare tutte le richieste Target. Autenticati in Experience Cloud per utilizzare lo strumento MboxTrace ed esaminare le tue attività, i requisiti del pubblico e il profilo visitatore.
Per ulteriori informazioni, vedi i video di formazione seguenti:
Per informazioni più dettagliate, consulta Eseguire il debug di at.js utilizzando Adobe Experience Cloud Debugger.
La chiamata SiteCatalyst: purchase
non può essere utilizzata per i dati del traffico dell’algoritmo di acquisto. Utilizza al suo posto la chiamata orderConfirmPage
.
Le attività basate su moduli create con Target Standard/Premium potrebbero entrare in conflitto con le attività create nell’interfaccia utente di Target Classic che hanno la stessa priorità e utilizzano la stessa richiesta di Target.
Target non supporta più Internet Explorer 8.
Se nel sito è presente un sottodominio, ad esempio us.domain.com, ma è necessario impostare il cookie di Target su domain.com (anziché us.domain.com), devi sovrascrivere l’impostazione cookieDomain
. Per ulteriori informazioni, consulta targetGlobalSettings().
Il contenuto di Target potrebbe essere visualizzato momentaneamente o non essere visualizzato, se un elemento DOM fa parte del targeting di personalizzazione di Adobe Experience Manager (AEM) e di un’attività di Target.
Per ovviare a questo problema, puoi disabilitare la personalizzazione AEM nelle pagine in cui Target è in esecuzione.
Se l’offerta di reindirizzamento o l’offerta remota utilizza un URL non valido, la sua consegna potrebbe non riuscire.
Per le offerte di reindirizzamento, la risposta di Target può contenere /* invalid redirect offer URL */
Oppure
Per le offerte remote, la risposta di Target può contenere /* invalid remote offer URL */
Puoi controllare la risposta di Target nel browser o utilizzando mboxTrace. Per ulteriori informazioni sugli URL validi, consulta https://tools.ietf.org/html/std66.
at.js non attiva le richieste di Target se utilizzi un doctype non valido. at.js richiede il doctype HTML5.
URL attività determina la pagina che qualifica i visitatori per l’attività ed esegue il rendering delle esperienze di attività per gli utenti. Quando viene richiesto durante la creazione dell’attività, la digitazione dell’URL completo non sempre assicura che il contenuto venga distribuito sulla pagina del sito, in particolare con gli URL che contengono parametri della stringa di query.
Per impostazione predefinita, il Compositore esperienza visivo apre la pagina specificata nelle Impostazioni del Compositore esperienza visivo. È anche possibile specificare una pagina diversa durante la creazione dell’attività.
Per visualizzare una pagina diversa dopo l’apertura del Compositore esperienza visivo, fai clic su Configura (icona ingranaggio) > seleziona Consegna pagina > quindi specifica l’URL nel campo URL attività.
Ma cosa succede se l’URL contiene parametri della stringa di query? Funzionerà e mostrerà il contenuto personalizzato? In questo scenario, indipendentemente dal pubblico di destinazione, puoi includere regole di modello oltre all’URL di base per definire i parametri di query.
Per includere regole di modello aggiuntive, è possibile utilizzare le seguenti opzioni:
Questa opzione assicura che l’URL sia idoneo per l’attività. Tuttavia esistono casi limite ad esso associati che possono influenzare i dati di reporting con record aggiuntivi per gli URL che contengono l’URL di base.
In questo caso, l’URL è https://shopping.mycart.com?type=Summers%20Offers
e regole di modello aggiuntive “contiene” lo stesso URL, separate da un operatore OR:
Il caso limite discusso nell’opzione precedente viene applicato in questa opzione, ma qui l’impostazione condizionale è limitata solo alla stringa di query.
In questo caso, l’URL è https://shopping.mycart.com?type=Summers%20Offers
e regole di modello aggiuntive “contiene” solo la stringa di query, separate da un operatore OR:
In questo caso, l’URL è https://shopping.mycart.com?type=Summers%20Offers
e regole di modello aggiuntive specificano una Query con tipo > è (distinzione maiuscole/minuscole) > type=Summers%20Offers, separati da un operatore OR:
Quando si inviano valori contenenti virgolette doppie in un Target profilo, è necessario eseguire un doppio escape come mostrato di seguito.
adobe.target.trackEvent({
"mbox": "data-collection",
"params": {
"profile.tagLine": "Escape \\\"Double Quotes\\\" like this."
}
});
I video seguenti contengono ulteriori informazioni sui concetti descritti in questo articolo.