Documente Academic
Documente Profesional
Documente Cultură
Contents
Dynamic Tag Management Product Documentation............................................5
Release Notes for Dynamic Tag Management.......................................................7
Getting Started.......................................................................................................10
Planning for Dynamic Tag Management................................................................................11
Managing Users and the Publish Workflow...........................................................................12
Web Properties......................................................................................................21
Create a web property...........................................................................................................25
Data Elements........................................................................................................27
Create a data element...........................................................................................................32
Contents
Rules.......................................................................................................................68
Event-Based Rules Example.................................................................................................70
Page Load Rules Example....................................................................................................72
Page Load Rules - Advanced...................................................................................................................75
FTP.......................................................................................................................................92
Library Download..................................................................................................................93
Videos
Request access
Deploy Adobe Analytics
Deploy Adobe Target (New)
Deploy Media Optimizer (New)
Frequently asked questions
Troubleshooting
Plugins
DTM Switch Plugins
Community Resources
Solution Overview
Marketing Cloud Forum
Adobe Marketing Cloud Community
Idea Exchange
Adobe Training and Tutorials
Featured Solutions Center
Digital Marketing Blog
#Dynamic Tag Management
Description
October 28 2014
New features in dynamic tag management released on October 28, 2014:
Feature
Description
Updated the Adobe Target tool to enable automatic deployment via dynamic
tag management.
See Adobe Target Settings for configuration information.
August 7 2014
New features:
Feature
Description
You can automate the deployment of the Marketing Cloud ID Service using
dynamic tag management.
See Marketing Cloud ID Service in Dynamic Tag Management Help.
Getting Started
10
Getting Started
Information for new users of dynamic tag management.
Requesting Access to Dynamic Tag Management
Logging In
Getting Started Tasks
Videos
In EnterpriseTV, click Analytics > Dynamic Tag Management.
Requesting Access to Dynamic Tag Management
Before you start using dynamic tag management, someone from your company must request access. Your request
will be fielded by our provisioning team and you should receive your login credentials within one to two business
days.
Request Access to Dynamic Tag Management
If you have access to the Adobe Marketing Cloud, you can also request access to dynamic tag management from
the Tools menu.
Note: Administrators, see Getting Started in the Marketing Cloud if you need access to the Marketing Cloud.
Logging In
Browse to https://dtm.adobe.com.
Getting Started Tasks
The steps in the following table help you get up and running with dynamic tag management.
Step
Location
Description
Installation: Create a
web property.
Getting Started
Step
11
Location
Description
Adobe provides staging and production embed code so you
can test your changes in your staging environment. After you
install the embed code, add tools and create rules.
Overview tab
Configure your
deployment options.
Embed tab
Embed tab
Getting Started
12
To make the most of dynamic tag manager, establish a clear vision of how you want to use digital marketing. For
help with planning, Adobe offers consulting on best practices. Also, a number of consulting agencies across the
globe have extensive experience deploying dynamic tag management and helping transform your organization's
productivity, workflows, and sophistication.
Approvers
Publishers
Publish rules to the production site. Only approved rules are published.
Administrators
Create and manage users, as well as inheriting rights from the three preceding roles.
Publishing Workflow
1.
2.
3.
4.
5.
A rule is saved.
The saved rule is funneled into the approval queue, where the details of the rule can be viewed in summary.
The Approver, Approver & Publisher, or Admin level user approves the rule.
The rule goes into the publishing queue.
In the publishing queue, the Admin, Publisher, or Approver & Publisher level user must publish the rule before
it goes live.
If you make changes to a published rule, the changes are not published to the site until they have been funneled
through the approval process.
This ensures that only approved rules and rule revisions are published to your live site. This approval process
also retains all past and present revision information. This retention makes it easy to follow a rules history and
pin-points when an issue may have occurred.
13
Answer
You can create as many web properties as you want and write as
many rules as you want. You can also use it to deliver any digital
marketing service, even if you dont use it to deliver Adobe Digital
Marketing solutions. There is no effective limitation on your use of
the capability.
What if I am using Adobe TagManager? Do I Not for a while. Adobe supports TagManager until the end of 2014.
have to migrate?
For help in creating a strategy to implement dynamic tag
management, please contact your account manager.
With which Adobe Marketing Cloud solutions Dynamic tag management will support all of the Marketing Cloud
are dynamic tag management integrated?
solutions as well as any digital marketing service, regardless of
vendor.
Do I need to remove my Analytics or other
tags from my site to use dynamic tag
management?
Question
14
Answer
Does dynamic tag management work for apps Dynamic tag management currently only delivers JavaScript.
as well as sites?
However, we have integrations on the roadmap for delivering app
configuration files for Adobe Mobile in 2014.
Also, we are planning integrations with PhoneGap so that dynamic
tag management is available to any app built on that platform.
What third-party tags are supported by
dynamic tag management?
FAQ - Advanced
A FAQ about performance, rules, loading, hosting and so on.
Question
Answer
Question
15
Answer
dependencies to ensure the desired behavior is still accomplished
with asynchronous loading.
Performance: Will dynamic tag management Dynamic tag management has never shown signs of negatively
reduce my web site's performance?
effecting page load time or execution speed.
However, because dynamic tag management can be used as a
delivery system (a way to deliver JavaScript, HTML, images or other
Web content), if you load a large file, or a large image at the wrong
point during render time, you can slow down page load speed and
increase code execution time on that page. If you lazy load images,
and if you use asynchronous (non sequential) scripts as much as
possible, and you follow best practices regarding the code you add
into dynamic tag management, you should not see negative
performance impacts.
The Embed code should be hard-coded in the <head> section of
your templates. This is a synchronous JavaScript include. The
dynamic tag management engine is designed to work in a modular
way, so scripts that do not apply to a particular page, site section,
or domain will not load or execute when they are not needed. Most
users increase the use of asynchronous (non-sequential) methods
when deploying third party scripts. This generally improves the
perceived page load speed for site visitors. While the dynamic tag
management main library file itself is loaded synchronously, most
clients load any code from within dynamic tag management using
the built-in asynchronous methods.
How do I remember which tags are in which
rules? How do I keep track of my tags, and
make it easier to find certain rules?
Adobe recommends using the rule Name, the Tag Name, and the
Categories to label your rules in a way that helps you find things
faster later on, when you need to come back and change a rule, or
group of rules.
For example, because different Page Load and Event Based rules
respond to different Conditions, it might make sense to add an
indicator about the Conditions in the rule Name, like Global Page
Load."
When working with Third Party Tags or custom JavaScript, you can
add information into the Tag Name field. Later, when you are looking
for all the rules with a certain tag, you can filter the list of rules by
Tag Name to find all rules containing that tag.
Finally, each rule can be labeled with a Category and a value. The
Category is also available when filtering your list of rules, so you
can easily and quickly find the list of rules in a certain Category. For
example, using a Category like 3rd Party with a value of
Question
16
Answer
DoubleClick lets you search for all rules in the 3rd Party Category,
or all rules with the value of DoubleClick.
Does dynamic tag management have features Adobe recommends the use of tag event callbacks provided by
that help avoid errors due to asynchronous
amc.on to wrap any code that depends on tags delivered by any
tag loading or rare cases of CDN
tag management system.
unavailability?
See amc.on Tag Event Callbacks.
Can the dynamic tag management library files Adobe offers two options for self-hosting the library files: FTP
work with the version control system we use Delivery and Library Download. When you use choose one of these
at my company?
self-hosted options for the library, each time you make changes in
dynamic tag management, those changes are written out by the
system to the library files. Those files are typically then "pushed" or
"pulled" to your architecture automatically. Once the updated library
code is on your servers, you can add the files to your version control
systems and processes however you like. If you use GitHub, SVN,
or some other system to manage your web development code or
content, that works fine with dynamic tag management.
One note on version control: Ensure you do not overwrite the
production version of the Embed code with the staging version of
the Embed code when you commit and push code to production.
The staging version of the Embed code has to stay in the staging
(non-production, test, dev, QA, UAT, etc.) environment templates.
The production version of the embed code has to stay in the
production templates.
Can I use dynamic tag management with our Currently, dynamic tag management can be used in any digital
mobile applications?
experience created with HTML, CSS, and JavaScript. This includes
any mobile-optimized content or responsive designs. This also
includes mobile applications created with wrappers like Cordova or
PhoneGap.
Unfortunately, at this time, dynamic tag management does not offer
a separate SDK for use with completely native, compiled
applications. You can still track your mobile applications using the
Adobe Analytics SDK. Dynamic tag management can also be present
on HTML documents pulled into your mobile app when desktop or
responsive content is accessed within the native app experience,
like in hybrid or crossover content situations.
How do I set s.pageName without creating a There are a number of ways to set s.pageName for each page,
separate rule for each of my Web pages?
without creating a separate dynamic tag management Page Load
rule for each page. In dynamic tag management, the conditions for
your rules answer questions like: Whats the visitor doing? Where
Question
17
Answer
are they doing it? When is it happening? You can set any number
of variables, trigger different tags or tools, and execute any number
of scripts from within the same rule, as long as you want all those
things to happen in response to the same conditions.
For example, if you want document.title to be the source for
the value of the s.pageName variable, you could create a Data
Element with a name of Page Name, a Type of JS Object, a Path
of document.title, a Default Value of None, and Remember this
value for Pageview.
Then, you could create a global Page Load rule and assign that
Data Element to s.pageName, either in the interface, or in the
Custom Editor code window. It will then be dynamically populated
with the value of document.title for each page that meets your
conditions.
Does the dynamic tag management code send Dynamic tag management is a way to get JavaScript and HTML to
any information back to Adobe?
your pages. It sends data only to the systems, tools, or tags that
you specifically choose when using the system. In other words,
dynamic tag management does not send any data anywhere, unless
you specifically tell it what data should be collected, and then tell it
when, where, and how it should be sent to any systems, tools, or
tags.
You have control over the specific data points that only get sent to
the places and technologies you designate.
18
Question
Answer
Answer
If using DTM to manually host the s_code, plugins can be added in the same
editor as the hosted s_code, just as it would be in a typical Adobe Analytics
implementation.
However, it is also an option to place the plugins in the editor within the
Customize Page Code section of the tool settings. Both implementation
methods should be equally effective.
See DTM Switch Plugins.
No.
The existing tool automatically becomes available. You can then view the
configuration for your Adobe Analytics tool to see the new configuration
options.
Any user code that you have specified is overwritten with the base
AppMeasurement library. You must move this code to the new Custom Page
Code section at the end of the tool configuration so that the code continues
executing. This method allows the AppMeasurement library to be managed
(and upgraded) separately from the user's custom code.
Yes.
Question
19
Answer
The caching of site assets occurs at the browser level and is not something that TMS vendors can directly address.
The same is true of the time that it takes for servers to create site pages and prepare them for delivery. Both of these
areas can increase and decrease the time that it takes for a page to load. Since TMS vendors cannot directly address
the first two page load issues this overview will focus on the remaining four areas.
All major TMS options attempt to reduce the number of downloaded files and also optimize their size. The approach
that each TMS takes to accomplish those tasks may vary somewhat, but in the end they each provide some
improvement to the final file weight that is delivered to the page. When evaluating a TMS it is important to understand
the architecture involved in the packaging and deployment of the individual files to the client web browser.
Are the files assembled server-side on each request, or delivered from pre-published static files?
If files are assembled dynamically, how long does file assembly take for each request?
20
Is there a server-side only management of a portion of the files, and if so, what are the limitations of that architecture?
What compression techniques are used in the generation of the files?
Are optimizations provided in the TMS file generation that might help mitigate browser errors?
In the final analysis each major TMS vendor reduces the number of downloaded files and optimizes the file size with
some degree of success.
The areas where TMS solutions can see appreciable speed differences on the page are in the areas of connection
speed and file loading. All of the major TMS offerings provide the option of a globally distributed CDN to deliver their
files. Hosting files on any infrastructure is also available as an option when using Adobe dynamic tag management.
In most cases a CDN provides an efficient means to deliver the TMS files. However, there are several cautionary
questions that must be answered relating to the hosting methodology that is provided by the TMS.
What happens if the host CDN or regional DNS service fails?
A number of enterprise level failures have occurred in these areas during critical delivery times for some TMS
vendors. Self-hosting of TMS assets prevents this situation from occurring since the files are delivered along with
the rest of the client-hosted website assets either on a their own architecture or an architecture of their choice.
What are the response times for file retrieval?
Are international response times significantly different for regional visitors?
How responsive are the vendors of the third-party code that the TMS manages like Facebook, Google, Foresee,
etc.?
Each of these third-party connections can cause delays even if the TMS files are delivered quickly. Does the TMS
have client-adjustable tag timeouts that mitigate vendor delays?
File loading also has an effect on page speed, but more specifically, on the user experience. The use of asynchronous
tag loading, conditional logic that determines what file assets will be delivered, and the placement of timeouts on
tags provide ways to parallelize tag behavior and improve the loading of the page. Although the final tag weight may
not be significantly different at the end of the page load, moving third-party vendor tags from a synchronous to
asynchronous load allows multiple assets to load in parallel rather than one at a time. How much flexibility does the
TMS provide regarding the timing and sequencing of vendor code? Does the TMS vendor provide best practices
for optimizing page performance in relationship to file loading? Can third-party vendor code be easily changed from
synchronous to asynchronous loading and vice-versa?
Adobe dynamic tag management excels in each of these four page speed areas and, in certain cases like hosting,
provides a better solution than other vendors. However, page load speed is only one area that needs to be addressed
when evaluating a TMS. Critical questions need to be answered regarding workflow and governance, rule deployment
methodologies, the user interface, implementation, migration, maintenance, and user segmentation capabilities.
These are areas that make Adobe dynamic tag management stand out as a system with a proven performance
record that clients enjoy using over the long-term.
Web Properties
21
Web Properties
A Web Property is a library of rules and one embed code. It can be any grouping of one or more domains and
subdomains. You can manage and track these assets similarly. For example, suppose that you have multiple web
sites based on one template, and you want to track the same assets on all of them.You can apply one Web Property
to multiple domains.
Scheduling Web Properties
Best Practices for Planning Web Properties
Property - Field Descriptions
Create Property - Advanced Settings
How Web Properties Compare to Analytics Report Suites
Domain Planning
Separating the DTM Environment for Multiple Entities
Scheduling Web Properties
To enable scheduling for a Web Property, submit a ticket to Adobe Customer Care.
Best Practices for Planning Web Properties
Adobe recommends considering four things when planning Web Properties:
Item
Best Practice
Data
For all of your Web sites, is the data you are going to collect very similar, somewhat
similar, or unique?
When the data you need to collect is similar across websites, it might make sense
to group those sites into one Web Property to avoid duplicating rules, or copying
rules from one property to another.
If your data collection needs are unique for each site, it might make sense to
separate those sites into their own Web Properties. This method lets you control
the data collection more specifically for each site, without using large amounts of
conditional logic in custom scripts.
Variables
Similar to data, for all of your Web sites. Are the variables you are going to set in
your Analytics and other tools very similar, somewhat similar, or unique?
For example, if eVar27 is used for the same source value across all of your websites,
it might make sense to group those sites together so you can set those common
variables across your sites in just one Web Property.
If your variable usage is unique for each site, it might make more sense to separate
those sites into their own Web Properties, so you can control the variables more
specifically for each site without using large amounts of conditional logic in custom
scripts.
Are the tools, tags and systems you are going to deploy through dynamic tag
management very similar, somewhat similar, or unique? If you are deploying Adobe
Analytics on only one site, and your other tools and tags are also unique to certain
Web Properties
Item
22
Best Practice
sites, you might want to create separate Web Properties for those sites so you can
control those specific tools in one Web Property.
If the tools, tags, and systems you are going to deploy through dynamic tag
management are very similar across your sites, then you might want to include
those sites in the same Web Property.
People
For the individuals, teams, and organizations that are working in dynamic tag
management, will they need access to all of your websites, some of them, or just
one of your domains or sub-domains?
The User Management features allow you to assign different roles to different people
for all of your Web Properties, or on a per-property basis. The only role that includes
all Web Properties within a dynamic tag management company account is the
Admin role. If someone is an Admin, they are an Admin across all the Web
Properties in that dynamic tag management company. All the other roles can be
assigned on a per-property basis. You can even hide a Web Property from certain
users (non-admins) by not giving them any Role in that Web Property.
Each implementation can be very different in dynamic tag management, with a wide variety of data collection needs,
variable usage, tools, third party tags, other systems and technologies, people, teams, geographic regions, and so
on. Using the flexible User Management features and Web Properties, you can create a configuration that matches
your workflow and processes.
Property - Field Descriptions
Home > Dashboard > Add Property
Web Properties
23
Element
Description
Name
URL
If your site spans multiple subdomains, enable one of the following options:
This site spans multiple subdomains: Causes visit data to persist as
a user navigates between subdomains.
Track links to subdomains as outbound links: You can track visits to
subdomains separately.
This site spans multiple domains: You can add and remove domains if
you want visitor data to persist between domains.
Description
Allow Multi-Rule
Approvals
Allows multiple rules for this property to be approved at one time. (The default approval
allows only single rule approval.)
Enable Selective
Publish
Specifies whether to allow users to selectively publish approved rules. (The default
workflow is to publish all approved rules at one time.)
Web Properties
24
Element
Description
Overrides the default tracking cookie name. You can customize the name that dynamic
tag management uses to track your opt-out status for receiving other cookies.
Tag Timeout
Specifies how long dynamic tag management waits for a tag to fire before timing out.
Anchor Delay
Specifies how long dynamic tag management waits for tags to fire on clicked links, before
moving to the next page. The default value is 100 milliseconds.
Web Properties
25
Some customers have one Company that contains all of their Web Properties. Some have a Company that contains
many Web Properties, one for each domain. Some have a Company that contains several Web Properties, one for
each type of site they manage.
For example, you may have three Web Properties within your Company account where one contains all of your blog
sites, another contains all of your ecommerce sites, and the third contains all of your lead generation sites.
Note: Each Web Property requires its own Embed Codes in your page templates. Any domains or subdomains
you want included in a particular Web Property would have the same Embed Codes in the page templates
when dynamic tag management is first installed on your site.
Can we use separate instances for each?
As described above, you can use separate Company accounts for your three entities, or you can combine the entities
into one Company account and split the domains / subdomains into different Web Properties within that Company
account.
Is there a clear way to separate domains and settings within the same dynamic tag management instance?
Within a Company account, you can use multiple Web Properties to separate domains and settings, or you can put
multiple domains into the same Web Property.
What are the pros and cons for using one dynamic tag management instance?
With one Web Property that contains multiple domains and subdomains, you will eventually add conditional logic to
separate unique data collection and tracking needs that only apply to individual domains, subdomains, or subsets
of domains / subdomains.
What is the approach recommended by Adobe: one or separate companies?
Most clients use one Company account that contains all of their Web Properties. Information on this page can help
you determine the best plan for your particular needs within those properties.
Web Properties
26
Data Elements
27
Data Elements
Data elements are the building blocks for rules. Data elements let you create a data dictionary (or data map) for any
object that is contained on your site. They can be JavaScript objects, cookie values, and query strings. You use
data elements to build a data layer that can be used for Analytics and other data collection tools.
Rules > Data Elements > Edit.
Use data elements as widely as possible throughout rule creation to consolidate the definition of dynamic data, and
to improve the efficiency of your tagging process. You define them once and then use them many times.
Data elements are populated with data when they are used in rules, or when manually called in scripts. At a high
level, you:
1. Create a data element.
2. Use the data element in a rule or a custom script.
Types of Data Elements
Persistence
Built-In Data Elements
Data Element Usage
Data Element Availability
How to Collect Values from JavaScript Variables
Types of Data Elements
The following table describes the types of data elements.
Type
Description
Example
JavaScript Object
CSS Selector
Cookie
URL Parameter
cookieName
contentType
Data Elements
28
Type
Description
Example
Custom Script
var pageType =
(window.location.pathname ==
'/'){return 'homepage';
The final value produced by the code is set as }
else
the data element value. Therefore, a return
value is not necessary in the editor window, {
return pageType;
unlike the Rule Identifier custom code editor.
}
Persistence
Page view
Session
Visitor
Cookie manipulation
Protocol
Hostname
Data Elements
29
In Custom Script
You can use data elements in custom scripts by using the _satellite object syntax:
_satellite.getVar('data element name');
Data Elements
30
For example, entering the following code forces the retrieval of the data element named sample data during the rule
identification step, prior to any data manipulation that happens in the rest of the rule.
Data Elements
31
The custom code section in the identifier must return true, regardless of whether a valid value is available for the
data element. Otherwise, the rule never evaluates as true or runs.
How to Collect Values from JavaScript Variables
When you have JavaScript variables, or object properties in your markup, and you want to collect those values in
dynamic tag management to use with your analytics tools, or testing tools, or even with third party tags, one way to
capture those values is to use Data Elements in dynamic tag management. This way, you can refer to the Data
Element throughout your Rules, and if the source of the data ever changes, you only need to change your reference
to the source (the Data Element) in one place in dynamic tag management.
For example, let's say your markup contains a JavaScript variable called "Page_Name", like this:
<script>
//data layer
var Page_Name = "Homepage"
</script>
When you create the Data Element in dynamic tag management, simply provide the path to that variable like this:
Data Elements
32
If you use a data collector object as party of your data layer, simply use dot notation in the Path to reference the
object and property you want to capture into the Data Element, like _myData.pageName, or digitalData.pageName,
etc.
Type
The data element friendly name that a marketer can recognize. For example, Product
ID.
Specifies where the data is pulled from, such as JS Object, CSS Selector, and Cookie.
See Types of Data Elements for more information.
Parameter Name
Default Value
33
Description
Installed Tools
Displays the installed tools. Tools are deployments of Adobe Analytics, Adobe
Target, Google Universal Analytics, and so on.
Add a Tool
Add a Tag
You can access rules to add a tag, to determine when your tag will fire. You
open the third-party tags section of your rule, paste your tag, and save the
rule.
See Rules.
Assigned Users
34
Description
The type of tool, such as Adobe Analytics.
Tool Name
The name for this tool. This name displays on the Overview tab under Installed
Tools.
Enable Automatic
Configuration
This option allows dynamic tag management to automatically retrieve your Adobe
Analytics Account's configuration.
The latest available AppMeasurement code is used, and upgrade notifications are
displayed for selection as new versions become available. You can also roll back
to previous AppMeasurement versions as necessary, such as for compatibility
reasons. Up to five previous versions are displayed.
Note: This setting displays when you edit existing tools. Enabling this setting
changes a manually configured implementation to the automatic configuration
method described in Configuration Method.
Configuration Method
Valid values:
Manual:You can manually manage the AppMeasurement code.You can download
the Analytics AppMeasurement code from Admin Tools > Code Manager.
Element
35
Description
Click JavaScript (new) to download the code locally, so that you can copy and
paste the code in the Edit Code field in Library Management.
Automatic: You can dynamic tag management manage the configuration. This
method enables automatic synchronization of Adobe Analytics report suites via
a Marketing Cloud login or Web Services ID, and manages the AppMeasurement
code.
Once the accounts are connected, dynamic tag management pulls the Adobe
Analytics report suite IDs and names into the tool configuration interface, allowing
for increased speed in tool deployment with less possibility for user errors.
Authenticate via
Displays when you select Automatic as from the Configuration Method menu. Valid
values:
Marketing Cloud: (Default) Uses Marketing Cloud single sign-on.
Web Services: Shared secret credentials are located in Admin Tools > Company
Settings > Web Services.
Developers, see Get Web Service Access to the Enterprise API for help with
obtaining Web Services credentials.
Update Credentials
You can refresh the API, for example, to update report suites associated with a
user.
Production Account ID
(Required for Manual configuration) A number for your production account for data
collection. Dynamic tag management automatically installs the correct account in
the production and staging environment.
Staging Account ID
Create Tool
Creates the tool and displays it for editing. Tools are displayed on the Overview
tab, under Installed Tools.
36
Answer
No.
The existing tool automatically becomes available. You can then view the
configuration for your Adobe Analytics tool to see the new configuration
options.
Question
37
Answer
executing. This method allows the AppMeasurement library to be managed
(and upgraded) separately from the user's custom code.
Yes.
Potential Pitfalls
There is a small chance that the new integration could cause data collection issues if you currently use Adobe
Analytics.These issues could arise only if you publish your library to production subsequent to the release. (Production
code remains intact until publishing occurs.)
To avoid these issues, ensure that:
Report suite IDs are correctly entered in the tool.
Report suite IDs in the tool match the IDs in the AppMeasurement code.
The currency code, character set, tracking server, and SSL tracking server configuration fields are correctly set
with supported values.
Custom code is defined in Library Management.
General
Field descriptions for the General settings in dynamic tag manager, for deploying Adobe Analytics.
Property >
Element
Description
38
Element
Description
You must also have a mechanism to clear that cookie if you want
a visitor to be able to opt in later without manually clearing the
cookie:
_satellite.removeCookie(sat_track);
Character Set
Currency Code
Tracking Server
Data Center
Library Management
Descriptions of the fields and options in the Library Management settings in dynamic tag management.
Property >
Note: If more than one Adobe Analytics tool is used in a single web property, each tool must have a unique
tracker variable name. Duplicative object variable names between Adobe Analytics tools within a single web
property will cause conflicts.
Element
Description
Prevents dynamic tag management from installing Adobe Analytics page code if
the code is already present on your site. This feature allows you to use dynamic
tag management to add to your existing implementation rather than starting from
scratch. Be sure to properly set your tracker variable name when checking this
box.
Managed by Adobe
You can select the latest version from the Library Version menu and notifies you
when new versions are available.You can revert to a previous version as necessary.
39
Element
Description
Custom
Set report suites using custom When this box is checked, dynamic tag management looks for a variable in your
code below
custom code called s_account. This variable should contain a comma-separated
list of the report suites to which you want to send data.
Code Hosted
Open Editor
Lets you insert core AppMeasurement code. This code is populated automatically
when using the automatic configuration method described in Adobe Analytics
Settings.
If you want to run two instances of Adobe Analytics in parallel (one within dynamic
tag management and one natively), you can rename the main s object. Renaming
the object name avoids collisions.
40
5. Adobe recommends adding the following code above the Do Not Alter Anything Below This Line:
var s = new AppMeasurement();
s.account = "[insert account name]";
Alternatively, if you prefer to set s.account dynamically, based on the environment (staging or production), follow
these steps:
1. Add the this function to the top of the AppMeasurement file:
s = new AppMeasurement();
function getAnalyticsAccount() {
for(var toolid in _satellite.tools) {
if(_satellite.tools[toolid].settings.engine == "sc") {
return _satellite.tools[toolid].settings.account;
}
}
}
2. Replace the second line of code (s.account = "[insert account name]";) mentioned as a minimum
requirement in the preceding step with s.account = getAnalyticsAccount();.
For example:
41
These steps will force s.account to set dynamically, based on the account IDs indicated in the Account Numbers
fields in the dynamic tag management:
Note: This method works only for the first Adobe Analytics tool that is installed in a given web property. If
there are multiple Analytics tool instances installed in a single web property, the function returns only the
account value for the first tool.
6. Click Save and Close.
If you are using the Media Module, Integrate Module, or implementation plug-ins, you can copy them into the
code section as well. The managed code in dynamic tag manager can be configured exactly like the JavaScript
file in a typical implementation.
Global Variables
Field descriptions and information about variables when using dynamic tag management to deploy Adobe Analytics.
Global Variables - Field Descriptions
Dynamically Populate Variables
42
Element
Description
Server
eVars
The eVar variables are used for building custom conversion reports.
See eVarN.
Props
Property (prop) variables are used for building custom traffic reports.
See propN.
Dynamic Variable
Prefix
A special prefix to the start of the value. The default prefix is "D=".
See Dynamic Variables.
For example, suppose you have a search results page with multiple links to external web sites. You want to track
which link is clicked by dynamically populating an eVar with the id of the element clicked.
Example Link: <a id='myFirstLink' href='www.exampleLink.com'>
To accomplish this, create an event-based rule to trigger on the click of the links on the page. Then, within the
Analytics section of the rule, set the eVar to %this.id%.
For non-standard attributes, you can similarly leverage the JavaScript function this.getAttribute() by wrapping it in
'%' characters, as follows:
%this.getAttribute(attributeName)%
For example, suppose you have a similar search results page as the preceding example shows. However, these
links contain a non-standard attribute, loc that you wish to dynamically set to an eVar based on the link clicked.
43
If you are unsure if the desired attribute is standard or non-standard, reference w3schools.com to learn more about
standard HTML attributes. However, if in doubt, you can use the non-standard getAttribute() format, which will work
in either scenario.
This functionality can be utilized in dynamic tag management rule fields, including:
Analytics Variables
Adobe Analytics:
Link Tracking, Page Data, Hierarchy
Global Variables and Events
Google Analytics
Pageviews, Events, Custom Variables
Custom Script
Standard attributes can also be referenced using regular JavaScript in custom code.
Element
Page Name
Description
The name of each page on your site.
See pageName.
Element
44
Description
See channel.
Hierarchy
Link Tracking
Field descriptions in dynamic tag management for link tracking when deploying Analytics.
Property >
Element
Description
Enable ClickMap
Download Extensions
If your site contains links to files with any of the listed extensions, the URLs of these
links will appear in reporting.
See linkDownloadFileTypes.
Element
Referrer Override
Description
Overrides the value set in the s.referrer variable, which is typically populated by
the referrer set in the browser.
See referrer.
Element
45
Description
Campaign
A variable that identifies marketing campaigns used to bring visitors to your site.
The value of campaign is usually taken from a query string parameter.
See campaign.
Cookies
Field descriptions for the Cookies global settings used for deploying dynamic tag manager in Adobe Analytics.
Property >
Element
Description
Visitor ID
Unique value that represents a customer in both the online and offline systems.
See visitorID.
Transaction ID
Unique value that represents an online transaction that resulted in offline activity.
See transactionID.
Domain Periods
The domain on which the Analytics cookie s_cc and s_sq are set by determining
the number of periods in the domain of the page URL. This variable is also used
by some plug-ins in determining the correct domain to set the plug-in's cookie.
See cookieDomainPeriods.
FP Domain Periods
Cookie Lifetime
Element
Description
Open Editor
You can insert any JavaScript call that must be triggered before the final s.t() call, which is
contained in the s_code.
46
Element
Description
Execute
Before UI settings: Interface settings take precedence over the custom code (for example,
if you want to override an eVar if a setting in the interface was enabled).
After UI settings: Custom code takes precedence over interface settings.
After you create the web property, it is available for editing on the Web Properties tab on the Dashboard.
Activating the web property is not required
3. Add an Adobe Analytics tool to the property:
a) On the Web Properties tab, click the property.
b) On the Overview tab, click Add a Tool.
c) From the Tool Type menu, select Adobe Analytics.
47
Description
Tool Type
The Marketing Cloud solution, such as Analytics, Target, Social, and so on.
Tool Name
The name for this tool.This name displays on the Overview tab under Installed
Tools.
Production Account ID
A number for your production account for data collection. Dynamic tag
management automatically installs the correct account in the production and
staging environment.
Staging Account ID
).
At a minimum, click Cookies and configure your tracking server and SSL tracking server.
6. Click General and insert the core AppMeasurement code.
7. Define a page load rule to collect Analytics data.
48
You are now ready to define rules to collect analytics data. You might want to define a few data elements first.
Data elements let you extract data from the page that you can use to configure your rule. To get started, you can
define a page load rule that does not have any conditions to collect Analytics data on each page.
8. Add the header and footer code on the Embed tab.
For staging, you can leave the default Amazon hosting option.You can change it if needed before your production
rollout.
9. (Optional) Click Settings (
Note: The settings on the Adobe Analytics page (General, Cookies, and so on) override settings in your
s_code. If these settings exist in your s_code, there is no need to reiterate them here.
Description
Tool Type
The type of tool, such as Adobe Analytics, Adobe Target, or Marketing Cloud ID
Service.
Tool Name
The name for this tool. This name displays on the Overview tab under Installed
Tools.
Marketing Cloud Organization (Required) The ID associated with your provisioned Marketing Cloud company. An
ID
Organization is the entity that enables an administrator to configure groups and
users, and to control single sign-on in the Marketing Cloud. This ID is a 24-character
alphanumeric string, followed by (and must include) @AdobeOrg.
Marketing Cloud administrators can find this ID in Marketing Cloud > Tools.
Element
49
Description
Automatically Request Visitor Enabling this option causes dynamic tag management to automatically call the
ID
getMarketingCloudVisitorID() method before loading any of the Adobe solutions
that use the Marketing Cloud ID service.
See Library Reference in Marketing Cloud Visitor ID help for information about
getMarketingCloudVisitorID()
Tracking Server
(Required for Adobe Analytics) The tracking server used for Adobe Analytics data
collection. It is the domain at which the image request and cookie is written. (For
example, site.omtrdc.net).
See trackingServer.
(Optional) If you use a secure Adobe Analytics tracking server, specify it here.
This specifies the domain at which the image request and cookie is written. Used
for secure pages. If not defined, SSL data goes to trackingServer.
See trackingServerSecure.
(Optional) If you use a secure Analytics tracking server for first-party data collection,
specify the server here. (For example, s.metrics.company.com.)
Library Version
The version of the AppMeasurement Library you want to use. This code is not
editable for the Marketing Cloud ID Service. (For example,
s.metrics.company.com.)
Settings
The name-values pairs defined in these fields are available as Visitor ID instance
properties.
Customer ID
The Visitor API accepts multiple Customer IDs for the same visitor along with a
Customer type identifier, to separate the scope of the different Customer IDs.
50
See Verify Marketing Cloud ID Service Implementation to verify that the Analytics request contains a mid (Marketing
Cloud Visitor ID) parameter.
See Visitor ID Service Requirements for information about specific code versions and other Visitor ID service
requirements.
Description
You can name this instance of audience management.
A unique alphanumeric identifier assigned by audience management.
Code version
Integrate with
Modules:
Adobe Analytics
Google Analytics
Open Editor
Add a Note
Use the editor to insert the custom audience manager API code. The tracking
call should be included in the custom code.
Add any notes here regarding this implementation.
Description
A descriptive name for this implementation.
Setting
User ID
51
Description
Your advertising management account has an associated numeric user ID. It is
displayed in the JavaScript generated for a pixel.
For example:
1234
Transaction ID
Determines where and when the page code loads. The recommended location
is selected by default.
Prevents dynamic tag management from installing advertising management code
if the code exists on your site. This method lets you use dynamic tag management
to add to your existing advertising management implementation, rather than
starting a new implementation.
A conversion property to be tracked when an end user views a page containing
the conversion tag.
Note: Properties added to this list are not integrated with the client's
Transaction Properties list in the Admin view in advertising management.
Setting
52
Description
However, properties are added to the client's Transaction Properties list
automatically, once advertising management actually gathers data for a
property. Gathering happens when the conversion tag is implemented on
a page and an end user completes a transaction that opens that page.
Conversion properties can be set globally at the tool level and conditionally at the
rule level. A globally configured Conversion Property is inherited by any dynamic
tag management rules utilizing the Adobe Media Optimizer tool in addition to any
conversion properties set in the rule.
Segment ID (Optional)
A conversion property name / value to be included in the tag when the specific
rule is fired.
Note: Properties added to this list are not integrated with the client's
Transaction Properties list in the Admin view in advertising management.
However, properties are added to the client's Transaction Properties list
automatically, once advertising management gathers data for a property.
Gathering happens when the conversion tag is implemented on a page and
an end user completes a transaction.
Conversion properties can be set globally at the tool level and conditionally at the
rule level. If a rule uses the Adobe Media Optimizer tool, the configured global
value is inherited and used in addition to any conversion properties configured in
the rule.
SKU
Select the configured data element to populate the SKU value in the tag.
See Data Elements for more information.
SKU can be set globally at the tool level or conditionally at the rule level. If a rule
uses the Adobe Media Optimizer tool and the rule does not specifically set a SKU,
the configured global value is inherited and used. If the rule sets a SKU, any global
SKU configuration is overridden in that rule.
53
Configure the rule so that it fires only in the desired cases. In this example, the rule fires on the click of Add to
cart as indicated by the selector div with a class of addtocart.
Note: Adobe Media Optimizer is also available in page load and direct call rules in dynamic tag management
once an Adobe Media Optimizer tool is installed in the property. See Conditions and Functions for information
about available rule criteria.
3. Expand Adobe Media Optimizer in the rule.
54
55
Description
Tool Type
Tool Name
The name for this tool. This name displays on the Overview tab under Installed Tools.
Library retrieval
method
Specifies whether Adobe should manage your Adobe Target code automatically, or whether
you would like to provide your own custom code manually.
Manual Configuration Method
You can manually manage the Adobe Target code. You can download the mbox.js file from
the Target solution interface as follows:
Target Classic: Configuration- > mbox.js > Download
Target Standard: Setup > Implementation > Download mbox.js
After you download the code locally, copy and paste the code into the editor field in the Library
Management section of the tool settings. You also have the option of hosting the code at a
specific URL as an alternative to manually pasting in the code.
Automatic Configuration Method
Setting
56
Description
Dynamic tag management automatically retrieves the latest mbox.js code from your Adobe
Target account configuration. If you select Automatic, you must either be logged in via the
Marketing Cloud, or you must provide a Client Code value described below.
Client code
retrieval method
(Automatic method) A code unique to your Adobe Target account. It is required for your code
to be provided and managed automatically by Adobe. If you chose the Automatic method, you
must either be logged in via the Marketing Cloud, or provide your Client Code value after
selecting Manual as the retrieval method.
Client Code
(Automatic method) The Client Code value can be retrieved from the Adobe Target solution
interface as follows:
Target Classic: Configuration > mbox.js > Edit > copy value for Client.
Target Standard: Setup > Implementation > Download mbox.js > copy value for Client
from within mbox.js file.
Element
Description
This option ensures the mbox.js code is loaded synchronously in the <head>
section. It is generally recommended that you leave this option enabled. It is
an Adobe Target best practice to load the mbox.js code in this way.
Once the accounts are connected, dynamic tag management pulls the Adobe
Targetmbox.js code into the tool and optimizes the configuration process.
This process increases consistency between the two solutions.
Code Configuration
Element
57
Description
This feature optimizes the configuration process when using a manual method,
because no more copying or pasting from the Adobe Target admin console
is required.
You must be logged in via Marketing Cloud or have provided the appropriate
Client Code for this option to be available.
Clicking Check for Updates automatically checks for new versions of the
mbox.js code within your associated Adobe Target account. If a new version
is identified, you have the option to use it or retain the current version.
Custom: You can manually configure the mbox.js code. Two methods are
available to manually host the code in dynamic tag management:
In DTM: Click Edit Code and paste the code in the editor. If you were using
Managed by Adobe and switch to custom, the editor automatically populates
with your mbox.js code.
At URL: If your mbox.js is configured as desired, you can provide the URL
to the file. Dynamic tag management will consume it for use in the Adobe
Target tool.
Element
Description
Name
Indicate the name of the additional parameter(s) you wish to pass to the global mbox.
Adobe Target does not accept the usage of and in this field. Using it leads to errors on the
web page.
Parameters here take effect only if you use TNT.createGlobalMbox(). If you created your
mboxes using mboxCreate(), these parameters have no effect.
Value
Indicate the value of the additional parameter(s) you want to pass to the global mbox.
58
Answer
Is this a new Adobe Target tool or a change A change to the existing tool.
to the existing tool?
If you currently have an implementation of Adobe Target in dynamic
tag management, it will continue to function as is unless you make
a change. Please review the following questions for more details on
avoiding potential issues.
Do I have to do anything to get the new
functionality?
No.
The existing tool automatically becomes available.You can then view
the configuration for your Adobe Target tool to see the new
configuration options.
Question
59
Answer
occurs because the tool deploys another instance of the mbox.js
when utilizing either of the available automatic configuration options,
or the Manual > Hosted by Adobe configuration option.
To avoid this issue, test the deployment in staging to ensure you are
only deploying a single mbox.js code on your site before deploying
a new tool configuration to production.
What pitfalls should I be aware of as I migrate With the present functionality of the mbox.js code, auto-loading the
to the Adobe Target tool?
mbox.js code via the integrated Target tool could break scripts
currently being deployed later in the <head> as they may be pushed
down into the <body/> section of the page.
If you encounter this conflict, revert to the Manual code configuration
(your hosted code is retained and becomes available in the Custom
editor), and move the createGlobalMbox() function out of the mbox.js
code. Place it in a page load rule to avoid sequencing issues.
60
Configure the rule so that it fires only on the pages where you want to deploy the mbox.
Note: Adobe recommends load rules triggering mboxes at Top of Page to ensure the default content is
hidden until the mbox response has been received.
See Rule Conditions and Functions for information about available rule criteria.
3. Expand Adobe Target.
Specify the element to wrap with the mbox using a CSS selector, name the mbox, then configure the timeout if
needed. (It is generally recommended to leave this at the default 1500 ms).
4. Configure the parameters you want to add to the Target mbox or to the global Target mbox.
In this example, this rule deploys an mbox named Hero that wraps a div element with an id of hero and includes
an mbox parameter named Page Name with a value of homepage. It also includes a parameter named Path with
a value of home that it passes to the global mbox.
61
Note: You can also use data elements in the parameter UI fields to dynamically populate the value. See
Data Elements for more information on data elements.
Description
The name of this instance of Google Analytics.
You can point to production or staging accounts for data collection. Your staging
account number is used in your development or test environment. It keeps your testing
data separate from production. Dynamic tag management automatically installs the
correct account in each environment.
62
Setting
Description
You must also have a mechanism to clear that cookie if you want a visitor to be able
to opt in later without manually clearing the cookie:
_satellite.removeCookie(sat_track);
Tracker Name
The tracker name you want to use for your Google Analytics installation. If you specified
that Google Analytics is already installed on your site's pages, you must use the same
name here for proper data collection. The default tracker name for Google Analytics
is blank.
There are two ways to host Google Analytics code:
Google Hosted: You can host the code through Google.
URL: Or you can simply provide the URL to the file here. Dynamic tag management
then consumes this code for its implementation of Google Analytics.
To have Google Analytics capture only a sample of your site's data, specify the sample
rate. To gather all data, leave 100%.
You can specify the sample rate for capturing data on site speed and page
performance. The default is 1%.
Enables automatic link tracking on the above social buttons on your site.
Force all page views, events, and custom variables sent to GA to be in all lowercase
letters (a best-practice recommendation).
Setting
63
Description
Cookie Path
Cookie Domain
How much time elapses before Google Analytics expires a session. Default is 30
minutes.
Control how long a cookie lasts for a visitor to count as a repeat visitor. Default is two
years.
You can restrict whether a Google Analytics cookie only functions with a specific folder
on your site.
You can change the default cookie domain. If you specified that your web property
spans multiple domains or subdomains, dynamic tag management configures this
automatically.
Allows dynamic tag management to recognize values in the URL after the # symbol
as URL parameters.
If your campaign parameters do not show up in the default variables (like utm_source,
etc.), configure them here.
Allows you to set campaigns around cookies.
Control how long a cookie lasts for a campaign. Default is 30 days.
Create a list of organic keywords that are automatically classified as direct traffic,
comma separated. This list is most often used to classify brand searches as direct.
Adobe does not recommend this practice.
Setting
Classify the following
referrers as direct
64
Description
Create a list of referral sources that are automatically classified as direct traffic, comma
separated. This is most often used to classify affiliate or in-network searches as direct.
Adobe does not recommend this practice.
Use the editor to customize the page code. This code is inserted into every page
immediately before the call to track the page view. If you want to cancel the initial
default _trackPageview command and write your own to customize page names, be
sure to "return false;" at the end of the script.
Description
The name of this instance of Google Analytics.
Dynamic tag management allows you to point to production and staging accounts for
data collection. Your staging account number will be used in your development or test
environment, and will keep your testing data separate from production. Dynamic tag
management will automatically install the correct account in each environment.
General
Element
Description
Enable support for Google Universal Enables the max dimensions and metrics increase from 20 to 200.
Analytics Premium features
65
Element
Description
You must also have a mechanism to clear that cookie if you want a visitor to
be able to opt in later without manually clearing the cookie:
_satellite.removeCookie(sat_track);
Anonymize IP addresses
Force SSL
Tracker Name
The tracker name you want to use for your Google Analytics installation. If
you specified that Google Analytics is already installed on your site's pages,
you must use the same name here for proper data collection. The default
tracker name for Google Analytics is blank.
Data Sample
To have Google Analytics only capture a sample of your site's data, specify
the sample rate for Data Sample. To gather all data, leave at 100%.
66
Element
Description
You can also specify the sample rate for capturing data on site speed and
page performance. The Google Analytics default is 1%.
Social - Track Facebook like, unlike, Enables automatic link tracking on the above social buttons on your site.
and share
Social - Track official Twitter button
use
Force lowercase on all pageview,
event, and custom variable calls
Force all page views, events, and custom variables sent to GA to be in all
lowercase letters (a best-practice recommendation).
Typically, HTTP referrals come from outside the domain on which you
implemented Google Universal Analytics. Enable this setting if you have
many subdomains and want all URLs to be sent.
Load Google Analytics page code at You can control where and when to load the page code (on a rule-by-rule
Page Top or Page Bottom
basis).
Global Settings - Enable automatic
linker link tracking
Cookies
Element
Visitor Cookie Timeout
Cookie Name
Cookie Path
Cookie Domain
Description
Control how long a cookie lasts for a visitor to count as a repeat visitor. The
default value is two years.
Name of the cookie used to store analytics data.
You can restrict whether a Google Analytics cookie only functions with a
specific folder on your site.
You can change the default cookie domain. If you specified that your web
property spans multiple domains or subdomains, dynamic tag management
configures this automatically.
This field is used to configure how analytics.js searches for cookies
generated by earlier Google Analytics tracking scripts such as ga.js and
urchin.js.
67
Campaign Tracking
If your campaign parameters do not show up in the default variables (like utm_source, etc.) configure those here.
Element
Description
Hit Callback
The code you add here is executed after each hit has successfully been reported to Google Analytics.
Element
Description
Open Editor
Use the editor to customize the page code. This code is inserted into every page
immediately before the call to track the page view. If you want to cancel the initial default
_trackPageview command and write your own to customize page names, be sure to
"return false;" at the end of the script.
Rules
68
Rules
Dynamic tag management is a rule-based system. It looks for user interaction and associated data. When the criteria
outlined in your rules are met, the rule triggers the tool, script, or HTML you identified.
The identifier is what you want the rule to look for. The identifier you specify depends on the
type of rule.
Trigger
Triggers occur after a rule's conditions are met. A rule in dynamic tag management can trigger
as many discrete actions as you want.
For example, a single rule for an e-commerce Thank You page can trigger your analytics
tools and third-party tags from a single rule. There is no need to create separate rules for
each tool or tag.
Types of Rules
New vs Existing Rules
Types of Rules
There are three types of rules in dynamic tag management:
Type of Rule
Event-based
Description
Events are where the majority of interactions on sites take place. You can measure and
react to these interactions in real-time, without the need for JavaScript.
Event-based rules are executed when visitors interact with on-page elements.
By leveraging in-page interactions and page-level tagging, you can optimize based on
things like social media sharing, video interactions, tabbed interfaces, image galleries,
and product sorting and filtering.
Rules
Type of Rule
69
Description
See Event-Based Rules Example for an example of how to set your condition to look for
clicks on the various tabs on your product pages.
Page load
Let you target by URL, site section, or set up scenarios that are independent of the site
structure. For example, a page load rule can load a survey on the 5th page view or in
the 7th minute of a visitors session.
Advanced page load rules let you, for example, target specific user segments in rules.
See Page Load Rules Example.
Direct call
Designed to bypass dynamic tag management event detection and lookup systems.
Direct call rules are ideal for situations where you want to tell dynamic tag management
exactly what is happening. Also, they are ideal when dynamic tag management cannot
detect an event in the DOM, such as with Adobe Flash.
See Create conditions for direct-call rules.
Default rules
When you activate a property, dynamic tag management includes several default rules.
These rules track common interactions with your site and may help you analyze
opportunities throughout your site.
Dead Header - This rule tracks any clicks on dead (i.e. unlinked) header items.
Dead Image - This rule tracks any clicks on dead (i.e. unlinked) images.
Download Link - This rule tracks any clicks on downloadable site content.
Email Link - This rule tracks any clicks on linked emails.
Orientation Changed - This rule tracks any page orientation change (mobile relevant.)
Outbound Link - This rule tracks any clicks on links driving off site.
Telephone Dial - This rule tracks any click on a phone number.
Zoom Changed- This rule tracks any change in page zoom.
Rules
70
rule for your purchase confirmation page, and you are loading three conversion pixels in the JavaScript / Third Party
Tags section. You can add your new pixel as a new Script in the same section of that rule, without creating a new
rule.
If the Conditions are different, then you need to add a new rule.
Rules
71
If you also have Google Analytics or any other platforms installed, you can leverage the same rule to configure or
send data to as many platforms as you want.
Rules
72
When using event-based rules, dynamic tag management offers powerful tools to surface data from the page and
page elements with which the user interacts.
Rules
2. In the rule conditions, specify the page where this rule will be triggered.
3. Paste the tag your vendor gave you directly into the Third-Party Tags section.
Because dynamic tag management does not rely on templates, marketers can use any tag within a rule, even in
formatted HTML.
73
Rules
74
4. Give your rule a name that describes the user interaction like Forms: User submits form.
You can also add descriptive metadata to your rule.
This description will help you and others identify this rule if they want to use it for their tags or tools later.
5. Save your rule, and you are ready to test it in a staging environment, request rule approval, and publish to the
production site.
Note: By default, page load rules load at page bottom. This setup works for most scenarios. However, if the
rule you are setting up has some dependency on in page content, it might be better to configure the rule to
load on DOM ready. Conversely, if you have other rules that rely on the outcome of the rule in question, load
the rule at Top of Page or Onload to ensure that it fires first.
Rules
75
Rules
3. Click Save, configure your test in Adobe Target and your test is running.
76
Rules
77
Rules
78
Rules
79
DOM ready
window load
The dynamic tag management queue processes them in that order but does not distinguish between a JavaScript
and an HTML script within the page load phase.
This means that the order of the page load rules in the queue determines the order in which they are de-queued.
A simple way to determine the queue order is to look at _satellite.configurationSettings.pageLoadRules
in the JavaScript console and examine the sequence.
For example, a complete view of the page load rule queue order can be seen by entering the following code into
the JavaScript console:
_satellite.each(_satellite.configurationSettings.pageLoadRules,function(i){(i.event=='pagetop')?_satellite.notify(i.event+':
'+i.name,1):false})
_satellite.each(_satellite.configurationSettings.pageLoadRules,function(i){(i.event=='pagebottom')?_satellite.notify(i.event+':
'+i.name,1):false})
_satellite.each(_satellite.configurationSettings.pageLoadRules,function(i){(i.event=='domready')?_satellite.notify(i.event+':
'+i.name,1):false})
_satellite.each(_satellite.configurationSettings.pageLoadRules,function(i){(i.event=='windowload')?_satellite.notify(i.event+':
'+i.name,1):false})
The category field is only for your own organizational purposes and is not required. You can delete categories
by clicking the x icon in the category.
7. Set up actions for the condition to trigger.
Rules
80
Description
Enable if the event activates a link and you want the link to delay until the
event has time to fire.
Applies the event handler to the specific element that is targeted. This
setting is tied to the bubbling and layering concept in a browser.
For example, when you click an image inside an anchor tag like <a href="abc.html"><img
src="xyz.png"/></a>, you might expect the click to be associated with the anchor tag, because the tag is in
the bubble stream. However, when you inspect the click in the developer tools, the click may actually affect only
the <img> tag. To ensure that the event is handled correctly, associate the click with the <img> tag and do not
depend on the browser to bubble up the click to a parent element. An event like a click can potentially bubble up
to <body>. It is important to understand where the event is actually bound, and target it specifically to make sure
that the rule fires correctly.
Bubbling means that the event is first captured and handled by the inner most element and then propagated to
outer elements.
3. Indicate the name of the tag you want to track, and additional properties the tag has that you want to match.
Rules
81
4. Select and set up any additional criteria or condition types you wish to bind to the rule.
Rules
2. Specify for which condition you would like the rule to fire.
For example, you can select Path to identify specific pages for which you want the rule to fire.
82
Rules
83
Rules
84
5. Click Save Code, and the script will be added to the queue for the rule.
Rules
85
Condition
Function
URL
Protocol
Subdomain*
Path*
Parameter
Browser
Operating System
Device Type
Screen Resolution
Window size
Landing Page*
New/Returning Visitor
Sessions
Indicate rule to fire if visitor has had >, =, or < specified number of
sessions
Page Views
Indicate rule to fire if visitor has had >, =, or < specified number of
page views in this session or all sessions
Time on Site
Registered User
Rules
Condition
Type
Data
86
Condition
Function
Logged In
Previous Converter
Cart Amount
Indicate rule to fire if user has certain dollar value in cart as indicated
in data element (requires setup)
Cookie*
Variable Set*
Custom
87
You can deploy dynamic tag management using one or more of the following options, found on the Embed tab:
Hosting Option
Description
Implementation
1. Dynamic tag management generates
custom JavaScript libraries.
2. Dynamic tag management exports the
custom JavaScript libraries to Akamai.
Hosting Option
88
Description
Implementation
See Akamai for information about migrating from 3. The target website references the
Akamai-hosted dynamic tag management
Amazon S3 to Akamai.
libraries directly at the page level.
Amazon S3
Note: After July 31, 2015 Adobe will no
longer support Amazon S3.Your dynamic
tag management libraries on Amazon S3
will continue to be served until December
31, 2015, but in a read-only state. Any
changes made in dynamic tag
management will no longer be reflected
in these files.
To deploy additional changes to your site after
July 31, 2015, you must select one of our other
hosting options. Self-hosting (FTP Delivery or
Library Download) is always the suggested best
practice, but our 3rd party Akamai hosting is a
world class option as well.
Self-hosting: FTP
A push approach, whereby dynamic tag
1. Dynamic tag management generates
Delivery
custom JavaScript libraries.
management exports custom JavaScript
2.
Dynamic tag management exports the
libraries directly to the web content server host
custom JavaScript libraries to host server
via the FTP protocol.
via FTP.
This solution requires an FTP server and
3. The target website locally references the
custom dynamic tag management libraries.
credentials to be available on the web content
server, to publish changes to the custom
dynamic tag management libraries.
Self-hosting:
1. Dynamic tag management generates
Library Download A pull approach, whereby the application
custom JavaScript libraries.
exports custom JavaScript libraries to Amazon
2.
Dynamic tag management exports the
S3. There, the libraries can be accessed by a
custom JavaScript libraries to Akamai.
hosted server-side process.
3. Custom dynamic tag management libraries
Additionally, the libraries are available via web
are manually or programmatically moved to
the web content server.
download directly from the dynamic tag
4.
The target website locally references the
management interface.
custom dynamic tag management libraries.
This solution requires either a manual retrieval
and publication of the dynamic tag management
libraries, or the creation of an automated
process that pulls the libraries from Akamai onto
the web content server.
This approach takes the most time to set up,
but is also the most secure and flexible option.
Hosting Option
89
Description
Implementation
Hosting Considerations
Questions to consider when deciding on a hosting option.
You might consider the following questions when deciding which hosting option is best for your organization.
Dynamic tag management creates and uses various JavaScript files that
contain all the code needed to run the system. These library files can
be hosted by Adobe, or they can be hosted on your own servers, within
your own Web architecture.
The Library Download hosting option also allows you to self-host the
library files. When an authorized dynamic tag management user makes
a change in the software, our system writes those changes out to the
library files. When you host the library files on your servers with this option,
our system needs a way to get those changes to your servers. With the
Library Download hosting option, our system sends a ping (an http post)
to your system to let your servers know theres been an update to the
library files.Your I.T. team can create a cron job, or other scripted process,
so your servers can pick up the changed files. In this way, whenever a
change is made in dynamic tag management, the files youre hosting on
your servers can be updated in an automated manner.
You can use one or more of these hosting options for a Web Property just dont use more than one Embed code in any single page. For example,
you could use Akamai in your staging environments, and one of the
self-hosted options in your production environments. Or, you could use
the Akamai option for any sites, domains, or subdomains hosted by one
of your agency partners. These options give you more flexibility to host
the library files according to your specific needs.
90
Yes, you can turn on and use any number of the hosting options and use
different Embed codes for different domains or subdomains.
For example, you may want to use the Akamai option for your lower-level,
non-production environments like staging, dev, test, or UAT. At the same
time, you may use one of the self-hosted options, like Library Download,
for your production environments.
Remember that you cannot use more than one option on the same page.
You do should not implement more than one Header Embed code on any
page.
Akamai
The primary external hosting option. Akamai provides you with a reliable hosting experience and is the simplest
option to implement. Akamai provides the greatest third-party infrastructure dependencies, such as DNS lookup,
faster load times, and round-trip delivery time.
The Akamai hosting option allows you to store your Web property library files on Adobes Edge CDN, which sits on
the Akamai architecture. This option allows you to install the Embed codes in your page templates and quickly get
up and running with dynamic tag management, without involving your internal I.T. teams and servers.
91
Note: After July 31, 2015 Adobe will no longer support Amazon S3. Your dynamic tag management libraries
on Amazon S3 will continue to be served until December 31, 2015, but in a read-only state. Any changes
made in dynamic tag management will no longer be reflected in these files.
To deploy additional changes to your site after July 31, 2015, you must select one of our other hosting options.
Self-hosting (FTP Delivery or Library Download) is always the suggested best practice, but our 3rd party
Akamai hosting is a world class option as well.
Why Choose Akamai Hosting for Library Files?
Can I Avoid Errors in Case of Akamai Unavailability?
Why Choose Akamai Hosting for Library Files?
When you choose the Akamai option in the Embed section of dynamic tag management, it means that your dynamic
tag management library files are served to your visitors from Adobes Edge CDN, which runs on Akamai architecture.
Akamai is robust when serving content to a global, high-volume audience of Web visitors. They run redundant
networks of load-balanced, geo-optimized nodes to serve content as quickly as possible to visitors wherever they
are located throughout the world.
Specifically, they run over 137,000 servers in 87 countries within over 1,150 networks. In terms of redundancy, they
do not just route from one server to another, they route from one node of servers to another node of servers as-needed.
In other words, each node consists of multiple servers for redundancy within a node, so a box going down is not an
issue. The other boxes in the node take over. If a node goes down, they serve from the next closest one, with the
same cached content. Nodes are dynamically selected based on visitor location, traffic load, and other factors so
content is consistently served from the best local node for each visitor.
Can I Avoid Errors in Case of Akamai Unavailability?
No. Dynamic tag management can do nothing from the client side if the library is unavailable. However, it is extremely
unlikely that Akamai would be unavailable.
92
FTP
Steps to deploy dynamic tag management using FTP (the push methodology).
The FTP Delivery hosting option allows you to self-host the library files. When an authorized dynamic tag management
user makes a change in the software, dynamic tag management writes those changes out to the library files. When
you host the library files on your servers with this option, dynamic tag management must get those changes to your
servers. With the FTP Delivery hosting option, dynamic tag management connects to your system, using credentials
and server locations you enter into the system, and delivers any changed files. In this way, whenever a change is
made in dynamic tag management, the files you are hosting on your servers can be updated automatically.
You have to be an Admin user to be able to deploy via FTP.
1. In the web property, click the Embed tab.
2. Click FTP Delivery.
3.
4.
5.
6.
93
Provide the required FTP information for the staging and production servers, then click Save FTP Information.
Toggle the switch in the top right corner to ON.
Click Header Code and Footer Code to expand those sections.
Click the appropriate Copy Embed Code button to copy header and footer codes to your staging or development
environments.
Note: The staging code should go only into your staging or development environment. Production code
should be placed on the live production site.
7. Copy the header code and place it within the HEAD section of the site HTML, on every page of the website.
Place it as close to the beginning <head> tag as possible.
8. Copy the footer code and place it within the BODY section of the site HTML, on every page of the website. Place
it as close to the closing </body> tag as possible
Library Download
Steps to deploy dynamic tag management using Library Download (the pull methodology).
The Library Download hosting option also allows you to self-host the library files. When an authorized dynamic tag
management user makes a change in the software, dynamic tag management writes those changes out to the library
files. When you host the library files on your servers with this option, dynamic tag management must get those
changes to your servers. With the Library Download hosting option, dynamic tag management sends a ping (an
HTTP post) to your system to let your servers know there has been an update to the library files. Your I.T. team can
create a cron job, or other scripted process, so your servers can pick up the changed files. In this way, whenever a
change is made in dynamic tag management, the files you are hosting on your servers can be updated automatically.
You must be an administrator to deploy using the Library Download.
1. In the web property, click the Embed tab.
2. Click Library Download in the left navigation.
94
Option
Description
Shared Secret
The process of deploying dynamic tag management files to the server can be
automated whenever there is an update. Create a script that is accessible via
the specified public URL.
4. Complete the fields under Domain and Paths to Tracking File, for staging and production.
Specify the location where the files reside when deployed to your server. Do not include the protocol or any
leading or trailing slashes. Dynamic tag management requires a domain and a path for HTTP or HTTPS for the
production and staging environments.
5. Download the files from the specified URL for the respective environment (staging or production), and deploy
them to the location specified in the settings.
6. Click the Header Code and Footer Code sections.
7. Click the appropriate Copy Embed Code button to copy header and footer codes to your staging or development
environments.
Note: The staging code should go only into your staging or development environment. Production code
should be placed on the live production site.
8. Copy the header code and place it within the HEAD section of the site HTML, on every page of the website.
Place it as close to the beginning <head> tag as possible.
9. Copy the footer code and place it within the BODY section of the site HTML, on every page of the website. Place
it as close to the closing </body> tag as possible
95
1. Copy the production header code and place it within the HEAD section of your site HTML.
Preferably, place the code as close to the <head> tag as possible. This code snippet should be placed on every
page of your live production site.
Note: Production embed code reflects only the published items in that property. However, embed code
for staging reflects all items in the associated property, regardless of the published or unpublished state.
To test unpublished items on your production site, locally enable staging in the console by following the
instructions in Test unpublished rules for Akamai hosting.
2. Copy the production footer code and place it in the BODY section of your site HTML.
Preferably, place the code as close to the </body> tag as possible.
3. Copy the staging header and footer code, then repeat the steps above on your staging site.
Note: The difference between production and staging code snippets is the addition of -staging to the
filename in the staging version. The footer code remains the same in staging and production.
4. Press Enter.
If the code was properly installed, you will see true display in the console.
If the code was not properly installed, you will see the reference error:
_satellite is not defined
96
Create
Rules
Edit Rules
Test
Rules
Approve
Rules
Publish
Rules
User
Yes
Yes
Yes
Approver
Yes
Yes
Yes
Publisher
Yes
Yes
Yes
Approver and
Publisher
Yes
Yes
Yes
Yes
Yes
Administrator
Yes
Yes
Yes
Yes
Yes
Create/Edit
Users
Create
Property
Yes
Yes
Yes
Yes
Invite a user
Invite a user to dynamic tag management.
1.
2.
3.
4.
5.
97
Once you rename the Analytics object then you are able to run both implementations: your original one and the one
within dynamic tag management.
Task
Description
Step 1
98
Step
Task
Description
Step 2
Step 3
Dynamic Tag
Management
Migration Instructions
Custom Core
JavaScript
JavaScript / Third
Party Tag
Product Code
Tag Manager 1.0
Product Code Tag
Dynamic Tag
Management
Migration Instructions
SiteCatalyst
Adobe Analytics
Tool
Option 1
Host code using the Managed by Adobe option. This method
leverages the base version of the AppMeasurement code and allows
you to choose between the latest available code versions.
Dynamic Tag
Management
99
Migration Instructions
Dynamic Tag
Management
100
Migration Instructions
Paste this code into the Custom editor in the Adobe Analytics tool in
dynamic tag management.
Then, from the same preview file in ATM, copy the below the line
code. This code begins with:
/************* DO NOT ALTER ANYTHING BELOW THIS LINE!
**************/
Dynamic Tag
Management
101
Migration Instructions
and ends with the second setTagContainer function. (In this case,
include the setTagContainer function, because this code should not
be altered). Ensure the code only in this block is included. Any code
set in the Custom Code (after products) section is included after this
code block in the preview file, so ensure that only the intended code
block is included in the copy. For example:
Dynamic Tag
Management
102
Migration Instructions
Paste the code into the same Custom editor in dynamic tag
management after the above this line code.
Note: Since mistakes can occur with copy / paste, please be
sure to review the implementation in dynamic tag management
thoroughly and test extensively in staging before publishing to
production to ensure the expected behavior is accomplished.
Demdex
Adobe Audience
Manager Tool
Dynamic Tag
Management
Migration Instructions
HTML
HTML
JavaScript
JavaScript
Image Beacon
HTML
Remote Script
HTML
103
Dynamic Tag
Management
Migration Instructions
IFrame
HTML
Note: If the conditions set in the firing rules are the same between each custom tag, they can be placed into
a single rule in dynamic tag management.
Migration Instructions
Adobe Analytics Follow the instructions in Adobe Analytics Settings to add an Adobe Analytics
Tool
tool in dynamic tag management.
Option 1
Host code using the Managed by Adobe option. This method leverages the
base version of the AppMeasurement code and allows you to choose between
the latest available code versions.
104
Migration Instructions
With this option, above this line customization can be configured in the
available interface fields or pasted into the Customize Page Code editor.
Option 2
Manually host the s_code / AppMeasurement file in dynamic tag management.
This method is recommended when the current code is highly customized or
if a legacy code version is used.
1.
2.
3.
4.
In Adobe Tag Management 2.0, click Edit next to the latest container file.
Click Preview to view the generated file.
Locate the sitecatalyst JS file and click See content.
Copy all of the above this line code.
This is all of the code beginning with the s_account declaration and ending
with the first s.setTagContainer command. (Do not include this
s.setTagContainer in this situation). Here is an example:
Paste this code into the Custom editor in the Adobe Analytics tool in dynamic
tag management.
105
Migration Instructions
"Then, from the same preview file in ATM, copy the below this line code. This
is code begins with:
/************* DO NOT ALTER ANYTHING BELOW THIS LINE!
**************/
Paste the code into the same Custom editor in dynamic tag management
after the above this line code.
Note: Since mistakes can occur with copy / paste, please be sure to
review the implementation in dynamic tag management thoroughly and
106
Migration Instructions
Adobe Target
Audience
Management
Adobe Target
Tool
Adobe Audience
Configure Adobe Audience Management Settings.
Manager Tool
Custom Code
2.0 Custom Code
Tag
Dynamic Tag
Management
Migration Instructions
HTML
HTML
JavaScript
JavaScript
Remote Script
HTML
IFrame
HTML
107
Note: If the conditions set in the firing rules are the same between each custom tag, they can be placed into
a single rule in dynamic tag management.
108
Architecture
109
Architecture
Information about dynamic tag management architecture.
Architecturally, dynamic tag management comprises two main components:
Management Application: Offers an easy-to-use, tab-structured configuration user interface.
JavaScript libraries: Produced by the Management Application and transported to hosting servers. Dynamic tag
management includes two types of JavaScript libraries, a staging library and a production library.
Staging library: Every change you make in the Management Application is immediately updated to use on the
staging server.
Production library: Only the final, approved version of a tool or of rules makes it onto the production server.
This model fits well into the approval workflow, in that development or staging code is never accidentally included
in the production library.
See Publish Workflow.
Troubleshooting
110
Troubleshooting
Describes several troubleshooting scenarios and their solutions.
I see a JavaScript error in my console when I load dynamic tag management.
Theres likely an issue with your dynamic tag management installation. To view the current installation, right click
on any page of the site and click View page source. Then type CTRL+F to open the search box and type satellite.
This locates the embed snippets of dynamic tag manager. There should be two instances of these snippets on the
page. The first should be right before the </head> tag. The second should be right before the </body> tag.
Example of Header script:
<script src=//s3.amazonaws.com/searchdiscovery-satellite-production/[client specific
path]/satelliteLib-[client specific path].js>
</script>
</head>
Selector Syntax:
CSS Selector Syntax: div.pauseButton OR div[class=pauseButton]
Manually assign attributes:
Element Tag: div
Property: class
Value: pauseButton
My rule fires inconsistently.
There are two possible reasons for a rule to fire inconsistently:
1: Does the event action incite a link to load? If so, the rule may not have enough time to fire before the new page
loads. You need to check the box within the rule identifier indicating Delay link activation. This keeps the activated
link from loading until the rule has fired.
2: If the event does not incite a new page load, there may be an issue with bubbling. If the event action can occur
on a child or parent item, ensure the button indicating Allow events on child elements to bubble is checked. This
ensures that the rule fires whether or not the user interacts with the child or parent element.
My third-party or custom script does not trigger when my page load rule fires.
Verify what type of script you are using and the load option you have chosen for the rule. If you use sequential HTML,
your rule must be set to load at Bottom / Top of Page. The script will not work if the rule is set to load Onload or
DOM ready.
Troubleshooting
111
I get this error: Unexpected token: operator (<) (line: X, col: Y).
Youve likely chosen the incorrect setup type for your script. Based on the contents of the script, the editor was
expecting HTML, but you set the script to JavaScript or vice versa.
For example: if your script contains <script> tags, but you set the script up as JavaScript, you will receive this error
when you attempt to save the code.
My data element setup does not seem to be working - how do I test it?
Navigate to a page where the data element should be available on your site. Open your web console and type in
_satellite.getVar(dataelementname) and press enter. This action returns any value that is present for the
noted data element on that page. If the value is undefined, the data element is likely setup incorrectly. If the value
is null, then that data element may not have a value on that particular page.
My rule is firing, but my data element wont populate.
Theres likely a timing issue. Check and see where the rule is loading; if its loading at Top of Page or Onload, then
the data element is likely not available yet when the rule fires. Try switching the rule to load at Bottom of Page or
DOM Ready. If the data element still does not populate, refer to method for the previous question to ensure the data
element is available on the page.
When I click an internal link on my site, a new window opens when it should not. How do I control the linker
link?
There is likely a code conflict with the linker link feature. Navigate to your analytics tool within your web property
and click the settings gear icon next to the tool. Expand the General tab of the settings. Under Global Settings,
you can control the linker link functionality. From here, you can either turn the linker link feature off or you can set
it up to activate / not activate on specific element types or selectors.
Glossary
112
Glossary
Terms used in dynamic tag management.
Term
Adobe Analytics
Definition
Adobe's hosted, subscription-based solution for real-time website reporting and analysis.
You can deploy Adobe Analytics using dynamic tag management by creating the Adobe
Analytics Tool and configuring the page code either automatically or manually.
Approvals
Audience management
Campaign
ClickMap
Cookie
Customize Page Code
Data Center
Data Element
Data elements are the building blocks for rules. Data elements let you create a data
dictionary (or data map) for any object that is contained on your site. They can be
JavaScript objects, cookie values, and query strings.
Designed to bypass dynamic tag management event detection and lookup systems.
Direct call rules are ideal for situations where you want to tell dynamic tag management
exactly what is happening. Also, they are ideal when dynamic tag management cannot
detect an event in the DOM, such as with Adobe Flash.
DTM Switch
DTM Switch is a browser plugin for easy switching of debug mode and staging mode
for DTM users. It is available for both Chrome and Firefox.
Embed
Global Variables
Google Analytics
Page Load
Link Tracking
Marketing Cloud
Property
Glossary
Term
113
Definition
Publish
Referrer
Rules
Staging
Tag
Target
Tool
Tracking Server
Dynamic tag management is a rule-based system. It looks for user interaction and
associated data. When the criteria outlined in your rules are met, the rule triggers the
tool, script, or HTML you identified.
Documentation Updates
114
Documentation Updates
Information about updates to the dynamic tag management help.
Date
Description
Location
12/15/2014
Updated migration from Adobe Tag Manager Migrating from Adobe Tag Management
1.0 and 2.0 to dynamic tag management.
12/08/2014
11/21/2014
Updated Adobe Media Optimizer tool settings. Adobe Media Optimizer Settings
11/7/2014
10/23/2014
10/23/2014
10/23/2014
08/27/2014
08/26/2014
08/08/2014
08/07/2014
07/24/2014
07/24/2014
FAQ - Advanced
Documentation Updates
Date
115
Description
Location
06/16/2014
05/06/2014
Web Properties
05/06/2014
Added queue processing information after the Load Order for Rules
Load Order diagram.
04/22/2014
04/04/2014
04/01/2014
03/20/2014
03/19/2014
Akamai
03/19/2014
Web Properties
Data Elements
03/18/2014
03/05/2014
02/27/2014
Documentation Updates
Date
116
Description
Note: Adobe supports the dynamic tag
management implementations only as
outlined on the pages in this section of
Adobe Help. Asynchronous or other
deployment methods are not supported.
02/07/2014
Location
Header and Footer Code
General
01/17/2014
Akamai Hosting
01/16/2014
12/16/2013
12/09/2013
Reauthored help.
All topics.
11/20/2013
11/19/2013
Added a note about copying the content after See the Product Code heading.
Do Not Alter Anything Below this Line from
the s_code, when migrating from TagManager
2.0 to dynamic tag management.
11/13/2013
11/07/2013
11/06/2013
11/06/2013
Data Elements
Documentation Updates
117
Date
Description
Location
10/30/2013
118
Description
Report suites are automatically synchronized via a Marketing Cloud login or Web
Services ID.
Once the accounts are connected, dynamic tag management pulls the Adobe
Analytics report suite IDs and names into the tool configuration interface, allowing
for increased speed in tool deployment with less possibility for user errors.
Adobe managed measurement You can let dynamic tag management loads and manage the base library directly.
library option.
You no longer need to cut and paste library code from the Adobe Analytics
administration tools. This feature also makes upgrades to new versions of
AppMeasurement easier, because the base code and custom code are stored
separately.
Custom Code timing.
You can now select whether you want the code in the Adobe Analytics code panel
to fire before or after the interface settings for more implementation flexibility.
Interface improvements.
The groups (General, Library Management, and so on) on the Tools page for
Adobe Analytics has been reorganized and streamlined to simplify configuration.
Latest Links
See FAQ for Adobe Analytics Release - July 24 2014 for questions and answers.
See Adobe Analytics Settings for configuration information.
July 10 2014
Features and fixes:
Feature
Description
Click Log in the left-hand rail to view the Audit Log page.
Company administrators can view, filter, and export a list of all activities that
take place within companies and web properties to which they have access.
This feature is helpful both for auditing and troubleshooting purposes.
For example, you can view and filter by:
Successful logins
Account names
Feature
119
Description
IP addresses
Companies
Web Properties (and see who created them and when)
Roles, and more.
You can also export the log data to .csv.
Language Selector
120
Fixed and issue where the command bar was sticking to the bottom of the Approvals page. The persistent bar
with the Edit and Reject commands on the Approvals page was sticking to the bottom of the page rather than
following the page view upon scroll.
Fixed an issue on the Rule List page, where a newly created rule showed Adobe Analytics in use, even if those
rules were not using Adobe Analytics.
Fixed layout issues on Selective Publish queue page. We cleaned up the layout so that it is not truncated or
stretching beyond the boundary of the content area of the page.
Data elements now display in alphabetical order in the Data Element Value criteria of a rule. They have now been
alphabetized for easier viewing.
The items on the publish history are now paginated to improve performance and user experience.
Added password security enhancements. To ensure the security for dynamic tag management accounts, we have
implemented a number of enhancements to our authentication system:
New passwords must meet specific criteria (minimum 7 characters, at least one number, at least one letter, at
least one symbol, not one of the last 5 passwords).
Company admins can now see how long it has been since a user last changed their password.
Company admins can now force users to reset their password.
Users attempting to log in 5 times unsuccessfully will be locked out for 30 minutes to prevent brute force attacks
(the user or their company admin can reset the password to re-enable access immediately).
May 8 2014
Fixes for May 8, 2014:
Fixed an issue where trackingServer value was not being applied consistently. The value for s.TrackingServer
should be used consistently for all types of calls throughout dynamic tag management, and the value should be
pulled either from the custom code or from the UI, depending on the configuration of a specific web property. (The
UI value takes precedence if set in both locations.)
Fixed an issue where properties with a large number of items awaiting approval was causing 500 errors and
timeouts. We optimized the queries for the approvals workflow to ensure that properties with a large number of
items awaiting approval would load quickly and not result in timeouts, errors, or broken pages.
Fixed an issue where pages with an existing object called 's' would cause errors in dynamic tag management.
Dynamic tag management tries to initialize an 's' object on the page for Adobe Analytics tracking, and this was
causing a conflict if Analytics was implemented via dynamic tag management and the Page code already exists
box was not checked. The object is now locally scoped within dynamic tag management, so it will work in any
custom code scenarios but will not conflict with any on-page code.
We made a number of improvements to the way that hierarchies are managed in Adobe Analytics tools and rules,
including ensuring that non-sequential hierarchies could be used together in a tool or rule, and ensuring that the
same hierarchy could not be set more than once in a tool or rule.
April 28 2014
Fixes for April 28, 2014
Fixed an issue where direct call and event-based rules that were configured to send a page view (using s.t())
were not executing custom code.
April 17 2014
Fixes for April 17, 2014
Fixed an issue in which an error displayed when you delete data elements that were associated with rules that had
already been deleted.
Fixed an issue in which deleted data elements were still shown in the menu when you add a condition to a rule
based on a data element.
121
Fixed an issue where fields and values for Google Universal Analytics rules were showing as modified in the
Approval view, even if the rules had not been changed. This issue also occurred on new rules.
Fixed an issue where the Google Universal Analytics tool configuration allowed you to configure the cookie timeout
in milliseconds, even though Google Universal Analytics does not support this.
Changed AdLens to Media Optimizer.
Users can now use the % syntax to view the pop-up list of data elements when sending values to Media Optimizer.
Modified styling on tool lists to better accommodate tools with long names, and to improve readability.
April 8 2014
Fixes for April 8, 2014
Fixed the styling on the Forgot Password page to improve appearance.
Fixed an issue where approved/published rule conditions were being removed from production library upon deletion
in staging.
Fixed an issue where the Actions menu on the Rule List page was being cut off at the bottom, if there were less
than three rules being displayed.
Fixed alignment for the Create Data Element button on the Data Elements page.
Fixed alignment for the Create New Schedule button on the Scheduling page.
Fixed an issue where long rule names were breaking the Selective Publish page.
Fixed an issue where deleting Adobe Analytics variable values would, in certain cases, result in a broken UI that
required a page refresh to fix.
April 3 2014
Features for April 3, 2014
Feature
Description
122
Fixed issue where test files (ftp_test.txt) were being left on FTP/SFTP servers after upload was complete.
This file is now deleted once the upload is complete as it is only used to test the ability to validate user credentials
and is not actually needed by dynamic tag management.
Fixed issue where custom port for FTP/SFTP was not being saved.
March 6 2014
Features and fixes for the March 6, 2014 release:
Feature
Description
Fixes
Fixed issue with SVG images in older IE browsers. SVG images that were clicked in older IE browsers (prior to IE
version 9) caused errors and would sometimes cause the browser to crash.
Fixed issue with custom links in direct call rules. Using custom links in direct call rules would generate a JavaScript
error in the browser.
Fixed issue with data element rule conditions referencing the wrong name. If a user renamed a data element, and
the data element was being referenced in a rule condition, the rule would try to use the most recently specified
name for that data element. This issue occurred even if the name change had not yet been published.
Fixed issue where elements without an HREF attribute caused errors when clicked. This issue is regarding the
"linker link" functionality in the dynamic tag management engine, which attempts to automatically track any clicked
elements on the page. Elements without an HREF were generating errors. The "linker link" code now checks that
the element is an anchor tag before attempting to track clicks on it.
February 4 2014
Fixes for the February 4 2014 release:
Fixed Issue
Description
Fixed issue with invalid URLs being accepted in Users were able to enter invalid URLs on a web property. Valid
web property configurations.
URLs are now required.
Fixed issue with port being stripped from deploy The deploy hook URLs containing a non-default port would have
hook URL.
the port removed before the HTTP call was made. This issue
resulted in deploy hook notifications being sent to the wrong URL.
January 28 2014
Fixes for the January 28 2014 release:
123
Fixed Issue
Description
January 21 2014
Fixes for the January 21 2014 release:
Fixed Issue
Description
January 16 2014
Fixes for the January 16 2014 release:
Fixed Issue
Description
Fixed Issue
124
Description
Companies created prior to January 15, 2014 will be able to
choose between Akamai and Amazon S3 until this option is
deprecated on December 31, 2014. Any new properties created
within dynamic tag management companies that existed prior to
January 15, 2014 will also have the option of choosing between
Amazon S3 and Akamai.
For information about migrating from Amazon S3 to Akamai, see
Akamai Hosting
User lists for companies and web properties are now paginated
(if the company or web property has more than 25 users). This
change was done to improve both user experience and platform
performance.
Use caution when taking this action, because deleting the web
property removes all tools, rules, and settings and cannot be
undone.
Multiple rules containing custom Adobe Analytics Previously, if multiple page load rules fire and they all had custom
code now fire correctly.
code for Adobe Analytics, only one of the rules would take effect.
Batch deactivation of rules now working.
Login via Adobe ID now looks identical to the login page for
marketing.adobe.com.
November 19 2013
The following table provides information about release notes and fixes for this release.
Fixed Issue
Description
125
Fixed Issue
Description
November 12 2013
The following table provides information about release notes and fixes for this release.
Fixed Issue
Description
Fixed an issue where tools that had been deleted were still showing
up in the Rules tab.
October 30 2013
The following table provides information about release notes and fixes for this release.
Fixed Issue
Description
126
Fixed Issue
Description
Sidebar collapse icon not appearing correctly in The icon that appears to the left of the breadcrumbs allowing a
Firefox.
user to collapse/expand their sidebar was not displaying correctly
in Firefox. It should now be displaying correctly.
Company admin can see who invited a user.
Administrators can now see the name of the person who invited
a particular user to their company (if the person who invited the
user is an Adobe employee, the admin will simply see DTM Admin
in place of the name).
Adding Target arguments breaks rule formatting. Fixed an issue where a user adding arguments to a rule
containing an Adobe Target tool would see an incorrectly
formatted/broken UI
October 23 2013
The following table provides information about release notes and fixes for this release.
Fixed Issue
Description
Timestamps embedded in the _satellite object Whenever a new version of the library is published, the
_satellite object will now contain two new properties:
for publish and build.
publishDate: The user requested the publish to happen (the
same date/time that appears in the History section of the UI).
buildDate: The file was created by our server processes. The
difference between the two can be used to troubleshoot
potentially processing latency issues.
New tools and data elements can be created with Previously when a tool or data element was deleted, you could
the same name as those of deleted tools and data not create a new tool or data element with that same name. Now,
elements.
after a tool or data element has been deleted, a new one can be
created with the same name.
If the original is later restored, "(restored)" is appended to the
name to avoid naming conflicts.
Left navigation sidebar is now collapsible
Adding Target arguments breaks rule formatting. Fixed an issue where a user adding arguments to a rule
containing an Adobe Target tool would see an incorrectly
formatted/broken UI.
October 15 2013
The following table provides information about release notes and fixes for this release.
127
Fixed Issue
Description
Breadcrumb wrapping
incorrectly in Chrome
The breadcrumb display at the top of the page was wrapping incorrectly in Chrome
on certain types of pages.
Rule pages will now show only 25 rules per page and will require users to "page
through" to see the full list. This is being done both for user experience and for
performance reasons (it's less stressful on the server to produce a list of 25 rules
vs. several hundred in the case of some of our clients).
A user can now filter the rule page by the name of the rule or the name of third
party tags contained within a rule.
Tool approvals
Engine shows Analytics instead When looking at debug messages from the dynamic tag management engine, it
of SiteCatalyst
now says "Adobe Analytics" instead of "SiteCatalyst" for any messages relating
to the Analytics product and its associated rules.
See Also
Previous Release Notes for historical dynamic tag management release notes.
September 30 2013
The following table provides information about release notes and fixes for this release.
Fixed Issue
Description
This pertains to the above story about automating new property approval.
Superadmins used to have a section called "Pending Activation" on their dashboard;
this story was to remove that section since it's no longer needed.
Company admins now have the same ability as superadmins to copy rules across
any companies/properties they have access to.
Changing type of data element When changing the type of a data element previously, it used to retain some of
retains previous values
the old parameters specified by the user. We're now clearing all parameters and
ensuring that the library only contains whatever parameters are relevant to the
currently selected type.
128
Fixed Issue
Description
Added the ability to click a "Resend" link in the Users tab for a company in case
a user didn't receive their invitation e-mail for some reason. (Previously this required
revoking the invite and recreating it from scratch)
129