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.
  • Utilizza mboxTrace o mboxDebug per risolvere problemi relativi alla richiesta di Target.
  • Adobe Experience Cloud Debugger è uno strumento facile da usare che fornisce molte informazioni in comune con mboxDebug, per risolvere i problemi di richiesta di Target.

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.

Recuperare il token di autorizzazione per 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:

  • 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:

  1. Fai clic su Amministrazione > Implementazione.

  2. Dalla sezione Strumenti di debug, fai clic su Genera nuovo token di autenticazione.

    Generare un 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 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

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 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:

  • 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. Nella tabella seguente sono incluse informazioni sui parametri URL relativi a risposte di 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 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.
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 di 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

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.

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. 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 il debugger di Adobe Experience Cloud.

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 del traffico dell’algoritmo di acquisto. Utilizza al suo posto la chiamata orderConfirmPage.

Controllare la priorità dell’attività

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.

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

Target non supporta più Internet Explorer 8.

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

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

La versione 58 o successiva di mbox.js esegue il contenuto non-JavaScript per la richiesta globale di Target subito dopo il tag HTML BODY. Il contenuto JavaScript all’interno dei tag <script> per la richiesta globale di Target viene eseguito dopo che l’evento DOMContentLoaded è stato attivato. Questo ordine di consegna dei contenuti assicura che il contenuto JavaScript per la richiesta globale di Target sia consegnato e renderizzato correttamente.

Cookie di Target non 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 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.

Le richieste di Target non si attivano sul sito.

at.js non attiva le richieste di 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 Icona Tutorial

Debug Adobe Target di base Badge tutorial

mboxTrace Icona Tutorial

In questa pagina

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now