registerPreTrackCallback

Letzte Aktualisierung: 2023-09-18
  • Themen:
  • Variables
    Weitere Informationen zu diesem Thema
  • Erstellt für:
  • User
    Admin

Mit der registerPreTrackCallback-Variablen kann Ihr Unternehmen eine JavaScript-Funktion verbinden, nachdem eine Bildanforderungs-URL kompiliert wurde, aber bevor sie gesendet wird. Mit dieser Variablen können Sie von AppMeasurement erfasste Daten an eine Partner- oder interne Infrastruktur senden.

WARNUNG

Führen Sie keine Tracking-Aufrufe durch, wie t() oder tl() innerhalb der registerPreTrackCallback -Variable. Das Festlegen von Tracking-Aufrufen in dieser Variablen führt zu einer Endlosschleife von Bildanforderungen!

Jedes Mal, wenn Sie die registerPreTrackCallback-Variable aufrufen, binden Sie diese Funktion jedes Mal ein, um sie bei jeder Kompilierung der URL einer Bildanforderung auszuführen. Vermeiden Sie es, dieselbe Funktion mehrmals mit demselben Seitenladevorgang zu registrieren.

HINWEIS

Der Zeitpunkt und die Reihenfolge der Funktionen, die zwischen registerPreTrackCallback und registerPostTrackCallback ausgelöst werden, sind nicht gewährleistet. Vermeiden Sie Abhängigkeiten zwischen diesen beiden Funktionen.

Rückruf-Vorverfolgung mit der Web SDK-Erweiterung

Das Web SDK kann eine Funktion nicht mehr hocken, nachdem Daten kompiliert wurden, aber bevor sie an Adobe gesendet werden. Sie können jedoch onBeforeEventSend um eine Funktion zu registrieren, die kurz vor dem Senden von Daten ausgeführt wird.

  1. Melden Sie sich bei Adobe Experience Platform-Datenerfassung Benutzeroberfläche mit Ihren Adobe ID-Anmeldeinformationen.
  2. Klicken Sie auf die gewünschte Tag-Eigenschaft.
  3. Navigieren Sie zu Erweiterungen und klicken Sie auf die Konfigurieren Schaltfläche unter Adobe Experience Platform Web SDK.
  4. under Datenerfassung, klicken Sie auf die Bearbeiten am vor dem Senden des Callback-Codes eines Ereignisses Schaltfläche.
  5. Platzieren Sie den gewünschten Code im Editor.

Rückruf-Vorverfolgung manuell zur Implementierung des Web SDK

Das Web SDK kann eine Funktion nicht mehr hocken, nachdem Daten kompiliert wurden, aber bevor sie an Adobe gesendet werden. Sie können jedoch onBeforeEventSend , um eine Funktion zu registrieren, die kurz vor dem Senden von Daten ausgeführt wird, ähnlich wie bei doPlugins. Siehe Globale Änderung von Ereignissen in der Web SDK-Dokumentation finden Sie weitere Informationen.

// Set the trackingCode XDM field to "New value"
alloy("configure", {
  "onBeforeEventSend": function(content) {
    content.xdm.marketing.trackingCode = "New value";
  }
})

Rückruf-Vorverfolgung mit der Adobe Analytics-Erweiterung

In der Adobe Analytics-Erweiterung gibt es kein eigenes Feld, um diese Variable zu verwenden. Verwenden Sie den Editor für benutzerdefinierten Code entsprechend der AppMeasurement-Syntax.

s.registerPreTrackCallback in AppMeasurement und im benutzerdefinierten Code-Editor der Analytics-Erweiterung

Die Funktion s.registerPreTrackCallback akzeptiert als einziges Argument eine Funktion. Die verschachtelte Funktion wird direkt vor dem Senden einer Bildanforderung ausgeführt.

s.registerPreTrackCallback(function(){/* Desired code */});

Wenn Sie die Bildanforderungs-URL im Code verwenden möchten, verweisen Sie auf das requestUrl-Zeichenfolgenargument in der verschachtelten Funktion. Sie können die requestUrl-Variable für Ihre gewünschte Verwendung parsen. Die Anpassung dieser Variable hat keine Auswirkungen auf die Datenerfassung.

s.registerPreTrackCallback(function(requestUrl){
  console.log(requestUrl); // Outputs the full image request URL
});

Sie können zusätzliche Argumente in die Funktion s.registerPreTrackCallback einfügen, die in der verschachtelten Funktion verwendet werden kann:

s.registerPreTrackCallback(function(requestUrl,a,b,c) {
    console.log(requestUrl); // Full image request URL
    console.log(a); // param1
    console.log(b); // param2
    console.log(c); // param3
}, "param1", "param2", "param3");
HINWEIS

Das Festlegen von Seitenvariablen oder das Ändern der requestUrl-Zeichenfolge in dieser Funktion hat keine Auswirkungen auf die Bildanforderung, die kurz nach diesem Funktionsaufruf gesendet wird. Verwenden Sie stattdessen die Variable doPlugins().

Auf dieser Seite