Debugging-Tools für Analytics-Implementierungen

Mit Debuggingwerkzeugen, manchmal auch als Paketanalysatoren oder Paketschnüffler bezeichnet, können Sie die Daten überprüfen, die Ihre Implementierung an Adobe sendet. Diese können Ihnen dabei helfen, zu überprüfen, ob Anforderungen erfolgreich ausgelöst werden, die in diesen Anforderungen enthaltenen Variablen und Payloads zu überprüfen und ein unerwartetes Implementierungsverhalten zu beheben.

Debugging-Tool auswählen

Die folgenden Kategorien können Ihnen bei der Auswahl eines Tools helfen, das auf dem basiert, was Sie untersuchen möchten.

Analytics- und Tag-Debugger

Analytics- und Tag-Debugger erkennen Analytics-Technologien und interpretieren deren Anfragen. Diese Tools können die Identifizierung von Adobe Analytics-Variablen, Experience Platform Web SDK-Payloads, Tags und zugehörigen Implementierungsinformationen erleichtern, ohne Netzwerkanfragen manuell zu decodieren.

Browser-Entwickler-Tools

Jeder moderne Browser verfügt über Entwickler-Tools, die Netzwerkanfragen untersuchen können, sodass Sie häufig kein separates Tool benötigen, um eine Web-Implementierung zu debuggen. Drücken Sie F12 oder Strg+Umschalt+I (Windows und Linux) oder Befehlstaste+Wahltaste+I (macOS) und wählen Sie dann die Registerkarte Netzwerk aus. Aktivieren Sie in Safari zunächst die Entwicklerfunktionen in den Safari-Einstellungen Erweitert.

HTTP(S)-Debugging-Proxys

HTTP-Debugging-Proxys fangen den HTTP- und HTTPS-Traffic zwischen einem Client und einem Server ab. Sie sind nützlich, wenn Browser-Entwickler-Tools keine ausreichende Sichtbarkeit bieten oder wenn die Implementierung außerhalb eines herkömmlichen Webbrowsers ausgeführt wird.

Die HTTPS-Inspektion erfordert im Allgemeinen, dass der Client so konfiguriert wird, dass er einem vom Debugging-Proxy bereitgestellten Zertifikat vertraut. Befolgen Sie die Sicherheitsrichtlinien Ihrer Organisation, wenn Sie Zertifikate installieren oder verschlüsselten Traffic abfangen.

Adobe Analytics-Anfragen suchen

Bei Implementierungen, die Daten direkt an Adobe Analytics senden, z. B. AppMeasurement, filtern Sie Netzwerkanfragen nach:

/ss/

Adobe Analytics-Sammlungsanfragen enthalten Analytics-Variablen in der Anfrage-URL oder Payload. Rohanfragen verwenden Abfrageparameternamen anstelle von Variablennamen. Beispielsweise wird eVar1 als v1 und prop1 als c1 angezeigt. Analytics-Debugger decodieren diese Namen für Sie. Informationen zum eigenständigen Decodieren finden Sie unter Variablenverweis in der Dokumentation zur Dateneinfüge-API .

Die HTTP-Status-Codes, die die Analytics-Datenerfassungs-Server zurückgeben, finden Sie HTTP-Antwort-Codes in der Dokumentation zur Data Insertion API.

Für Implementierungen, die Adobe Experience Platform Web SDK verwenden, filtern Sie Netzwerkanfragen nach:

/ee/

Wählen Sie die Anfrage aus und überprüfen Sie deren Payload, um die an Adobe Experience Platform Edge Network gesendeten Daten anzuzeigen. Web SDK sendet Daten an Edge Network, die dann Daten an Adobe Analytics und andere konfigurierte Services weiterleiten können. Die Überprüfung der Client-Anfrage überprüft, was der Browser an die Edge Network gesendet hat. Sie bestätigt nicht von sich aus, dass die Daten von jedem nachgelagerten Service erfolgreich verarbeitet wurden. Um zu sehen, wie Edge Network ein Ereignis verarbeitet hat, verwenden Sie Adobe Experience Platform Assurance.

Abgebrochene Anfragen

Wenn eine Seite die Seite verlässt, kann der Browser Anfragen abbrechen, die noch in Bearbeitung sind. Firefox kennzeichnet diese Anfragen NS_BINDING_ABORTED; Chrome und Edge kennzeichnen sie (canceled). Um Anfragen nach der Navigation sichtbar zu halten, aktivieren Sie Protokoll beibehalten (Chrome und Edge) oder Protokolle beibehalten (Firefox).

Eine abgebrochene Anfrage bedeutet nicht unbedingt, dass Daten verloren gegangen sind. Der Browser hat möglicherweise die vollständige Anfrage gesendet und nur auf die Antwort gewartet. Browser-Entwickler-Tools können den Unterschied normalerweise nicht anzeigen, ein HTTP-Debugging-Proxy jedoch schon.

Anfragen, die mit navigator.sendBeacon() gesendet werden, werden bei der Navigation nicht abgebrochen. AppMeasurement verwendet sendBeacon für Exitlinks und immer dann, wenn useBeacon aktiviert ist. Web SDK verwendet sie für Ereignisse, die mit documentUnloading gesendet werden. Wenn Linktracking-Anfragen häufig abgebrochen werden, verwenden Sie diese Optionen.