Fehlerbehebung bei Adobe Advertising-Daten in Customer Journey Analytics
Im Folgenden finden Sie mögliche Probleme, deren mögliche Ursachen und Lösungen.
Liste aller potenziellen Probleme
_experience.adcloud fehlt in der Experience-Datenmodell (XDM)-Payload für Clickthroughs.alloy() send-Ereignisaufruf ist erfolgreich (mit einer Antwort von 200), aber in den Berichten fehlen Adobe Advertising-Konversionsdaten._experience.adcloud Objekt an.Page Views) sind für eine Reporting-Dimension (z. B. Campaign) in CJA Customer Journey Analytics Workspace nicht verfügbar.Probleme mit der Installation und Einrichtung issues-installation-setup
WebSDK-Erweiterung initialisiert nicht. websdk-extension-doesn-initialize
Probleme:
- Auf der Registerkarte “Network” des Code-Inspektions-Tools Ihres Browsers sind keine Alloy(s)-Aufrufe sichtbar.
- Konsolenfehler: Legierung ist nicht definiert.
- Es werden keine Interaktions- oder Sammlungsanfragen an edge.adobedc.net gestellt.
Mögliche Ursachen und Überprüfung/Lösung
<head>-Tag nach der Umgebung für das //assets.adobedtm.com/...-Skript-Tag.edge.adobedc.net and assets.adobedtm.com zu Ihren CSP-connect-src und script-src-Anweisungen hinzu.Datenstrom nicht oder falsch konfiguriert datastream-not-configured-or-misconfigured
Probleme:
- Anfragen erreichen Adobe Experience Platform Edge Network, geben jedoch 400- oder 500-Fehler zurück.
- In Adobe Analytics- oder Adobe Advertising-Berichten werden keine Daten angezeigt.
- Fehler in der Netzwerkantwort: „Datenstrom nicht gefunden“
Mögliche Ursachen und Überprüfung/Lösung
- Öffnen Sie in Tags die Datenstromkonfigurationseinstellungen für Ihre Tag-Eigenschaft.
- Vergewissern Sie sich, dass das Feld Datastream auf den richtigen Datenstrom für jede Umgebung (Entwicklung, Staging und Produktion) sowie auf das richtige Schema und den richtigen Datensatz verweist.
Jede Umgebung sollte über einen eigenen Datenstrom verfügen, es sei denn, Sie geben explizit einen Datenstrom für alle drei Umgebungen frei.
Öffnen Sie die Datenstromeinstellungen und stellen Sie sicher, dass die folgenden Services aktiviert sind:
- Adobe Advertising (für Konvertierung/Zielgruppensynchronisierung)
- Adobe Experience Platform (für die Profilaufnahme)
Setup-Probleme bei Advertising-Erweiterungen advertising-extension-setup-issues
Probleme:
-
Für die Web-Seite werden keine Viewthrough- oder Clickthrough-Konversionen aufgezeichnet.
So überprüfen Sie, ob Konvertierungen aufgezeichnet wurden:
- Öffnen Sie die Web-Seite, wobei
ef_id=test&s_kwcid=testan die URL angehängt wird. - Öffnen Sie das Code-Inspektions-Tool Ihres Browsers (häufig als Inspect bezeichnet), öffnen Sie die Registerkarte Network und suchen Sie nach einem Interaktionsaufruf für event_type=„advertising.enrichment_ct“ aus Adobe Experience Platform.
- Öffnen Sie in der Datenerfassungsschnittstelle Schemadefinition für die Website-Daten, die Sie erfassen möchten, und bestätigen Sie, dass
xdm->_experience->adcloud->conversionDetails->trackingCodeundtrackingIdentitiesef_idunds_kwcidenthalten.
- Öffnen Sie die Web-Seite, wobei
-
_experience.adcloudfehlt in der Experience-Datenmodell (XDM)-Payload für Clickthroughs. -
Konvertierungen werden in einem Debugger-Tool bestätigt, werden jedoch nicht in Adobe Advertising-Berichten angezeigt
Mögliche Ursachen und Überprüfung/Lösung
Adobe Advertising-Service ist für den Datenstrom nicht aktiviert.-
Öffnen Sie in Tags die Datenstromkonfigurationseinstellungen für Ihre Tag-Eigenschaft.
-
Aktivieren Sie die folgenden Dienste und speichern Sie die Einstellungen:
- Adobe Advertising (für Konvertierung/Zielgruppensynchronisierung)
- Adobe Experience Platform (für die Profilaufnahme)
Adobe Advertising ist für die WebSDK nicht aktiviert.Die Adobe Advertising innerhalb der WebSDK-Erweiterung ist standardmäßig deaktiviert und muss explizit aktiviert werden, damit das Tracking für Adobe Advertising-Clickthroughs oder -Viewthroughs funktioniert, unabhängig davon, wie das XDM-Schema oder die Regeln konfiguriert sind.
- Öffnen Sie in Tags die Build-Optionen für die Eigenschaft in den Konfigurationseinstellungen von Adobe Experience Platform Web SDK.
- Aktivieren Sie die Komponente Advertising und speichern Sie die Einstellungen.
- Bibliothek neu erstellen und erneut veröffentlichen.
Adobe Advertising aktiviert ist, wird das Clickthrough-Tracking automatisch über die s_kwcid und ef_id URL-Abfrageparameter aktiviert. Das View-Through-Tracking ist standardmäßig deaktiviert und erfordert eine zusätzliche Konfiguration - siehe nächste Zeile.- Aktivieren des Adobe Advertising-Service für den Datenstrom
-
- Gehen Sie in Adobe Experience Platform zu Data Collection > Datastreams und öffnen Sie den von Ihrer Tags-Eigenschaft verwendeten Datenstrom.
- Wählen Sie Service hinzufügen, wählen Sie Adobe Advertising und Adobe Experience Platform aus und klicken Sie dann auf Speichern. Konfigurieren von Advertisern in Adobe Advertising DSP
-
- Navigieren Sie in Tags zu Extensions > Installed > Adobe Experience Platform Web SDK > Configure.
- Wählen Sie im Abschnitt Advertiser einen Advertiser aus der Dropdown-Liste aus und aktivieren Sie ihn. Um mehrere Advertiser zu konfigurieren, wählen Sie Advertiser hinzufügen aus. Stellen Sie sicher, dass durchsichtige Konvertierungspixel ausgelöst werden
- Bestätigen Sie in der Adobe Experience Platform Debugger, dass der Interaktionsaufruf
stitchIdunter dem Feldxdm.queryenthält. - Bestätigen Sie auf der Registerkarte Network im Code-Inspektions-Tool Ihres Browsers, dass ein Ereignis vom Typ
advertising.enrichmentausgelöst wird, dasstitchIdunterxdm.queryenthält.
View-Through-Konversionen werden nur alle 30 Minuten ausgelöst, unabhängig von der Anzahl der Besuche. Wenn kein Interaktionsaufruf angezeigt wird, löschen Sie den Browser-Cache und versuchen Sie es erneut.
Bevor Sie ein Support-Ticket für Probleme bei der Einrichtung Advertising Erweiterung öffnen, überprüfen Sie Folgendes:
- Die Services Adobe Advertising und Adobe Experience Platform werden zum Datenstrom hinzugefügt.
- Die Komponente Adobe Advertising ist in der WebSDK-Erweiterungskonfiguration aktiviert.
- Die Bibliothek wurde nach der Aktivierung der Komponente neu erstellt und erneut veröffentlicht.
- Für das Clickthrough-Tracking enthält die Landingpage-URL
s_kwcidundef_idfür den Anzeigenklick. - Für das View-Through-Tracking wird in Adobe Advertising DSP ein Advertiser mit der richtigen Advertiser-ID konfiguriert.
- Die WebSDK-Erweiterung ist Version 2.36.0 oder höher.
Identitäts- und ECID-Probleme identity-and-ecid-issues
Probleme:
- Die Besucher-ID ändert sich zwischen den Seiten.
- Advertising-Zielgruppensegmente stimmen nicht überein.
Mögliche Ursachen und Überprüfung/Lösung
idMigrationEnabled ist auf false gesetzt, während ein Legacy-s_ecid vorhanden ist.idMigrationEnabled: true in der WebSDK-Basiskonfiguration fest, um die vorhandene ECID aus den s_ecid- oder AMCV_-Cookies zu migrieren.Regeln oder Ereignisse werden nicht ausgelöst rules-or-events-don-t-fire
Probleme:
- Der Debugger zeigt an, dass die Regelbedingungen nicht erfüllt sind.
- Die Send Event Aktion wird nie ausgeführt.
Verifizierung und Lösung
Überprüfen Sie Folgendes:
- Die Regel wird gespeichert und in den aktiven Bibliotheks-Build) .
- Der Ereignistyp entspricht dem tatsächlichen Seitenverhalten (z. B. Library Loaded vs. DOM Ready vs. Window Loaded).
- Die Bedingungen der Regel sind nicht zu restriktiv. Testen Sie durch vorübergehendes Entfernen von Bedingungen, um das Problem zu isolieren.
- Die Regelreihenfolge ist korrekt. Wenn mehrere Regeln dasselbe Ereignis gemeinsam haben, überprüfen Sie die Regelreihenfolge.
- Keine JavaScript-Fehler weiter oben auf der Seite stoppen die Ausführung. Überprüfen Sie die Browser-Konsole auf nicht erfasste Ausnahmen.
Probleme beim Erstellen und Veröffentlichen von Bibliotheken library-build-and-publishing-issues
Probleme:
- In Tags durchgeführte Änderungen werden nicht auf der Live-Site angezeigt.
- Eine Aktualisierung der Erweiterung wurde angewendet, aber das alte Verhalten bleibt bestehen.
Mögliche Ursachen und Überprüfung/Lösung
Probleme bei der Schemavalidierung für Advertising-Felder schema-validation-for-advertising-fields
Probleme:
- Der
alloy()send-Ereignisaufruf ist erfolgreich (mit einer Antwort von 200), aber in den Berichten fehlen Adobe Advertising-Konversionsdaten. - Die XDM-Payload im Debugger zeigt kein
_experience.adcloudObjekt an.
Mögliche Ursachen und Überprüfung/Lösung
- Navigieren Sie zu Adobe Experience Platform > Data Management > Schemas.
- Öffnen Sie das von Ihrem Datenstrom verwendete Schema.
- Bestätigen Sie im Field Groups, dass Adobe Advertising Cloud ExperienceEvent Full Extension aufgeführt ist.
- Wenn er fehlt, klicken Sie auf Hinzufügen, suchen Sie nach Adobe Advertising Cloud, wählen Sie Adobe Advertising Cloud ExperienceEvent Full Extension aus und speichern Sie dann die Einstellungen.
Das erneute Veröffentlichen Ihrer Tags-Bibliothek ist nicht nur für Schemaänderungen erforderlich, sondern Sie müssen das XDM-Datenelement in Tags neu zuordnen, wenn neue Felder hinzugefügt wurden.
_experience.adcloud.conversionDetails vorhanden sind. Siehe “Referenz: Erforderliche Schemafelder”.Wenn eines der Felder fehlt, überprüfen Sie, ob die Feldergruppe Adobe Advertising Cloud ExperienceEvent Full Extension im Schema gespeichert wurde, und aktualisieren Sie dann den Schema-Editor.
s_kwcid als auch die ef_id Parameter enthalten, z. B. https://www.example.com/landing-page?s_kwcid=AL!12345!3!abc123&ef_id=abc123xyz:G:s. Siehe “Referenz: fehlende Abfrageparameter” für mögliche Ursachen.edge.adobedc.net und überprüfen Sie den Textkörper der Interaktions-Anfrage (siehe die Beispiel-Payload unten).Wenn
trackingCode oder trackingIdentity leer sind oder fehlen, a) war der Abfrageparameter zum Zeitpunkt der Regelauslösung nicht auf der Seite vorhanden (überprüfen Sie die URL und den Ereigniszeitpunkt der Regel) oder b) die Feldergruppe fehlt im Schema (besuchen Sie die erste Zeile oben).Referenz: Erforderliche Schemafelder required-schema-fields
_experience.adcloud.conversionDetails.trackingCodes_kwcid Abfrageparameter in der Landingpage-URL._experience.adcloud.conversionDetails.trackingIdentityef_id Abfrageparameter in der Landingpage-URL.Referenz: fehlende Abfrageparameter missing-query-parameters
s_kwcidef_idBeispiel für Clickthrough-Payload
{
"events": [{
"xdm": {
"eventType": "advertising.clicks",
"_experience": {
"adcloud": {
"conversionDetails": {
"trackingCode": "AL!12345!3!abc123",
"trackingIdentity": "abc123xyz:G:s"
}
}
}
}
}]
}
Melden von Problemen in Customer Journey Analytics Workspace
Zusammenfassende Berichte
- Vergewissern Sie sich, dass Customer Journey Analytics Workspace auf die richtige Datenansicht verweist.
- Vergewissern Sie sich, dass der Feed von Adobe Advertising an Customer Journey Analytics aktiviert ist. Wenden Sie sich an Ihr Adobe-Accountteam.
- Vergewissern Sie sich, dass Ihre Adobe Advertising-Dimension/Ihr Klassifizierungs-/Lookup-Datensatz und Ihr Zusammenfassungsdatensatz in Ihrer Customer Journey Analytics-Verbindung enthalten sind.
- Vergewissern Sie sich, dass Ihre Adobe Advertising-Dimensionen und Zusammenfassungsmetriken in Ihrer Customer Journey Analytics-Datenansicht enthalten sind.
Wenn Sie alle oben genannten Einstellungen überprüfen, aber immer noch keine Zusammenfassungsdaten sehen, öffnen Sie ein Support-Ticket für Ihr Unternehmen.
- Vergewissern Sie sich, dass der Feed von Adobe Advertising an Customer Journey Analytics für Advertiser 2 aktiviert ist. Wenden Sie sich an Ihr Adobe-Accountteam.
- Vergewissern Sie sich, dass die Einstellung “Backfill all existing data” für Ihre drei Datensätze (Dimension/Klassifizierung/Suche, Zusammenfassung und Ereignismetriken) in Ihrer Customer Journey Analytics-Verbindung aktiviert ist.
Wenn Sie alle oben genannten Bedingungen überprüfen, aber immer noch keine Zusammenfassungsdaten sehen, öffnen Sie ein Support-Ticket für Ihr Unternehmen.
Wenn der Feed für ein Konto aktiviert ist, aber immer noch keine Zusammenfassungsdaten angezeigt werden, öffnen Sie ein Support-Ticket für Ihr Unternehmen. Fügen Sie die Account ID für das Anzeigennetzwerkkonto ein.
- Vergewissern Sie sich, dass Sie dieselben Datumsbereiche sowohl in Workspace als auch im Adobe Advertising-Bericht verwenden.
- Vergewissern Sie sich, dass alle Filter und Segmente, die in Workspace und im Adobe Advertising-Bericht angewendet werden, keine Datenunterschiede verursachen.
- Vergewissern Sie sich, dass der Time Zone für Ihre Customer Journey Analytics-Datenansicht mit dem Default Timezone für Ihr Advertising DSP-Konto übereinstimmt.
- Vergewissern Sie sich, dass die Einstellung “Backfill all existing data” für Ihre drei Datensätze (Dimension/Klassifizierung/Suche, Zusammenfassung und Ereignismetriken) in Ihrer Customer Journey Analytics-Verbindung aktiviert ist.
Wenn Sie sich einer Datendiskrepanz sicher sind, öffnen Sie ein Support-Ticket für Ihr Unternehmen. Fügen Sie die Account ID für das Anzeigennetzwerkkonto ein. Um Beweise für die Diskrepanz zu zeigen, fügen Sie Screenshots und Tabellen hinzu. Ihr Adobe-Konto-Team kann den Daten-Feed bei Bedarf nachträglich korrigieren, um die Diskrepanz zu beheben.
Reporting auf Ereignisebene
Page Views) sind für eine Reporting-Dimension (z. B. Campaign) in Customer Journey Analytics Workspace nicht verfügbar.Überprüfen Sie Folgendes, beginnend mit den Elementen mit den geringsten Überprüfungsbarrieren:
- Vergewissern Sie sich, dass Sie die richtige Datenansicht verwenden.
- Vergewissern Sie sich, dass es sich bei den entsprechenden Konversionsmetriken um Web-/Online-Ereignisse handelt, die Adobe Advertising Dimensionen zuordnen kann.
- Vergewissern Sie sich, dass Adobe Advertising Clickthroughs und Viewthroughs auf der entsprechenden Site verfolgt.
- Überprüfen Sie in der Customer Journey Analytics-Verbindung für den Klassifizierungsdatensatz, ob die Werte für die Key- und Matching Key korrekt sind: Key:
Tracking Code(_customername.adLens2.trackingCode), Matching Key:Tracking Code(event._experience.adcloud.conversionDetails.trackingCode). - Vergewissern Sie sich, dass der Adobe Advertising-Service zum Adobe Experience Platform-Datenstrom hinzugefügt wird, dass das zugeordnete Schema für den Datenstrom
XDM ExperienceEvent Schemaist und dass die FeldergruppeAdobe Advertising Cloud ExperienceEvent Full ExtensionzumXDM ExperienceEventhinzugefügt wird. - Vergewissern Sie sich, dass die Adobe Advertising-Einstellungen in der WebSDK-Erweiterung korrekt konfiguriert und veröffentlicht sind.
Wenn Sie alle oben genannten Einstellungen überprüfen, aber immer noch keine Konversionsdaten sehen, öffnen Sie ein Support-Ticket für Ihr Unternehmen. Fügen Sie die Account ID für das Anzeigennetzwerkkonto ein.
Nützliche Validierungs- und Debugging-Tools
Adobe Experience Platform Debugger
Installieren Sie die Adobe Experience Platform Debugger für Chrome für:
- Eine Echtzeitansicht aller WebSDK-
alloy() - Datenstrom-ID und Umgebungsprüfung
- XDM-Payload-Überprüfung
- Edge Network-Anfrage- und -Antwortdetails
Schlüsselprüfungen im Debugger:
advertising.enrichment Ereignistyp.Network Registerkarte des Code-Inspektions-Tools Ihres Browsers
Verwenden Sie die Registerkarte “Network” des Code-Inspektions-Tools Ihres Browsers (oft als “Inspect” bezeichnet), um Folgendes durchzuführen:
Filtern Sie nach edge.adobedc.net, um unformatierte Edge Network-Anfragen zu überprüfen:
- Anfrage-URL:
https://[org-id].data.adobedc.net/ee/v2/interact - Methode:
POST - Status:
200(fehlerfrei),400(fehlerhafte Payload) oder500(Server- oder Datenstromfehler)
Payload der Anfrage überprüfen auf:
- Die richtige
dataStreamId - Das Vorhandensein eines
xdmmit den erwarteten Feldern - Ein
identityMapmit ausgefüllter ECID
Konsolenvalidierung
Überprüfen Sie die installierte WebSDK-Version:
window.alloy.version
Manuelles Trigger eines Testereignisses:
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));
Checkliste mit Kurzanleitungen vor der Anforderung von Support
Überprüfen Sie Folgendes, bevor Sie ein Support-Ticket öffnen:
- Die WebSDK-Erweiterung verwendet die neueste Version.
- Die Bibliothek wird veröffentlicht und der Einbettungs-Code ist für die Umgebung korrekt.
- Die Datenstrom-ID ist für Entwicklung, Staging und Produktion korrekt festgelegt.
- Alle erforderlichen Datenstrom-Services sind aktiviert.
- Die Advertising-Komponente wird in der WebSDK-Erweiterungskonfiguration aktiviert und eine DSP Advertiser-ID wird konfiguriert.
- Das XDM-Schema umfasst die Advertising Feldergruppe .
- Die Send Event-Regel enthält eine Identitätszuordnung und wird für das richtige Ereignis ausgelöst.
- Keine CSP- oder Browser-Datenschutzeinstellungen blockieren Edge Network-Anfragen.
- Die Adobe Experience Platform Debugger bestätigt, dass Ereignisse die Edge Network erreichen.
- Keine JavaScript-Fehler in der Browser-Konsole stoppen die Ausführung.
- Die
Adobe Advertising Cloud ExperienceEvent Full ExtensionFeldergruppe wird dem Schema hinzugefügt. _experience.adcloud.conversionDetails.trackingCodeist im Schema vorhanden._experience.adcloud.conversionDetails.trackingIdentityist im Schema vorhanden.- Die Landingpage-URL enthält sowohl
s_kwcid- als auchef_id-Parameter beim Clickthrough. - Adobe Experience Platform Debugger bestätigt, dass
conversionDetailsin der ausgehenden Payload ausgefüllt ist.
Wann ein Problem eskaliert werden muss
Wenden Sie sich an Ihr Adobe Account Team oder Ihr Engineering-Team, wenn:
- Edge Network-Anfragen geben nach der Validierung des Datenstroms persistente
500zurück. - Advertising Konvertierungen werden im Debugger bestätigt, aber nach 24-48 Stunden nicht mehr in Berichten angezeigt.
- Eine WebSDK-Versionsaktualisierung führt eine Regression ein, die in der vorherigen Version nicht vorhanden war. Schließen Sie die spezifischen Versionsnummern in das Support-Ticket ein.