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
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.
sessionId
und deviceId
. In einigen Fällen fehlt die deviceId
möglicherweise, weil Target sie nicht vom Edge-Server abrufen konnte.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
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.