Risolvere i problemi relativi alla distribuzione dei contenuti

Se nella pagina non viene visualizzato il contenuto previsto, puoi adottare alcune misure per eseguire il debug della distribuzione dei contenuti.

  • Controlla con attenzione il codice relativo all’attività o alla campagna. Un errore di battitura o di altro tipo potrebbe causare la mancata visualizzazione del contenuto previsto.
  • Utilizzate mboxTrace o mboxDebug per risolvere i problemi della richiesta Target.
  • Utilizzate Adobe Experience Cloud Debugger, uno strumento di facile utilizzo che fornisce molte delle stesse informazioni di mboxDebug, per risolvere i problemi della richiesta Target.

mboxDebug è particolarmente utile quando si sta configurando Target sulla pagina per essere certi che la richiesta Target sia attiva e il cookie 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.

Recuperare il token di autorizzazione da utilizzare con gli strumenti di debug

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:

  • Autorizzazione di almeno Editor (o Approver)

    Per ulteriori informazioni per i clienti Target Standard, vedere Specificare ruoli e autorizzazioni in Utenti. Per ulteriori informazioni per i clienti Target Premium, vedere Configurare le autorizzazioni aziendali.

  • Ruolo amministratore nell’area di lavoro/a livello di profilo di prodotto

    Le aree di lavoro sono disponibili solo per i clienti Target Premium. Per ulteriori informazioni, vedere Configurare le autorizzazioni aziendali.

  • Diritti di amministratore (autorizzazione Sysadmin) a livello di prodotto Adobe Target

Per recuperare il token di autorizzazione:

  1. Fare clic su Amministrazione > Implementazione.

  2. Nella sezione Strumenti debugger, fare clic su Genera nuovo token di autenticazione.

    Genera nuovo token di autenticazione

  3. Aggiungi il token generato come parametro nell’URL per abilitare uno degli strumenti di debug avanzati.

    Token di autorizzazione

mboxTrace

