Debuggen und Fehlerbehebung bei der Datenerfassung

Zum Debuggen der Datenerfassung müssen Sie sowohl das Verhalten Ihrer Implementierung als auch die Auswirkungen auf die gesendeten Daten überprüfen. Beginnen Sie mit dem Symptom und folgen Sie dann dem Ereignis durch jede Phase der Erfassung, bis Sie feststellen, wo es nicht mehr wie erwartet funktioniert.

Die Debug-Protokollierung macht SDK-Befehle, Tag-Ausführung, Warnungen und Fehler im Browser oder zur Laufzeit des Programms verfügbar. Die Anforderungsüberprüfung stellt Payloads, Antworten und für unterstützte Workflows die Server-seitige Verarbeitung bereit. Diese Ansätze ergänzen sich häufig gegenseitig: Ein Protokoll kann erklären, warum ein Ereignis verzögert wurde, während eine Netzwerkaufzeichnung zeigen kann, ob eine Anfrage gesendet wurde.

Ereignis durch Sammlung verfolgen diagnostic-workflow

Untersuchen Sie die folgenden Schritte der Reihe nach. Der Nachweis, dass eine Stufe erfolgreich war, belegt nicht, dass auch spätere Stufen erfolgreich waren.

  1. Implementierungsausführung: Wurde der SDK-Befehl oder die Tag-Regel ausgeführt? Überprüfen Sie Diagnosemeldungen und -fehler. Wenn die Einverständnis- oder Identitätsbehandlung ein Ereignis verzögert, untersuchen Sie diesen Status, bevor Sie nach einer Netzwerkanfrage suchen. Siehe Debug-Protokollierung aktivieren.
  2. Ausgehende Anfrage: Wurde die Anfrage gesendet und enthielt sie die erwarteten Daten? Überprüfen Sie die Payload und vergleichen Sie sie mit Ihren Befehlseingaben oder Datenelementen. Siehe Web-Anfragen überprüfen oder Mobile- und Server-Anfragen überprüfen.
  3. Server-Empfang: Hat der Sammlungsendpunkt die Anfrage erhalten? Überprüfen Sie die Antwort, sofern verfügbar, oder verwenden Sie eine unterstützte Server-seitige Ablaufverfolgung. Ein Client-Protokoll, das angibt, dass eine Anfrage gesendet wurde, ist keine Empfangsbestätigung.
  4. Edge-Verarbeitung und -Routing: Hat das Ereignis den vorgesehenen Datenstrom und die konfigurierten Services verwendet? Bei Web SDK zeigt der configId der Anfrage, ​ verwendeten Datenstrom und Edge Trace wie die Edge Network das Ereignis verarbeitet hat.
  5. Nachgelagerte Verarbeitung: Akzeptierte und verarbeitete das Ziel das Ereignis erwartungsgemäß? Verwenden Sie die produktspezifische Debugging Anleitung des Ziels. Eine erfolgreiche Antwort von Edge Network ist kein Beweis dafür, dass Daten in jedem nachgelagerten Bericht oder Store verfügbar sind.

Startpunkt wählen choose-a-starting-point

In der folgenden Tabelle sind nützliche Hinweise für häufige Aufgaben aufgeführt. Wenn beide Ansätze gelten, beantworten sie verschiedene Teile der Untersuchung. Die verfügbaren Nachrichten und Tools hängen von Ihrer SDK, der Laufzeit und den konfigurierten Services ab.

Aufgabe oder Symptom
Debug-Protokollierung
Prüfung anfordern
Nächste Prüfung
Ein erwartetes Ereignis wird nicht angezeigt
Überprüfen Sie die Ausführung von Befehlen oder Regeln, Fehler und Meldungen über Einverständnis- oder Identitätsverzögerungen.
Überprüfen Sie, ob eine Anfrage gesendet wurde, und überprüfen Sie die Payload und die Antwort.
Beginnen Sie mit Protokollierung und prüfen Sie Anfragen. Informationen zu identitätsbezogenen Symptomen finden Sie unter Fehlerbehebung bei Identitäten.
Eine Anfrage enthält unerwartete Daten
Vergleichen Sie SDK-Befehlseingaben und die Tag-Ausführung mit den Werten, die Sie senden wollten.
Überprüfen Sie die tatsächlich ausgehende Payload und vergleichen Sie sie mit Edge Trace, wenn Umwandlungen beteiligt sind.
Überprüfen Sie Datenelemente, Befehlseingaben und Datenstromkonfiguration.
Eine Anfrage erscheint während der Navigation als abgebrochen
Überprüfen Sie, ob die SDK versucht hat, das Ereignis zu senden, oder ob sie es noch hielt.
Überprüfen Sie die Anfrage und nach Möglichkeit die Serverantwort oder Edge Trace. Allein die abgebrochene Beschriftung des Browsers ist nicht schlüssig.
Siehe Abgebrochene Anfragen und Web SDK documentUnloading.
Anfragen scheinen erfolgreich, aber Zieldaten fehlen
Legen Sie fest, welche Konfiguration und welche Eingaben von der Implementierung verwendet werden. Die nachgelagerte Verarbeitung kann durch Client-Protokolle nicht bestätigt werden.
Verwenden Sie Edge Trace, Assurance und zielspezifische Diagnosen.
Überprüfen Sie den Datenstrom, die aktivierten Services, das Routing und die Zielverarbeitung. Siehe Verfolgen der Edge NetworkVerarbeitung und Produktspezifisches Debugging.
Ereignisse erscheinen dupliziert
Suchen Sie nach wiederholten Befehlsaufrufen oder der Ausführung von Tag-Regeln.
Vergleichen Sie Anfragenanzahl, Payloads und Kennungen. Mehrere Client-Anfragen sind nicht die einzige mögliche Quelle für Duplikate.
Untersuchen Sie weitere Zustellversuche und einen mindestens einmaligen Versand sowie die wiederholte Ausführung durch den Client. Siehe Umgang mit Ereignisduplikaten.
Eine Mobile- oder Server-Implementierung verhält sich unerwartet
Überprüfen Sie die SDK-Ausgabe in der Anwendungs- oder Server-Laufzeit und nicht nur in der Browser-Konsole.
Verwenden Sie Assurance für unterstützte mobile Workflows oder überprüfen Sie den HTTP-Traffic der Anwendung. Browser-Tools können die ausgehenden Aufrufe Ihres Servers nicht anzeigen.
Siehe Protokollierung mobiler SDK und Server-SDK und Überprüfen von Mobil- und Server-Anfragen.

Produktspezifisches Debugging product-specific

Die Artikel in diesem Abschnitt gelten für alle Experience Platform-Datenerfassungen. Adobe-Programme, die Ihre Daten erhalten, können ihre eigenen Endpunkte, Anfrageformate, Validierungsansichten und Verarbeitungsformate verwenden. Nachdem Sie bestätigt haben, dass der Edge Network ein Ereignis empfangen und weitergeleitet hat, oder wenn Ihre Implementierung Daten direkt an eine Anwendung sendet, fahren Sie mit den Debugging-Anleitungen dieser Anwendung fort:

Untersuchung fortsetzen next-steps

Entfernen Sie vor der Freigabe von Protokollen, Traces oder Netzwerkaufnahmen Anmeldeinformationen, Besucherkennung und andere vertrauliche Informationen gemäß den Richtlinien Ihrer Organisation.

recommendation-more-help
experience-platform-help-collection