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 si configura Target nella pagina per verificare che la richiesta 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, è 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 visualizza informazioni dettagliate sul contenuto. mboxTrace mostra i dettagli sulla tua campagna o attività e profilo. Fornisce inoltre un’istantanea del profilo prima dell’esecuzione e un’istantanea di ciò che è cambiato 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 visualizzano il tuo normale design Recommendations.

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.

Gli articoli più venduti non compaiono in Recommendations

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.

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 Adobe Experience Manager.

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 risolvere questa situazione, puoi disabilitare la personalizzazione AEM sulle 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.

TargetLe richieste di 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.

Assicurati che Target le attività gestiscono correttamente gli URL con parametri di stringa di query.

La 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, la Compositore esperienza visivo (VEC) apre la pagina specificata nel Impostazioni del Compositore esperienza visivo. Puoi anche specificare una pagina diversa durante la creazione dell’attività.

Per visualizzare una pagina diversa dopo l’apertura del Compositore esperienza visivo, fai clic sul pulsante Icona Configura ingranaggio > seleziona Consegna pagine > quindi specifica l’URL desiderato nel URL attività campo .

Configurare l’interfaccia utente delle impostazioni di Consegna pagine

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:

Opzione 1: Replicare l'URL e mantenerlo nella regola del modello con l'opzione "contiene".

Questa opzione assicura che questo URL sia idoneo per l’attività, ma tieni presente che sono presenti casi d’angolo 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:

Replicare l’URL nelle regole del modello

Opzione 2: Limita la condizione URL "contiene" solo con la stringa di query.

Il caso d’angolo 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:

La regola del modello contiene solo la stringa di query

Opzione 3: Invece di eseguire il targeting dell’URL completo, sfrutta una parte specifica dell’URL.

In questo caso, l’URL è https://shopping.mycart.com?type=Summers%20Offers e regole di modello aggiuntive specificano un Query con type > è (distinzione maiuscole/minuscole) > type=Summers%20Offers, separati da un operatore OR:

Regola del modello che sfrutta una parte specifica dell’URL

Video di formazione

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

Aggiungi estensione Icona Tutorial

Debug di base per Adobe Target Icona tutorial

mboxTrace Icona Tutorial

In questa pagina