Dokumentation Target Target-Entwicklerhandbuch

Benutzerdefinierte at.js-Ereignisse

Letzte Aktualisierung: 5. Mai 2025

Themen:

Erstellt für:

Entwickler

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

Bisher ließ mbox.js (inzwischen nicht mehr unterstützt) anderen auf der Seite ausgeführten JavaScript-Code nicht wissen, was hinter den Kulissen passiert. 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	Artefakt bei der geräteinternen Entscheidungsfindung erfolgreich Konstante: `adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED` Zeichenfolgenwert: `artifactDownloadSucceeded` Beschreibung: Wird aufgerufen, wenn das Artefakt „On-Device Decisioning“ erfolgreich heruntergeladen wurde. Artefakt bei der geräteinternen Entscheidungsfindung fehlgeschlagen Konstante: `adobe.target.event.ARTIFACT_DOWNLOAD_FAILED` Zeichenfolgenwert: `artifactDownloadFailed` Beschreibung: Wird aufgerufen, wenn das Artefakt für die geräteinterne Entscheidungsfindung nicht heruntergeladen werden konnte.

Nutzung

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

Schulungsvideo: Antwort-Token und die benutzerdefinierten at.js-Ereignisse

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