at.js version details
The Target team maintains only two versions of at.js—the current version and the second-latest version. Please upgrade at.js as necessary to ensure that you are running a supported version.
at.js version 2.1.1 (July 24, 2019)
This release of at.js is a maintenance release and includes the following enhancements and fixes:
(The issue numbers in parentheses are for internal Adobe use.)
- Fixed an issue that caused multiple beacons to fire when using the Click Tracking metric on the Goals & Settings page in the Visual Experience Composer (VEC). (TNT-32812)
- Fixed an issue that caused triggerView() to not render offers more than once. (TNT-32780)
- Fixed an issue with triggerView() to ensure that the request contains Marketing Cloud ID (MCID) information. (TNT-32776)
- Fixed an issue that prevented the triggerView() notification to fire even if there are no saved views. (TNT-32614)
- Fixed an issue that caused an error due to the use of decodeURIcomponent that caused issues when the URL contains a malformed query string parameter. (TNT-32710)
- The beacon flag is now set to "true" in the context of delivery requests sent via the Navigator.sendBeacon() API. (TNT-32683)
- Fixed an issue that prevented Recommendations offers from displaying on websites for a few customers. Customers could see the offer content in the delivery API call but the offer was not applied on the website. (TNT-32680)
- Fixed an issue that caused click-tracking across multiple experiences to not work as expected. (TNT-32644)
- Fixed an issue that prevented at.js from applying the second metric after the rendering of the first metric fails. (TNT-32628)
- Fixed an issue when passing mboxThirdPartyId using the targetPageParams function that caused the request payload to not be present in either the query parameters or in the request payload. (TNT-32613)
- Fixed an issue that caused display and click notification responses to be blocked in Chromium-based browsers (including Google Chrome). (TNT-32290)
at.js version 2.1.0 (June 3, 2019)
This release includes the following features and enhancements:
- Adobe Opt-in support : Adobe Opt-In is a way to simplify Adobe solutions integrations with consent management platforms. For more information about Adobe Opt-in, see Privacy and General Data Protection Regulation (GDPR) .
- Client-side analytics logging : Give customers full control on how they want to send analytics data to Adobe Analytics, whether on the client-side or server-side.For more information, see Client-side Analytics logging in Before you implement .
- Send notifications : Allow developers to send notifications when an experience is rendered by their code instead of using applyOffer() or applyOffers() .For more information, see adobe.target.sendNotifications(options) .
- at.js size reduced by ~24% : The size of at.js is reduced by ~24%. The smaller file size improves page load performance and reduces the time to download at.js on the page.
at.js version 2.0.1 (March 19, 2019)
This is a maintenance release and includes the following enhancements and fixes:
(The issue numbers in parentheses are for internal Adobe use.)
- Notifications that views were rendered have been decoupled from click-tracking event handlers. Initially, Target did not send notifications if click-event handlers belonging to a rendered view could not be attached. Target now sends a view notification even when click elements are not found. (TNT-31969)
- Fixed an issue that caused the request-succeeded event redirect flag to always be set to true. (TNT-31907)
- Fixed an issue that caused the VEC rearrange action to be logged as success, even when elements were missing. (TNT-31924)
- Fixed an issue that caused notifications for certain customers to not contain the Enterprise Permissions property token. (TNT-31999)
at.js version 1.7.1 (March 19, 2019)
This is a maintenance release and includes the following fix:
(The issue numbers in parentheses are for internal Adobe use.)
at.js Version 2.0.0
at.js 2.x provides rich feature sets that equip your business to execute personalization on next generation client-side technologies. This new version is focused on upgrading at.js to have harmonious interactions with single page applications (SPAs).
Here are some benefits of using at.js 2.x that are not available in previous versions:
- The ability to cache all offers on page load to reduce multiple server calls to a single server call.
- Tremendously improve your end-users' experiences on your site because offers are shown immediately via the cache without any lag time that traditional server calls introduce.
- Simple one-line of code and one-time developer setup to enable your marketers to create and run A/B and Experience (XT) activities via the Visual Experience Composer (VEC) on your single page applications.
at.js 2.x introduces the following new functions:
The following functions have been deprecated with the introduction of at.js 2.x:
If you require Adobe Opt-in support for the General Data Protection Regulation (GDPR), you must currently use at.js 1.7.0 or at.js 2.1.0.
at.js Version 1.7.0
at.js 1.7.0 brings Adobe Opt-In support. Adobe Opt-In is a way to simplify Adobe solutions integrations with consent management platforms.
For more information about Adobe Opt-in, see Privacy and General Data Protection Regulation (GDPR).
This release also fixes an issue where Target might override redirect URL parameters with parameters that are coming from the redirect URL.
at.js Version 1.6.4
at.js 1.6.4 is a maintenance release and addresses the following issue:
- Fixed a race condition manifesting in Microsoft Internet Explorer 11 that caused duplicate offers to be applied.
at.js Version 1.6.3
at.js version 1.6.3 includes the following fixes and enhancements:
- Selectors are now CSS-escaped if they contain IDs or CSS classes that start with a digit, two hyphens, or a hyphen followed by a digit (for example #-123). (TNT-31061)
- Fixed an issue introduced with at.js 1.6.2 where Visual Experience Composer (VEC) offers from different activities that apply to the same CSS selector did not respect activity priority. (TNT-31052)
- Fixed an issue with timing out a promise in environments where there was no native support for promises. (TNT-30974)
at.js Version 1.6.2
This is a maintenance release and addresses the following issue:
- Fixed an issue that on some customer sites lead to an infinite "async" loop.
In addition, at.js Version 1.6.2 also contains all of the enhancements and fixes included in at.js Version 1.6.1 and 1.6.0. These versions are no longer available for download. We recommend that you upgrade to version 1.6.2 if using 1.6.1 or 1.6.0
Here are the enhancements and fixes that were included in at.js Version 1.6.1:
- Fixed an issue in at.js 1.6.0 that caused recommendations experiences to be duplicated in Microsoft Internet Explorer 11. (TNT-30593)
- at.js now ensures that the edge override logic checks for the existence of an edge cluster cookie to avoid a different edge number if a user hops edges during a session. (TNT-30563)
- Fixed an issue that prevented at.js from executing subsequent actions if the HTML content contained invalid JS code. at.js now logs the error and renders the remaining actions without issue. (TNT-30546)
- Made changes so that there is an exception when a redirect page re-qualifies for a redirect activity. (TNT-30532)
- Fixed an issue that prevented the correct request timeout being propagated from the getOffer() API request. (TNT-30498)
- Fixed an issue that prevented at.js 1.6.0 from saving cookies when using file protocol. (TNT-30454)
- Fixed an issue that made it appear that not all experiences were being delivered with redirects when using Analytics for Target (A4T). (TNT-30444)
- Fixed an issue that caused the page to be hidden after the Target call succeeds. (TNT-30358)
Here are the enhancements and fixes that were included in at.js Version 1.6.0:
- Redirect offers are now automatically supported in the Analytics for Target (A4T) integration. The client-side workaround has been removed. (TNT-30247)
- Client-side edge routing is now enabled by default. (TNT-30261)
- Fixed an issue with Visual Experience Composer (VEC) action rendering when there are dependencies between actions. (TNT-30248)
at.js Version 1.5.0
at.js version 1.5.0 is now available.
- The details of the at-request-succeeded event contain the redirect flag. This flag can be used to determine if the page will be redirected to a different URL. If you want to know the URL, subscribe to at-content-rendering-redirect . (TNT-29834)
- Fixed an issue that caused window.targetGlobalSettings.enabled to fail with a runtime exception if it was set to false. (TNT-29829)
- Fixed an issue that caused the page to fail while loading in the Visual Experience Composer (VEC) if using custom code to a fire global mbox request and using body hiding. (TNT-29795)
- Added support for screenOrientation , devicePixelRatio , and webGLRenderer . These new Target request parameters are used for iPhone X and other modern device detection. For more information, see Mobile . (TNT-29781)
- Fixed an issue where the Adobe Audience Manager (AAM) location hint wasn't always sent. (TNT-29695)
- For browsers that support it, at.js 1.5.0 switches to MutationObserver for selector polling. Versions prior to at.js 1.0.0 used a MutationObserver polyfill, which proved to be problematic. To avoid the polyfill issues, version1.5.0 uses the following pseudo code to decide which scheduling mechanism to use:
if MutationObserver is supported scheduler = MutationObserver else if document is visible scheduler = requestAnimationFrame else scheduler = setTimeout
at.js Version 1.3.0
at.js version 1.3.0 is now available.
- The following new events are available to help in tracing, debugging, and customizing interaction with at.js:
For more information, see at.js custom events .
- You can augment an at.js request with additional parameters that come from data providers. Data providers should be added to window.targetGlobalSettings under the dataProviders key .For more information, see Data Providers .
- at.js requests now use GET, but it will switch to POST when the URL size exceeds 2048 characters. There is a new property named urlSizeLimit where you can increase the size limit if necessary. This change allows Target to align at.js to AppMeasurement, which uses the same technique.
- Target now enforces that the mbox key in the adobe.target.applyOffer(options) function is used. This key has been required in the past, but Target now enforces its use to ensure that Target has proper validation and customers are using the function correctly.
- at.js has improved event and click tracking functionality. at.js uses navigator.sendBeacon() to send event tracking data and will fallback to synchronous XHR when navigator.sendBeacon() is not supported. This fallback mostly affects Internet Explorer 10 and 11 and some versions of Safari. Safari will add support for navigator.sendBeacon() in the upcoming iOS 11.3 release.
- at.js can now render offers even when a page is opened in background tabs. Some Target Customers encountered an issue when requestAnimationFrame() was disabled because of the browser throttling behavior for background tabs.
- This release adds many performance improvements, including shorter callstacks when inspecting a Chrome CPU profile.
- at.js 1.3.0 no longer supports content delivery on Microsoft Internet Explorer 9. For a list of supported browsers, see Supported Browsers . Going forward, all requests are executed via XMLHttpRequest with CORS support with no JSONP requests. This change greatly improves security.
at.js Version 1.2.3
at.js version 1.2.3 is now available.
- Adds support for JSON offers. JSON offers are supported only in activities created using the Form-based Experience Composer. Currently the only way to use JSON offers is via direct API calls. See Create JSON Offers .
at.js Version 1.2.2
at.js version 1.2.2 is now available.
- Fixed an issue that caused Target click tracking to break Analytics data collection calls. (TNT-28261)
- Fixed an issue that caused getOffer() params to fail when targetPageParams() returns an empty string. (TNT-28359)
- Fixed an issue with session ID generation when using x-only. (TNT-28361)
at.js Version 1.2.1
at.js version 1.2.1 is now available.
- Fixed an issue when click tracking on a link with target="_blank" prevented Target from opening the link in a new tab.
at.js Version 1.2.0
at.js version 1.2 is now available as a maintenance release that contains mostly bug fixes.
- Fixed an issue that prevented default actions for click-tracking special cases. (TNT-28089)
- Fixed an issue when click-tracking on a link with target="_blank" that prevented Target from opening the link in a new tab. (TNT-28072)
- IP addresses can be used as the cookie domain. (TNT-28002)
- Fixed an issue that caused flicker in redirect offers with a global mbox or other regional mboxes. (TNT-27978)
- Fixed an issue in Experience Targeting activity setup failing within the VEC when switching between Browse and Compose. (TNT-27942)
- Fixed incorrect handling on flicker style classes for click-track elements. (TNT-27896)
- Fixed an issue that caused global mbox parameters to become mixed up with all mbox parameters. (TNT-27846)
- Made changes to ensure that Handlebars, Mustache, and other client-side templating libraries are properly handled by at.js. (TNT-27831)
- Made changes to ensure that sdidParamExpiry is properly initialized and passed to the Visitor API. This is a regression that has been added to at.js 1.1.0 . Previous at.js versions are not affected. This affects only clients using redirect offers and A4T. (TNT-27791)
- Made changes to ensure that SCRIPT is executed regardless of the type attribute being used. (TNT-27865)
at.js Version 1.1.0
Date: August 2, 2017
The following enhancements and fixes are included in at.js version 1.1:
- Added response token handling. For more information, see Response Tokens .
- Resolved issue so that document.currentScript polyfill doesn't interfere with Angular 1.X.
- Made changes to ensure that click tracking doesn't interfere with visibility property. Click tracking elements are marked with the at-element-click-tracking CSS class instead of at-element-marker .
at.js Version 1.0.0
Date: July 7, 2017
The following enhancements and fixes are included at.js version 1.0:
- Support for loading at.js asynchronously for faster page loads.
- Support for pre-hiding page content when loading at.js asynchronously.
- Better error messaging when content delivery is disabled.
- Performance improvements when delivering multiple activities.
- Support for YUI Compressor.
- Bug/error reporting for custom events during activity delivery.
- Fix for performance issues in Microsoft Internet Explorer 11.
- Fix for getOffer() function giving an error on some websites.
- Load the Target library asynchronously. For more information, see at.js Frequently Asked Questions .
at.js Version 0.9.7
Date: May 22, 2017
The following enhancements and fixes are included in at.js version 0.9.7:
- Fixed an issue related to an asset key that was missing from insertAfter and insertBefore actions in the Visual Experience Composer (VEC). These issues were related to the migration from visual offers to offer templates.
at.js Version 0.9.6
Date: April 13, 2017
The following enhancements and fixes are included in at.js version 0.9.6:
- Redirect offer support for A4T. After you download and install at.js version 0.9.6, you can use redirect offers in activities that use Adobe Analytics as the Reporting Source for Target (A4T). Besides at.js version 0.9.6, there are other minimum requirements your implementation must meet in order to use redirect offers and A4T. For more information and additional important information you should know, see Redirect Offers - A4T FAQ .
- Prior to at.js 0.9.6, when the Visitor API was present on the page and the visitorApiTimeout setting was too aggressive, Target could run into a situation when no MCID data was sent in the Target request. This could lead to issues like unstitched hits in Analytics when using A4T.This behavior has been changed in at.js 0.9.6, even if the visitorApiTimeout is set to say 1 ms, Target will try to collect SDID, tracking servers, and customer IDs data and send those in the Target request.
- Added the selectorsPollingTimeout setting. For more information, see targetGlobalSettings() .
- The format of the response from getOffer() has been changed. For more information, see adobe.target.getOffer(options) .
- Console logging has been added for unsupported <!DOCTYPE> declarations.
- Fixed an issue where Target Classic plugins weren’t being applied correctly when multiple default offers were delivered to a single mbox. (TGT-22664) For more information, see Plug-Ins in the Adobe Target Classic documentation.
- Improved cookie-setting for two letter top-level-domains (TLDs) to ensure that the mbox cookie is set correctly for these domains (for example, test.no, autodrives.ca, and so forth).
- The algorithm for extracting the top-level domain that should be used when saving cookies has changed in at.js version 0.9.6. Because of this change, cookies cannot be saved to addresses that use IP. Most of the time, IP addresses are used for testing purposes, but as workarounds you can use DNS entries or adjust the hosts file on a local box.
- Fixed move and rearrange actions handling when properties are string values instead of integers.
at.js Version 0.9.4
Date: January 19, 2017
- mbox names can now contain special characters, including ampersands ( & ), to be consistent with naming requirements for mbox names using mbox.js.For a list of allowable special characters, see at.js Configurations .
- Added secureOnly setting that indicates whether at.js should use HTTPS only or be allowed to switch between HTTP and HTTPS based on the page protocol. This is an advanced setting that defaults to False and can be overridden via targetGlobalSettings .
- The Legacy Browser Support option is available in at.js version 0.9.3 and earlier. This option was removed in at.js version 0.9.4.
at.js Version 0.9.3
Date: October 10, 2016
- Ensures mbox calls fire in Microsoft Internet Explorer 11 when legacy browsers are disabled in the at.js settings.
- Ensures that default content is rendered if a dynamic remote offer fails (for example, if the URL is incorrect and returns a 404 error).
- Ensures that elements are revealed quickly when VEC click-tracking selectors can't be found in the DOM.
at.js Version 0.9.2
Date: September 21, 2016
- Added an optoutEnabled setting to enable or disable the Device Graph opt-out. If this setting is set to true and the visitor has opted out of tracking, the visitor's browser will not make any mbox calls. Device Graph is currently in Beta. This setting is set to false by default, but must be set to true if you are using Device Graph. A similar option is part of mbox.js v61.
- Added CustomEvent support for the notification mechanism. Previously, the at.js event notification mechanism could not be used via standard DOM APIs, such as document.addEventListener() . Now you can use document.addEventListener() to subscribe to at.js events, such as request events and content rendering events.
- Fixed an issue related to offers created in the Visual Experience Composer (VEC). Prior to this release, Target hid the selectors and un-hid them only when all selectors matched. In at.js 0.9.2 Target un-hides the selectors as soon as they are matched.
at.js Version 0.9.1
Date: July 14, 2016
- Provides at.js a timeout for the Visitor Id Service, which is independent of the service’s own timeout.
- Corrects an issue in 0.9.0 that impacted implementations using at.js on some pages and mbox.js on other pages.
- If you use Adobe Analytics as your activity's reporting source, you do not need to specify a tracking server during activity creation if you are using mbox.js version 61 (or later) or at.js version 0.9.1 (or later). The mbox.js or at.js library automatically sends tracking server values to Target. During activity creation, you can leave the Tracking Server field empty on the Goals & Settings page.
at.js Version 0.9.0
Target Release: 16.6.1
Date: June 23, 2016
- Fixes a whitescreen issue when using VEC offers. Anyone using at.js should upgrade to this new version.
- New registerExtension API.This new API gives developers access to certain jQuery modules used in at.js to develop extensions (aka plugins) for the library. There are a few implications for this change. This impact only those users who are using these features:
- getSettings() API has been removed, but the same functionality is available using registerExtension() .
- getTracking() API has been removed, but the same functionality is available using registerExtension() .
- Existing extensions (e.g. AngularJS extensions) must be updated to use the registerExtension() approach.
- New at.js notification] API.The goal of this notification system is to provide more insight into what at.js is doing on the page and when there are issues. A common issue seen with the VEC is that an IT release changes the page, a VEC selector breaks, and the test stops delivering content correctly. A goal of this notification system is to make this delivery issue known to the page, so developers can access this information, pass it to a system like Adobe Analytics, and alerts can be sent to the business owners that their test broke.
- New targetGlobalSettings() API method.You can override settings in the at.js library, rather than configuring the settings in the Target Standard/Premium UIor by using REST APIs.
at.js Version 0.8.0
Date: May 5, 2016.
This is the first official release of the at.js library.
at.js is a new implementation library for Target designed for both typical web implementations and single-page applications.
at.js replaces mbox.js for Adobe Target implementations.
Although at.js replaces mbox.js, mbox.js will continue to be supported. For most people, at.js provides advantages over mbox.js. This gives you time to test at.js and to change the implementation on your pages.
Among other benefits, at.js improves page load times for web implementations, improves security, and provides better implementation options for single-page applications.
at.js contains the components that were included in target.js, so there is no longer a call to target.js.
When implementing at.js, be aware of the following:
- Internet Explorer versions earlier than 8 are not supported.
- Asynchronous implementation means legacy integrations like the Test&Target to SiteCatalyst plugin may not work.
- Target plugins that reference mbox.js objects and methods are not supported.
- All calls to Target are made via XMLHTTPRequest and content is returned via JSON.