Risoluzione dei problemi dei dati di Adobe Advertising in Customer Journey Analytics
Di seguito sono riportati i potenziali problemi, le loro possibili cause e le soluzioni.
Elenco di tutti i potenziali problemi
_experience.adcloud nel payload Experience Data Model (XDM) per i click-through.alloy() ha esito positivo (con una risposta 200), ma i dati di conversione di Adobe Advertising non sono presenti nei rapporti._experience.adcloud.Page Views) non sono disponibili per una dimensione di reporting (ad esempio Campaign) in CJA Customer Journey Analytics Workspace.Problemi di installazione e configurazione issues-installation-setup
L’estensione WebSDK non inizializza websdk-extension-doesn-initialize
Problemi:
- Nessuna chiamata alloy() visibile nella scheda Network dello strumento di ispezione del codice del browser.
- Errore della console: la lega non è definita.
- Non vengono effettuate richieste di interazione o raccolta a edge.adobedc.net.
Possibili cause e verifica/risoluzione
<head> per il tag di script //assets.adobedtm.com/....Stream di dati non configurato o non configurato correttamente datastream-not-configured-or-misconfigured
Problemi:
- Le richieste raggiungono Adobe Experience Platform Edge Network ma restituiscono errori 400 o 500.
- Nei rapporti di Adobe Analytics o Adobe Advertising non viene visualizzato alcun dato.
- Errore nella risposta di rete: “datastream non trovato”
Possibili cause e verifica/risoluzione
- In Tags, apri le impostazioni di configurazione dello stream di dati per la proprietà tag.
- Verificare che il campo Datastream punti allo stream di dati corretto per ogni ambiente (sviluppo, staging e produzione), nonché allo schema e al set di dati corretti.
Ogni ambiente deve avere un proprio flusso di dati, a meno che tu non condivida esplicitamente un flusso di dati in tutti e tre gli ambienti.
Aprire le impostazioni dello stream di dati e verificare che i servizi seguenti siano abilitati:
- Adobe Advertising (per conversione/sincronizzazione pubblico)
- Adobe Experience Platform (per l’acquisizione del profilo)
Advertising problemi di configurazione dell’estensione advertising-extension-setup-issues
Problemi:
-
Non vengono registrate conversioni view-through o click-through per la pagina web.
Per verificare se le conversioni sono registrate:
- Apri la pagina Web con
ef_id=test&s_kwcid=testaggiunto all’URL. - Apri lo strumento di ispezione del codice del browser (spesso denominato Inspect), apri la scheda Network e cerca una chiamata interattiva per event_type=“advertising.arricchment_ct” da Adobe Experience Platform.
- Nell’interfaccia di Data Collection, aprire la definizione dello schema per i dati del sito Web che si desidera raccogliere e confermare che
xdm->_experience->adcloud->conversionDetails->trackingCodeetrackingIdentitiescontengonoef_ides_kwcid.
- Apri la pagina Web con
-
Manca
_experience.adcloudnel payload Experience Data Model (XDM) per i click-through. -
Le conversioni vengono confermate in uno strumento di debug ma non vengono visualizzate nei rapporti di Adobe Advertising
Possibili cause e verifica/risoluzione
Adobe Advertising non è abilitato per lo stream di dati.-
In Tags, apri le impostazioni di configurazione dello stream di dati per la proprietà tag.
-
Abilita i seguenti servizi e salva le impostazioni:
- Adobe Advertising (per conversione/sincronizzazione pubblico)
- Adobe Experience Platform (per l’acquisizione del profilo)
Adobe Advertising non è abilitato per l’estensione WebSDK.Il componente Adobe Advertising all’interno dell’estensione WebSDK è disabilitato per impostazione predefinita e deve essere abilitato in modo esplicito prima che qualsiasi tracciamento per i click-through o le view-through di Adobe Advertising funzioni, indipendentemente dalla configurazione dello schema o delle regole XDM.
- In Tags, apri le opzioni di compilazione per la proprietà nelle impostazioni di configurazione di Adobe Experience Platform Web SDK.
- Abilita il componente Advertising e salva le impostazioni.
- Rigenera e ripubblica la libreria.
Adobe Advertising, il tracciamento dei click-through viene attivato automaticamente utilizzando i parametri di query URL s_kwcid e ef_id. Il tracciamento view-through è disattivato per impostazione predefinita e richiede una configurazione aggiuntiva. Vedere la riga successiva.- Abilitare il servizio Adobe Advertising per lo stream di dati
-
- Vai a Data Collection > Datastreams in Adobe Experience Platform e apri lo stream di dati utilizzato dalla proprietà Tags.
- Seleziona Aggiungi servizio, seleziona Adobe Advertising e Adobe Experience Platform, quindi seleziona Salva. Configurare gli inserzionisti in Adobe Advertising DSP
-
- In Tags, vai a Extensions > Installed > Adobe Experience Platform Web SDK > Configure.
- Nella sezione Advertiser, seleziona un inserzionista dal menu a discesa e abilitalo. Per configurare più inserzionisti, selezionare Aggiungi inserzionista. Verifica che i pixel di conversione view-through siano attivati
- In Adobe Experience Platform Debugger, confermare che la chiamata di interazione includa
stitchIdnel campoxdm.query. - Nella scheda Network dello strumento di ispezione del codice del browser, verificare che un evento con tipo
advertising.enrichmentsia stato attivato e includastitchIdinxdm.query.
Le conversioni view-through vengono attivate solo ogni 30 minuti, indipendentemente dal numero di visite. Se non vedi una chiamata di interazione, cancella la cache del browser e riprova.
Prima di aprire un ticket di supporto per Advertising problemi di configurazione dell’estensione, verifica quanto segue:
- I servizi Adobe Advertising e Adobe Experience Platform sono stati aggiunti allo stream di dati.
- Il componente Adobe Advertising è abilitato nella configurazione dell’estensione WebSDK.
- La libreria è stata ricreata e ripubblicata dopo l’abilitazione del componente.
- Per il tracciamento dei click-through, l’URL della pagina di destinazione contiene
s_kwcideef_idal clic dell’annuncio. - Per il tracciamento view-through, in Adobe Advertising DSP viene configurato un inserzionista con l’ID inserzionista corretto.
- La versione dell’estensione WebSDK è 2.36.0 o successiva.
Problemi relativi a identità ed ECID identity-and-ecid-issues
Problemi:
- L’ID visitatore cambia da una pagina all’altra.
- I segmenti di pubblico di Advertising non corrispondono.
Possibili cause e verifica/risoluzione
idMigrationEnabled è impostato su false mentre è presente un cookie s_ecid legacy.idMigrationEnabled: true nella configurazione di base di WebSDK per migrare l’ECID esistente dai cookie s_ecid o AMCV_.Le regole o gli eventi non attivano #rules-or-events-don’t-fire
Problemi:
- Il debugger mostra che le condizioni della regola non sono soddisfatte.
- L’azione Send Event non viene mai eseguita.
Verifica e risoluzione
Verifica quanto segue:
- La regola viene salvata e inclusa nella build della libreria attiva.
- Il tipo di evento corrisponde al comportamento effettivo della pagina (ad esempio Library Loaded rispetto a DOM Ready rispetto a Window Loaded).
- Le condizioni della regola non sono troppo restrittive. Effettua il test rimuovendo temporaneamente le condizioni per isolare il problema.
- Ordine delle regole corretto. Se più regole condividono lo stesso evento, controlla l’ordinamento regole.
- Nessun errore JavaScript precedente nella pagina sta interrompendo l’esecuzione. Controlla la console del browser per informazioni sulle eccezioni non rilevate.
Problemi di build e pubblicazione della libreria library-build-and-publishing-issues
Problemi:
- Le modifiche apportate in Tags non vengono applicate al sito attivo.
- È stato applicato un aggiornamento dell’estensione, ma il comportamento precedente persiste.
Possibili cause e verifica/risoluzione
Problemi di convalida dello schema per i campi Advertising schema-validation-for-advertising-fields
Problemi:
- La chiamata dell’evento di invio
alloy()ha esito positivo (con una risposta 200), ma i dati di conversione di Adobe Advertising non sono presenti nei rapporti. - Il payload XDM nel debugger non mostra alcun oggetto
_experience.adcloud.
Possibili cause e verifica/risoluzione
- Vai a Adobe Experience Platform > Data Management > Schemas.
- Apri lo schema utilizzato dallo stream di dati.
- Nel pannello Field Groups, verifica che sia elencata l’estensione completa Adobe Advertising Cloud ExperienceEvent.
- Se manca, seleziona Aggiungi, cerca Adobe Advertising Cloud, seleziona Estensione completa Adobe Advertising Cloud ExperienceEvent, quindi salva le impostazioni.
La ripubblicazione della libreria Tags non è necessaria solo per le modifiche dello schema, ma se sono stati aggiunti nuovi campi è necessario mappare nuovamente l’elemento dati XDM in Tags.
_experience.adcloud.conversionDetails. Vedi “Riferimento: campi schema obbligatori”.Se uno dei due campi non è presente, verifica che il gruppo di campi Estensione completa Adobe Advertising Cloud ExperienceEvent sia stato salvato nello schema, quindi aggiorna l’editor schema.
s_kwcid che ef_id, ad esempio https://www.example.com/landing-page?s_kwcid=AL!12345!3!abc123&ef_id=abc123xyz:G:s. Vedere “Riferimento: parametri di query mancanti” per le cause probabili.edge.adobedc.net e controlla il corpo della richiesta di interazione (vedi il payload di esempio riportato di seguito).Se
trackingCode o trackingIdentity sono vuoti o mancanti, allora a) il parametro di query non era presente nella pagina quando la regola è stata attivata (controlla l’URL e la tempistica degli eventi della regola) oppure b) il gruppo di campi non è presente nello schema (rivedi la prima riga precedente).Riferimento: campi schema obbligatori required-schema-fields
_experience.adcloud.conversionDetails.trackingCodes_kwcid nell’URL della pagina di destinazione._experience.adcloud.conversionDetails.trackingIdentityef_id nell’URL della pagina di destinazione.Riferimento: parametri di query mancanti missing-query-parameters
s_kwcidef_idEsempio di payload click-through
{
"events": [{
"xdm": {
"eventType": "advertising.clicks",
"_experience": {
"adcloud": {
"conversionDetails": {
"trackingCode": "AL!12345!3!abc123",
"trackingIdentity": "abc123xyz:G:s"
}
}
}
}
}]
}
Segnalazione dei problemi in Customer Journey Analytics Workspace
Reporting di riepilogo
- Verifica che Customer Journey Analytics Workspace faccia riferimento alla visualizzazione dati corretta.
- Verifica che il feed da Adobe Advertising a Customer Journey Analytics sia abilitato. Rivolgiti al team del tuo account Adobe.
- Conferma che il set di dati di dimensione/classificazione/ricerca di Adobe Advertising e il set di dati di riepilogo siano inclusi nella connessione Customer Journey Analytics.
- Conferma che le dimensioni di Adobe Advertising e le metriche di riepilogo siano incluse nella visualizzazione dati di Customer Journey Analytics.
Se verifichi tutte le impostazioni precedenti ma non visualizzi ancora i dati di riepilogo, apri un ticket di supporto per la tua organizzazione.
- Conferma che il feed da Adobe Advertising a Customer Journey Analytics sia abilitato per l’inserzionista 2. Rivolgiti al team del tuo account Adobe.
- Conferma che l’impostazione “Backfill all existing data” è abilitata per i tre set di dati (dimensione/classificazione/ricerca, riepilogo ed eventi) nella connessione Customer Journey Analytics.
Se verifichi tutte le condizioni di cui sopra ma non visualizzi ancora i dati di riepilogo, apri un ticket di supporto per la tua organizzazione.
Se il feed è abilitato per un account ma non vengono ancora visualizzati i dati di riepilogo, apri un ticket di supporto per la tua organizzazione. Includi Account ID per l’account di rete dell’annuncio.
- Conferma di utilizzare gli stessi intervalli di date sia in Workspace che nel rapporto di Adobe Advertising.
- Verificare che i filtri e i segmenti applicati in Workspace e nel report Adobe Advertising non causino differenze nei dati.
- Conferma che Time Zone per la visualizzazione dati di Customer Journey Analytics corrisponda a Default Timezone per il tuo account Advertising DSP.
- Conferma che l’impostazione “Backfill all existing data” è abilitata per i tre set di dati (dimensione/classificazione/ricerca, riepilogo ed eventi) nella connessione Customer Journey Analytics.
Se sei sicuro di una discrepanza di dati, apri un ticket di supporto per la tua organizzazione. Includi Account ID per l’account di rete dell’annuncio. Per mostrare le prove della discrepanza, includi schermate e fogli di calcolo. Se necessario, il team del tuo account Adobe può correggere retroattivamente il feed di dati per risolvere la discrepanza.
Reporting a livello di evento
Page Views) non sono disponibili per una dimensione di reporting (come Campaign) in Customer Journey Analytics Workspace.Verificare quanto segue, iniziando dagli elementi con il minor numero di barriere di verifica:
- Verifica di utilizzare la visualizzazione dati corretta.
- Conferma che le metriche di conversione applicabili siano eventi web/online, che Adobe Advertising può attribuire alle dimensioni.
- Conferma che Adobe Advertising stia tenendo traccia dei click-through e delle view-through sul sito applicabile.
- Nella connessione Customer Journey Analytics per il set di dati delle classificazioni, verificare che i valori per le impostazioni Key e Matching Key siano corretti: Key:
Tracking Code(_customername.adLens2.trackingCode), Matching Key:Tracking Code(event._experience.adcloud.conversionDetails.trackingCode). - Verificare che il servizio Adobe Advertising sia aggiunto allo stream di dati di Adobe Experience Platform, che lo schema mappato per lo stream di dati sia
XDM ExperienceEvent Schemae che il gruppo di campiAdobe Advertising Cloud ExperienceEvent Full Extensionsia aggiunto allo schemaXDM ExperienceEvent. - Verifica che le impostazioni di Adobe Advertising siano configurate correttamente nell’estensione WebSDK e pubblicate.
Se verifichi tutte le impostazioni precedenti ma non visualizzi ancora i dati di conversione, apri un ticket di supporto per la tua organizzazione. Includi Account ID per l’account di rete dell’annuncio.
Utili strumenti di convalida e debug
Adobe Experience Platform Debugger
Installa l’estensione Adobe Experience Platform Debugger per Chrome per:
- Visualizzazione in tempo reale di tutte le chiamate WebSDK
alloy() - Convalida dell’ID dello stream di dati e dell’ambiente
- Ispezione del payload XDM
- Dettagli delle richieste e delle risposte di Edge Network
Controlli chiave nel debugger:
advertising.enrichment.Scheda Network dello strumento di ispezione del codice del browser
Utilizza la scheda Network dello strumento di ispezione del codice del browser (spesso denominato “Inspect”) per effettuare le seguenti operazioni:
Filtra per edge.adobedc.net per esaminare le richieste Edge Network non elaborate:
- URL richiesta:
https://[org-id].data.adobedc.net/ee/v2/interact - Metodo:
POST - Stato:
200(integro),400(payload non valido) o500(errore del server o dello stream di dati)
Controlla il payload della richiesta per:
dataStreamIdcorretto- Presenza di un oggetto
xdmcon i campi previsti identityMapcon ECID popolato
Convalida della console
Verifica la versione di Web SDK installata:
window.alloy.version
Attiva manualmente un evento di test:
alloy("sendEvent", {
xdm: {
eventType: "web.webpagedetails.pageViews",
web: {
webPageDetails: { name: "Test Page", URL: window.location.href }
}
}
}).then(result => console.log("Edge response:", result))
.catch(err => console.error("Send event error:", err));
Elenco di controllo per riferimenti rapidi prima di richiedere assistenza
Verifica quanto segue prima di aprire un ticket di supporto:
- L’estensione WebSDK è nella versione più recente.
- La libreria viene pubblicata e il codice di incorporamento è corretto per l’ambiente.
- L’ID dello stream di dati viene impostato correttamente per lo sviluppo, la gestione temporanea e la produzione.
- Tutti i servizi dello stream di dati richiesti sono abilitati.
- Il componente Advertising è abilitato nella configurazione dell’estensione WebSDK ed è configurato un ID inserzionista DSP.
- Lo schema XDM include il gruppo di campi Advertising.
- La regola Send Event include una mappa di identità e viene attivata sull’evento corretto.
- Nessuna impostazione di privacy CSP o browser blocca le richieste Edge Network.
- L’Adobe Experience Platform Debugger conferma che gli eventi stanno raggiungendo Edge Network.
- Nessun errore JavaScript nella console del browser interrompe l’esecuzione.
- Il gruppo di campi
Adobe Advertising Cloud ExperienceEvent Full Extensionè stato aggiunto allo schema. _experience.adcloud.conversionDetails.trackingCodeè presente nello schema._experience.adcloud.conversionDetails.trackingIdentityè presente nello schema.- L’URL della pagina di destinazione contiene sia
s_kwcidcheef_idparametri al click-through. - Adobe Experience Platform Debugger conferma che
conversionDetailsè popolato nel payload in uscita.
Quando segnalare un problema
Contatta il team dell’account Adobe o il team di progettazione se:
- Le richieste di Edge Network restituiscono
500errori persistenti dopo la convalida dello stream di dati. - Advertising conversioni sono confermate nel debugger ma non vengono visualizzate nei rapporti dopo 24-48 ore.
- Un aggiornamento della versione di WebSDK introduce una regressione che non era presente nella versione precedente. Includi i numeri di versione specifici nel ticket di supporto.