mboxTrace consente di ricevere le informazioni di traccia allegate alle risposte Target. Le informazioni di trace riflettono il risultato di una Target chiamata (ad esempio, una conversione o un'impressione) ed eventuali dati aggiuntivi che possono aiutare a determinare il motivo per cui questo particolare risultato è stato ottenuto, 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

Il risultato mostra informazioni estremamente dettagliate sul contenuto. mboxTrace mostra i dettagli sulla tua campagna o attività e profilo. Inoltre, fornisce uno snapshot del profilo prima dell’esecuzione e uno snapshot 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:

  • SegmentId: ID dei segmenti, dalla libreria di segmenti riutilizzabili o anonimi, creati per la campagna specifica.
  • TargetId: ID delle destinazione, dalla libreria delle espressioni di destinazione o da destinazioni anonime, per tutti i segmenti della campagna.
  • Unmatched (nessuna corrispondenza): in questa chiamata la richiesta non era qualificata per i segmenti o le destinazioni specificati.
  • Matched (con corrispondenza): la richiesta era qualificata per i segmenti o le destinazioni specificati.

Utilizzo di mboxTrace nelle pagine delle raccomandazioni: L'aggiunta di mboxTrace come parametro di query sulle pagine con raccomandazioni sostituisce la progettazione Recommendations sulla pagina con una finestra di dettagli mboxTrace, che visualizza informazioni approfondite sulle raccomandazioni, tra cui:

  • Consigli restituiti e consigli richiesti
  • Chiave utilizzata, e se sta generando consigli
  • Consigli generati da criteri e consigli di backup
  • Configurazione dei criteri
  • Esclusioni e inclusioni applicate
  • Regole di raccolta

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 tua solita struttura dei consigli.

mboxDebug

Per utilizzare mboxDebug, aggiungi un parametro mboxDebug alla fine dell’URL. La tabella seguente contiene informazioni sui parametri URL relativi alla risposta Target.

NOTA

Alcuni parametri mboxDebug sono disponibili con o senza autenticazione.

Parametri URL Finalità
mboxDebug=1 Debugger
L'aggiunta di questo parametro a qualsiasi URL con richieste Target definite apre una finestra a comparsa con preziosi dettagli di debug. Vengono inserite informazioni sui cookie, valori PCid e ID di sessione e sono visibili tutti gli URL Fate clic su un URL di richiesta Target per visualizzare la risposta per la richiesta Target. Maggiori dettagli sono disponibili in mbox_debug.pdf.
mboxDebug=x-cookie Modifica il cookie
mboxDisable=1 Disattiva le mbox sulla pagina
mboxDebug=x-profile Visualizza i profili impostati.
mboxDebug=x-time Mostra il tempo di risposta per ogni richiesta Target
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.
NOTA

Verificare che il frammento URL sia dopo i parametri della stringa di query. Tutto ciò che segue la prima # è un identificatore di frammento e causa il mancato funzionamento dei parametri di debug.

Adobe Experience Cloud Debugger

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. Effettuate l'autenticazione nel Experience Cloud e potete utilizzare il potente strumento MboxTrace per ispezionare le qualifiche dell'attività e dell'audience nonché il profilo del visitatore.

Per ulteriori informazioni, vedi i video di formazione seguenti:

Per ulteriori informazioni, vedere Debug at.js utilizzando Adobe Experience Cloud Debugger.

Se target.js non viene caricato durante la distribuzione

Se target.js non viene caricato durante la distribuzione, mbox.js invia al visitatore il cookie “em-disabled”. Questo cookie impedisce alle offerte create tramite il Compositore esperienza visivo di essere visualizzate sul sito. I visitatori con questo cookie non vedono il contenuto del test né vengono conteggiati in tali rapporti di attività. Tutti gli altri contenuti dell’offerta (da campagne in Target Classic per esempio) continuano ad essere caricati. Il cookie ha una durata di 30 minuti dal momento del caricamento non riuscito.

Gli articoli più venduti non compaiono in Consigli

La chiamata SiteCatalyst: purchase non può essere utilizzata per i dati di traffico dell'algoritmo di acquisto. Utilizzate invece la chiamata orderConfirmPage.

Verifica priorità attività

Le attività basate su moduli create con Target Standard/Premium potrebbero entrare in conflitto con le attività create nell'interfaccia Target Classic che hanno la stessa priorità e utilizzano la stessa richiesta Target.

Il codice personalizzato non produce i risultati previsti in Internet Explorer 8.

Target non supporta più Internet Explorer 8.

Il contenuto JavaScript fornito dalla richiesta Target globale non viene caricato quando si utilizza mbox.js.

Effettua l’aggiornamento a mbox.js versione 58 o successiva.

mbox.js versione 58 e successive esegue contenuto non JavaScript per la richiesta globale Target subito dopo la presenza del tag HTML BODY. Il contenuto JavaScript all'interno dei tag <script> per la richiesta globale Target viene eseguito dopo l'attivazione dell'evento DOMContentLoaded. Questo ordine di distribuzione dei contenuti garantisce che il contenuto JavaScript per la richiesta globale Target sia consegnato e rappresentato correttamente.

Il cookie di destinazione non viene impostato

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 viene visualizzato momentaneamente o non viene visualizzato se un elemento fa anche parte della personalizzazione AEM.

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.

Errore nella consegna di offerte di reindirizzamento e offerte remote a causa di un URL non valido.

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 Target può contenere /* invalid redirect offer URL */

Oppure

Per le offerte remote, la risposta Target può contenere /* invalid remote offer URL */

È possibile controllare la risposta Target nel browser o utilizzando mboxTrace. Per ulteriori informazioni sugli URL validi, consulta https://tools.ietf.org/html/std66.

Le richieste Target non vengono attivate sul sito.

at.js non attiva le richieste Target se utilizzi un doctype non valido. at.js richiede il doctype HTML5.

Video di formazione

I video seguenti contengono ulteriori informazioni sui concetti descritti in questo articolo.

Aggiungi estensione Badge di esercitazione

Debug di destinazione di base badge di esercitazione

Traccia mbox Badge delle esercitazioni

In questa pagina