at.js custom events
Information about at.js custom events
, which lets you know when an mbox request or offer fails or succeeds.
Historically, mbox.js (now deprecated) didn’t let other JavaScript code that runs on the page know what happens behind the scenes. With the advancement of at.js, we had a unique opportunity to fix this issue.
According to our customers there are several scenarios that they would like to be notified of, including:
- An mbox request failed due to timeout, wrong status code, JSON parse error, etc.
- An mbox request succeeded.
- Offer rendering failed due to wrapping mbox element missing, selector can not be found, etc.
- Offer rendering succeeded. DOM changes have been applied.
Pre-defined events have a structure that allows you to extract the required data, based on event type.
To make sure that events can be used in different scenarios, the custom events have a payload object that is assigned to the detail property of the event object (that is passed to the handler). Also to avoid passing strings as event names, the events are exposed as constants using adobe.target.event
namespace.
Structure
There are several scenarios in which you would like to be notified to help in tracing, debugging, and customizing interaction with at.js.
Each custom event listed below has two formats: a “constant” and a “string value.”
- Constants: Prepended with
adobe.target.event.
, presented in all caps, and contain underscore characters. To subscribe to custom events after at.js loads but before the mbox response has been received, use the constant. - String Values: Lowercase and contain dashes. To subscribe to custom events before at.js loads, use the string value.
Request Failed
Constant: adobe.target.event.REQUEST_FAILED
String value: at-request-failed
Description: An mbox request failed due to timeout, wrong status code, JSON parse error, etc.
Request Succeeded
Constant: adobe.target.event.REQUEST_SUCCEEDED
String Value: at-request-succeeded
Description: An mbox request was successful.
Content Rendering Failed
Constant: adobe.target.event.CONTENT_RENDERING_FAILED
String Value: at-content-rendering-failed
Description: Offer rendering failed due to wrapping mbox element missing, selector can not be found, etc.
Content Rendering Succeeded
Constant: adobe.target.event.CONTENT_RENDERING_SUCCEEDED
String Value: at-content-rendering-succeeded
Description: Offer rendering was successful. DOM changes have been applied.
Library Loaded
Constant: adobe.target.event.LIBRARY_LOADED
String Value: at-library-loaded
Description: This event is ideal to track when at.js has been fully loaded. You can use this event to customize global mbox execution. You can also use this event to disable the global mbox and then listen for this event to fire the global mbox later.
Request Start
Constant: adobe.target.event.REQUEST_START
String Value: at-request-start
Description: This event is fired before an HTTP request is executed. You can use this event for performance measurements using the Resource Timing API.
Content Rendering Start
Constant: adobe.target.event.CONTENT_RENDERING_START
String Value: at-content-rendering-start
Description: This event is fired before selector polling is started and content is rendered to the page. You can use this event to track the content rendering progress.
Content Rendering No Offers
Constant: adobe.target.event.CONTENT_RENDERING_NO_OFFERS
String Value: at-content-rendering-no-offers
Description: This event is fired when there are no offers returned.
Content Rendering Redirect
Constant: adobe.target.event.CONTENT_RENDERING_REDIRECT
String Value: at-content-rendering-redirect
Description: This event is fired when an offer is a redirect and Target will redirect to a different URL.
sessionId
and deviceId
. In some cases, deviceId
could be missing because Target couldn’t retrieve it from edge server.On-device decisioning artifact succeeded
Constant:
adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED
String value: artifactDownloadSucceeded
Description: Called when the on-device decisioning artifact is successfully downloaded.
On-device decisioning artifact failed
Constant: adobe.target.event.ARTIFACT_DOWNLOAD_FAILED
String Value: artifactDownloadFailed
Description: Called when the on-device decisioning artifact failed to download.
Usage
document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(event) {
console.log('Event', event);
});
Training Video: Response Tokens and the at.js Custom Events
Watch the following video to learn how to use Response Tokens and at.js Custom Events to share profile information from Target to third-party systems.