Benutzerdefinierte at.js-Ereignisse

Informationen zu at.js custom events, die Sie darüber informieren, ob eine Mbox-Anforderung oder ein Angebot erfolgreich war oder fehlgeschlagen ist.

In der Vergangenheit ließ mbox.js (jetzt nicht mehr unterstützt) anderen JavaScript-Code, der auf der Seite ausgeführt wird, nicht wissen, was hinter den Kulissen geschieht. Dank der Weiterentwicklung von at.js konnten wir dieses Problem glücklicherweise beheben.

Laut unseren Kunden gibt es mehrere Szenarien, über die sie gerne informiert werden möchten, darunter:

  • Fehlschlagen einer Mbox-Abfrage aufgrund einer Zeitüberschreitung, des falschen Status-Codes, eines JSON-Parsingfehlers usw.
  • Erfolg einer Mbox-Abfrage
  • Fehlschlagen der Wiedergabe eines Angebots aufgrund eines fehlenden Wrapper-Mbox-Elements, eines nicht gefundenen Selektors usw.
  • Erfolg der Angebotswiedergabe. Anwendung von DOM-Änderungen.

Vordefinierte Ereignisse mit einer Struktur, die die Extrahierung von erforderlichen Daten je nach Ereignistyp ermöglicht

Sicherstellung, dass Ereignisse in verschiedenen Szenarien eingesetzt werden können, benutzerdefinierte Ereignisse über ein Nutzlastobjekt verfügen, das der Detaileinheit des Ereignisobjekts zugeordnet ist (und an den Handler übermittelt wird). Des Weiteren auch das Verhindern der Übermittlung von Zeichenfolgen wie Ereignisnamen. Die Ereignisse werden mithilfe des adobe.target.event-Namespace als Konstanten dargestellt.

Struktur

Schlüssel
Typ
Beschreibung
Typ
Zeichenfolge

Es gibt verschiedene Szenarien, in denen Sie über die Unterstützung in Bezug auf die Ablaufverfolgungs-, Debugging- und Anpassungsinteraktionen mit at.js benachrichtigt werden möchten.

Jedes im Folgenden aufgeführte benutzerspezifische Ereignis besitzt zwei Formate: eine „Konstante“ und einen „Zeichenfolgenwert“.

  • Konstante: adobe.target.event. vorangestellt, in Großbuchstaben dargestellt, enthalten Unterstriche. Verwenden Sie die Konstante, um benutzerspezifische Ereignisse zu abonnieren, nachdem at.js geladen, jedoch bevor die Mbox-Antwort empfangen wurde.
  • Zeichenfolgenwerte: Kleinbuchstaben, enthalten Gedankenstriche. Verwenden Sie den Zeichenfolgenwert, um benutzerspezifische Ereignisse zu abonnieren, bevor at.js geladen wird.

Anforderung fehlgeschlagen

Konstante: adobe.target.event.REQUEST_FAILED

Zeichenfolgenwert: at-request-failed

Beschreibung: Eine Mbox-Anfrage schlägt aufgrund eines Timeouts, eines falschen Status-Codes, eines JSON-Analysefehlers usw. fehl.

Anfrage erfolgreich

Konstante: adobe.target.event.REQUEST_SUCCEEDED

Zeichenfolgenwert: at-request-succeeded

Beschreibung: Eine Mbox-Anfrage war erfolgreich.

Inhaltsdarstellung fehlgeschlagen

Konstante: adobe.target.event.CONTENT_RENDERING_FAILED

Zeichenfolgenwert: at-content-rendering-failed

Beschreibung: Die Angebotsdarstellung schlug fehl, weil ein Mbox-Umbruchselement fehlt, die Auswahl nicht gefunden werden kann usw.

Inhaltsdarstellung erfolgreich

Konstante: adobe.target.event.CONTENT_RENDERING_SUCCEEDED

Zeichenfolgenwert: at-content-rendering-succeeded

Beschreibung: Die Angebotsdarstellung war erfolgreich. Anwendung von DOM-Änderungen.

Bibliothek geladen

Konstante: adobe.target.event.LIBRARY_LOADED

Zeichenfolgenwert: at-library-loaded

Beschreibung: Dieses Ereignis ist ideal geeignet, um nachzuverfolgen, wann at.js vollständig geladen wurde. Mit diesem Ereignis können Sie die Ausführung der globalen Mbox anpassen. Sie können dieses Ereignis auch verwenden, um die globale Mbox zu deaktivieren und dieses Ereignis anschließend zu überwachen, um die globale Mbox später auszulösen.

Start der Anfrage

Konstante: adobe.target.event.REQUEST_START

Zeichenfolgenwert: at-request-start

Beschreibung: Dieses Ereignis wird ausgelöst, bevor eine HTTP-Anfrage ausgeführt wird. Sie können dieses Ereignis für Leistungsmessungen mit der Resource Timing-API verwenden.

Start der Inhaltsdarstellung

Konstante: adobe.target.event.CONTENT_RENDERING_START

Zeichenfolgenwert: at-content-rendering-start

Beschreibung: Dieses Ereignis wird ausgelöst, bevor das Selektor-Polling gestartet und der Inhalt auf der Seite dargestellt wird. Sie können dieses Ereignis verwenden, um den Inhaltsdarstellungsfortschritt nachzuverfolgen.

Inhaltsdarstellung - keine Angebote

Konstante: adobe.target.event.CONTENT_RENDERING_NO_OFFERS

Zeichenfolgenwert: at-content-rendering-no-offers

Beschreibung: Dieses Ereignis wird ausgelöst, wenn keine Angebote zurückgegeben werden.

Umleitung der Inhaltsdarstellung

Konstante: adobe.target.event.CONTENT_RENDERING_REDIRECT

Zeichenfolgenwert: at-content-rendering-redirect

Beschreibung: Dieses Ereignis wird ausgelöst, wenn ein Angebot eine Umleitung ist und Target zu einer anderen URL umleitet.

mbox
Zeichenfolge
Name der Mbox
message
Zeichenfolge
Enthält für Menschen lesbare Beschreibungen, beispielsweise zu Geschehnissen, zur Fehlermeldung usw.
Verfolgung
Objekt
Enthält sessionId und deviceId. In einigen Fällen fehlt die deviceId möglicherweise, weil Target sie nicht vom Edge-Server abrufen konnte.
Typ
Zeichenfolge

Entscheidungsartefakt auf Gerät erfolgreich

Konstante:

adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED

Zeichenfolgenwert: artifactDownloadSucceeded

Beschreibung: Wird aufgerufen, wenn das auf dem Gerät bereitgestellte Entscheidungsartefakt erfolgreich heruntergeladen wurde.

Entscheidungsartefakt auf dem Gerät fehlgeschlagen

Konstante: adobe.target.event.ARTIFACT_DOWNLOAD_FAILED

Zeichenfolgenwert: artifactDownloadFailed

Beschreibung: Wird aufgerufen, wenn das on-device Decisioning-Artefakt nicht heruntergeladen werden konnte.

Nutzung

document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(event) {
  console.log('Event', event);
});

Schulungsvideo: Antwort-Token und der benutzerdefinierte at.js-Ereignisse Tutorial-Badge

Sehen Sie sich das folgende Video an, um zu erfahren, wie Sie mithilfe von Antwort-Token und benutzerspezifischen at.js-Ereignissen Profilinformationen von Target an Drittanbietersysteme weitergeben können.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3