Adobe Target Tag Setup Guide
This article describes how to set up the Adobe Target tag.
Adobe Target gives marketers the necessary capabilities to continually make their online content and offers more relevant to their customers, yielding greater conversion.
Tag tips
- This template requires utag version v4.26 or above. For more information about updating the
utag.js
template, see our knowledge base article Best Practices for Updating to the Latest Version of utag.js. - If you want to use the Adobe Experience Cloud ID Service, add the Adobe Experience Cloud ID Service tag BEFORE this tag.
- Scope your Adobe Target Extension to this tag.
- The Timeout setting is a failsafe in case the Target server may not be responding. For best performance, do not set this value to less than 5000 ms.
- Unbundling is not supported in this tag. If you set Bundle Flag to
No
, the value is overwritten asYes
. - Response objects received from
getOffers
are placed into theu.offersReceived
array.
getOffers response objects example
The contents of the response from getOffers
resembles the following:
{
"prefetch": {
"mboxes": [{
"index": 0,
"name": "a1-serverside-xt",
"options": [{
"content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
"type": "html",
"eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
"responseTokens": {
"profile.memberlevel": "0",
"geo.city": "anytown",
"activity.id": "167169",
"experience.name": "USA Experience",
"geo.country": "countryname"
}
}],
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
}
}
}]
}
}
This response is placed in the u.offersResponse
array. Then, the u.applyOffers()
function is called to parse the u.offersResponse
array, which calls Adobe Target’s aaplyOffers()
method to pass in each offer parsed.
Tag configuration
Navigate to the Tag Marketplace to add a new tag. For more information, see About tags.
When adding the tag, configure the following settings:
- Code Version: The version of Adobe Target to use. To learn more, see Adobe Target version details.
- Client Code: The client name (for example,
mycompany
in themycompany.tt.omtrdc.net
) - Timeout: Set this value to
5000
or greater. This is time (in milliseconds) to wait for a response from Target before assuming the Target server is not responding. - Adobe Org ID: Used with the visitor tracking across Adobe Target and Site Catalyst. Found in the
mbox.js
var imsOrgId = 'XXXXXXXXXXXXXXXXXXXXXXXX@AdobeOrg'
- Library Endpoint Path: The path variable in the library call (generally does not need changing).
- Authoring Script URL: If you are authoring targeted content, enter the authoring script URL (for example:
//cdn.tt.omtrdc.net/cdn/target-vec.j
). - Auto Create Global mbox: Whether to automatically create the globally-hidden mbox. Only set this to
false
if you implement the mbox elsewhere. - Global mbox Name: Adobe typically uses
target-global-mbox
for the name of the globally hidden mbox. This tag automatically calls mboxCreate to create this mbox.
Load rules
Load the tag on all pages or set conditions for when your tag will load. For more information, see About load rules.
Data mappings
Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For more information, see About data mappings.
The available categories are:
Standard
Variable | Description |
---|---|
config.clientCode |
Client Code |
config.imsOrgId |
Adobe Organization ID |
config.serverDomain |
Server Domain, the domain where Adobe Target requests are sent. |
config.crossDomain |
Enable Cross Domain |
config.timeout |
Target Timeout |
config.globalMboxName |
Global Mbox Name |
config.globalMboxAutoCreate |
Enable Global Mbox Creation [Boolean] |
config.endpoint |
Library Endpoint Path |
config.defaultContentHiddenStyle |
Default Content Hidden Style |
config.defaultContentVisibleStyle |
Default Content Visible Style |
config.bodyHiddenStyle |
Body Hidden Style. A style to use when hiding the BODY element. The default value is body{opacity:0} . |
config.bodyHidingEnabled |
Enbale Body Hidding [Boolean]. When you enable this setting, the BODY element is hidden to prevent window flickering. |
config.deviceIdLifetime |
Device ID Lifetime [Number] |
config.sessionIdLifetime |
Session ID Lifetime [Number] |
config.selectorsPollingTimeout |
Selectors Polling Timeout [Number] |
config.visitorApiTimeout |
Visitor API Timeout [Number] |
config.overrideMboxEdgeServer |
Enable Mbox Edge Server Override |
config.overrideMboxEdgeServerTimeout |
Override Mbox Edge Server Timeout [Number] |
config.optoutEnabled |
Enable Opt-out [Boolean] |
config.optinEnabled |
Enable Opt-in [Boolean] |
config.secureOnly |
Secure Requests Only [Boolean] |
config.pageLoadEnabled |
Enable Page Load [Boolean] |
config.viewsEnabled |
Enable Views [Boolean] |
config.authoringScriptUrl |
Authoring Script URL |
config.decisioningMethod |
Decisioning Method |
Track Events
Variable | Type | Description |
---|---|---|
evt.mbox |
String | Mbox Name |
sevt.elector |
String | CSS Selectors |
evt.type |
String | HTML Event Type |
evt.preventDefault |
Boolean | Use Prevent Default |
evt.params |
Object | Mbox Parameters |
evt.params.### |
String | Mbox Parameters Item |
evt.timeout |
Integer | Timeout |
evt.success |
Function | Success Function |
evt.error |
Function | Error Function |
Parameters
Variable | Description |
---|---|
mboxParams.### |
mboxParams.### |
targetPageParamsAll.### |
targetPageParamsAll.### |
targetPageParams.### |
targetPageParams.### |
targetPageParams.at_property |
targetPageParams.at_property |
Multiple Offers and SPA
Variable | Description |
---|---|
request_type |
[prefetch or execute] Get Offers Request Type |
offers.fetchViews |
Fetch All Views |
offers.consumerId |
Consumer ID |
offers.timeout |
Request Timeout |
offers.id.tntId |
Request ID - tntId |
offers.id.thirdPartyId |
Request ID - thirdPartyId |
offers.id.marketingCloudVisitorId |
Request ID - marketingCloudVisitorId |
offers.experienceCloud.analytics.logging |
Adobe Analytics Integration - Logging Type |
offers.views |
Views Array - Array |
offers.pageLoad |
PageLoad Object - Object |
offers.mboxes |
Mboxes Array |
offers.decisioningMethod |
Decisioning Method |
selector |
CSS Selectors - Array |
offersResponse |
Response Object |
viewName |
View Name |
countPage |
Increase Impression Count - Boolean |
This page was last updated: May 10, 2023