Integrating with Adobe Dynamic Tag Management
- Topics:
- Administering
CREATED FOR:
- Admin
Integrate Adobe Dynamic Tag Management with AEM so that you can use your Dynamic Tag Management web properties to track AEM sites. Dynamic Tag Management enables marketers to manage tags for collecting data, and distribute data across digital marketing systems. For example, use Dynamic Tag Management to collect usage data for your AEM website and distribute the data for analysis in Adobe Analytics or Adobe Target.
Before you integrate, you need to create the Dynamic Tag Management web property that tracks the domain of your AEM site. The hosting options of the web property must be configured so that you can configure AEM to access the Dynamic Tag Management libraries.
After you configure the integration, changes to Dynamic Tag Management deployment tools and rules do not require you to change the Dynamic Tag Management configuration in AEM. The changes are automatically available to AEM.
- 3.x is configured with http://localhost:4502/system/console/configMgr/com.day.commons.httpclient
- 4.x is configured with http://localhost:4502/system/console/configMgr/org.apache.http.proxyconfigurator
Deployment Options
The following deployment options affect the configuration of the integration with Dynamic Tag Management.
Dynamic Tag Management Hosting
AEM supports Dynamic Tag Management that is hosted in the cloud or hosted on AEM.
- Cloud-hosted: The Dynamic Tag Management javascript libraries are stored in the cloud, and your AEM pages reference them directly.
- AEM-hosted: Dynamic Tag Management generates javascript libraries. AEM uses a workflow model to obtain and install the libraries.
The type of hosting that your implementation uses determines some of the configuration and implementation tasks that you perform. For information about the hosting options, see Hosting - Embed Tab in Dynamic Tag Management Help.
Staging and Production Library
Decide whether your AEM author instance uses the Dynamic Tag Management staging or production code.
Typically your author instance uses the Dynamic Tag Management staging libraries, and the production instance uses the production libraries. This scenario enables you to use the author instance to test unapproved Dynamic Tag Management configurations.
If desired, your author instance can use the production libraries. Web browser plugins are available that enable you to switch between the use of staging libraries for testing purposes when the libraries are cloud-hosted.
Using the Dynamic Tag Management Deployment Hook
When AEM hosts the Dynamic Tag Management libraries, you can use the Dynamic Tag Management deployment hook service to automatically push library updates to AEM. Library updates are pushed when changes are made to the libraries such as when the Dynamic Tag Management web property properties are edited.
To use the deployment hook, Dynamic Tag Management must be able to connect to the AEM instance that hosts the libaries. You must enable access to AEM for the Dynamic Tag Management servers.
In some circumstances AEM can be unreachable, such as when AEM lies behind a firewall. In these cases, you can use the AEM polling importer option to periodically retrieve the libraries. A cron job expression dictates the schedule for library downloads.
Enabling Access for the Deployment Hook Service
Enable the Dynamic Tag Management deployment hook service to access AEM so that the service can update the AEM-hosted libraries. Specify the IP address of Dynamic Tag Management servers that update the staging and production libraries as required:
- Staging:
107.21.99.31
- Production:
23.23.225.112
and204.236.240.48
Perform the configuration using either the Web Console or a sling:OsgiConfig
node:
- In the Web Console, use the Adobe DTM Deploy Hook Configuration item on the Configuration page.
- For an OSGi configuration, the service PID is
com.adobe.cq.dtm.impl.servlets.DTMDeployHookServlet
.
The following table describes the properties to configure.
Web Console property | OSGi property | Description |
---|---|---|
Staging DTM IP White List | dtm.staging.ip.whitelist | The IP address of the Dynamic Tag Management server that updates the staging libraries. |
Production DTM IP White List | dtm.production.ip.whitelist | The IP address of the Dynamic Tag Management server that updates the production libraries. |
Creating the Dynamic Tag Management Configuration
Create a cloud configuration so that the AEM instance can authenticate with Dynamic Tag Management and interact with your web property.
General Settings
Property | Description |
---|---|
API Token | The value of the API Token property of your Dynamic Tag Management user account. AEM uses this property to authenticate with Dynamic Tag Management. |
Company | The company with which your login ID is associated. |
Property | The name of the Web Property that you created for managing the tags for your AEM site. |
Include Production Code on Author |
Select this option to cause the AEM author and publish instances to use the production version of the Dynamic Tag Management libraries. When this option is not selected, the Staging Settings apply to the author instance, and the Production Settings apply to the publish instance. |
Self Hosting Properties - Staging and Production
The following properties of the Dynamic Tag Management configuration enable AEM to host the Dynamic Tag Management libraries. The properties enable AEM to download and install the libraries. Optionally, you can automatically update the libraries to ensure they reflect any changes made in the Dynamic Tag Management management application.
Some properties use values that you obtain from the Library Download section of the Embed tab for your Dynamic Tag Management web property. For information, see Library Download in Dynamic Tag Management Help.
When hosting the Dynamic Tag Management libraries on AEM, AEM automatically configures some properties of the web property according to your configuration. See the descriptions in the following table.
Property | Description |
---|---|
Use Self Hosting | Select when you are hosting the Dynamic Tag Management library file on AEM. Selecting this option causes the other properties in this table to appear. |
DTM Bundle URL | The URL to use for downloading the Dynamic Tag Management library. Obtain this value from the Download URLs section of the Library Download page of Dynamic Tag Management. For security reasons, this value must be configured manually. |
Download Workflow |
The workflow model to use for downloading and installing the Dynamic Tag Management library. The default model is Default DTM Bundle Download. Use this model unless you have created a custom model. Note that the default download workflow automatically activates the libraries when they are downloaded. |
Domain Hint |
(Optional) The domain of the AEM server that is hosting the Dynamic Tag Management library. Specify a value to override the default domain that is configured for the Day CQ Link Externalizer service. When connected to Dynamic Tag Management, AEM uses this value to configure the Staging HTTP Path or the Production HTTP Path of the Library Download properties for the Dynamic Tag Management web property. |
Secure Domain Hint |
(Optional) The domain of the AEM server that is hosting the Dynamic Tag Management library over HTTPS. Specify a value to override the default domain that is configured for the Day CQ Link Externalizer service. When connected to Dynamic Tag Management, AEM uses this value to configure the Staging HTTPS Path or the Production HTTPS Path of the Library Download properties for the Dynamic Tag Management web property. |
Shared Secret |
(Optional) The shared secret to use for decrypting the download. Obtain this value from the Shared Secret field of the Library Download page of Dynamic Tag Management. Note: You must have the OpenSSL libraries installed on the computer where AEM is installed so that AEM can decrypt the downloaded libraries. |
Enable Polling Importer |
(Optional) Select to periodically download and install the Dynamic Tag Management library to ensure you are using an updated version. When selected, Dynamic Tag Management does not send HTTP POST requests to the Deploy Hook URL. AEM automatically configures the Deploy Hook URL property of the Library Download properties for the Dynamic Tag Management web property. When selected, the property is configured with no value. When not selected, the property is configured with the URL of your Dynamic Tag Management configuration. Enable polling importer when the Dynamic Tag Management deploy hook cannot connect to AEM, for example when AEM is behind a firewall. |
Schedule Expression | (Appears and is required when Enable Polling Importer is selected.) A cron expression that controls when the Dynamic Tag management libraries are downloaded. |
Cloud Hosting Properties - Staging and Production
You configure the following properties for your Dynamic Tag Management configuration when Dynamic Tag Configuration is cloud-hosted.
Property | Description |
---|---|
Use Self Hosting | Clear this option when the Dynamic Tag Management library file is hosted in the cloud. |
Header Code |
The header code for staging that is obtained from Dynamic Tag Management for your host. This value is populated automatically when you connect to Dynamic Tag Management. To see the code in Dynamic Tag Management, click the Embed tab, then click the host name. Expand the Header Code section and click the Copy Embed Code of the Staging Embed Code or the Production Embed Code area as required. |
Footer Code |
The footer code for staging that is obtained from Dynamic Tag Management for your host. This value is populated automatically when you connect to Dynamic Tag Management. To see the code in Dynamic Tag Management, click the Embed tab, then click the host name. Expand the Footer Code section and click the Copy Embed Code of the Staging Embed Code or the Production Embed Code area as required. |
The following procedure uses the touch-optimized UI to configure the integration with Dynamic Tag Management.
-
On the rail, click Tools > Operations > Cloud > Cloud Services.
-
In the Dynamic Tag Management area, one of the following links appear for adding a configuration:
- Click Configure Now if this is the first configuration that you are adding.
- Click Show Configurations and then click the + link beside Available Configurations if one or more configurations have been created.
-
Type a title for the configuration and then click Create.
-
In the API Token field, enter the value of the API Token property of your Dynamic Tag Management user account.
To obtain the value of your API Token contact DTM Client Care.
NOTE
The API token does not expire until the Dynamic Tag Management user explicitly requests it. -
Click Connect to DTM. AEM authenticates with Dynamic Tag Management and retrieves the list of companies that your account is associated with.
-
Select the Company, and then select the Property that you are using to track your AEM site.
-
If you are using staging code on the author instance, deselect Include Production Code On Author.
-
Provide values for the properties on the Staging Settings tab and the Production Settings tab if needed, and then click OK.
Manually Downloading the Dynamic Tag Management Library
Manually download the Dynamic Tag Management libraries to immediately update them on AEM. For example, manually download when you want to test an updated library before the polling importer is scheduled to automatically download the library.
-
On the rail, click Tools > Operations > Cloud > Cloud Services.
-
In the Dynamic Tag Management area, click Show Configurations and then click your configuration.
-
In either the Staging Settings area or the Production Settings area, click the Trigger Download Workflow button to download and deploy the library bundle.
/etc/clientlibs/dtm/my config/companyID/propertyID/servertype
.myconfig
companyID
propertyID
servertype
Associating a Dynamic Tag Management Configuration With Your Site
Associate your Dynamic Tag Management configuration with the pages of your web site so that AEM adds the required script to the pages. Associate the root page of your site with the configuration. All descendants of that page inherit the association. If required, you can override the association on a descendant page.
Use the following procedure to associate a page and the descendants with a Dynamic Tag Management configuration.
-
Open the root page of your site in the classic UI.
-
Use Sidekick to open the page properties.
-
On the Cloud Services tab, click Add Service, select Dynamic Tag Management, and then click OK.
-
Use the Dynamic Tag Management drop-down menu to select your configuration, and then click OK.
Use the following procedure to override the inherited configuration association for a page. The override affects the page and all of the page descendants.
-
Open the page in the classic UI.
-
Use Sidekick to open the page properties.
-
On the Cloud Services tab, click the padlock icon next to the Inherited From property, then click Yes in the confirmation dialog box.
-
Remove or select a different Dynamic Tag Management configuration, and then click OK.
Experience Manager
- Administering User Guide overview
- Sites Features
- Website Administration
- Reusing Content: Multi Site Manager and Live Copy
- Live Copy Overview Console
- Configuring Live Copy Synchronization
- Creating and Synchronizing Live Copies
- MSM Rollout Conflicts
- MSM Best Practices
- Translating Content for Multilingual Sites
- Managing Translation Projects
- Identifying Content to Translate
- Preparing Content for Translation
- Creating a Language Root Using the Classic UI
- Connecting to Microsoft Translator
- Configuring the Translation Integration Framework
- Language Copy Wizard
- Translation Enhancements
- Translation Best Practices
- Configurations and the Configuration Browser
- AEM FAQs
- Operations
- Dashboards
- Operations Dashboard
- Backup and Restore
- Data Store Garbage Collection
- Monitoring Server Resources Using the JMX Console
- Working with Logs
- Configure the Rich Text Editor
- Configure the Video component
- The Bulk Editor
- Configuring Email Notification
- Configuring RTE for Producing Accessible Sites
- The Link Checker
- Troubleshooting AEM
- Audit Log Maintenance in AEM 6
- Editor
- Managing Access to Workflows
- Using cURL with AEM
- Configuring Undo for Page Editing
- Proxy Server Tool (proxy.jar)
- Configuring for AEM Apps
- Administering Workflows
- Configuring Search Forms
- Tools Consoles
- Reporting
- Administering Workflow Instances
- Configuring Layout Container and Layout Mode
- Enabling Access to Classic UI
- Starting Workflows
- Configure the Rich Text Editor plug-ins
- Admin Consoles
- Security
- User Administration and Security
- User, Group and Access Rights Administration
- Security Checklist
- OWASP Top 10
- Running AEM in Production Ready Mode
- Identity Management
- Adobe IMS Authentication and Admin Console Support for AEM Managed Services
- Creating a Closed User Group
- Mitigating serialization issues in AEM
- User Synchronization
- Encapsulated Token Support
- Single Sign On
- How to Audit User Management Operations in AEM
- SSL By Default
- SAML 2.0 Authentication Handler
- Closed User Groups in AEM
- Granite Operations - User and Group Administration
- Enabling CRXDE Lite in AEM
- Configuring LDAP with AEM 6
- Configure the Admin Password on Installation
- Service Users in AEM
- Encryption Support for Configuration Properties
- Handling GDPR Requests for the AEM Foundation
- Content Disposition Filter
- Personalization
- eCommerce
- Integration
- Integrating with Third-Party Services
- Integrating with Salesforce
- Integrating with Adobe Target
- Integrating with Adobe Analytics
- Connecting to Adobe Analytics and Creating Frameworks
- Configuring Link Tracking for Adobe Analytics
- Mapping Component Data with Adobe Analytics Properties
- Configuring Video Tracking for Adobe Analytics
- HTTP2 Delivery of Content FAQ
- Troubleshooting your Adobe Campaign Integration
- SharePoint Connector Licenses, Copyright Notices, and Disclaimers
- SharePoint Connector
- DHTML Viewer End-of-Life FAQs
- Integrating with Adobe Campaign Classic
- Related Community Articles
- Integrating with Adobe Campaign Standard
- Flash Viewers End-of-Life Notice
- Integrating with Adobe Creative Cloud
- Integrating with Adobe Dynamic Tag Management
- Opting Into Adobe Analytics and Adobe Target
- AEM Portals and Portlets
- Integrating with Dynamic Media Classic
- Troubleshooting Integration Issues
- Integrating with BrightEdge Content Optimizer
- Best Practices for Email Templates
- Catalog Producer
- Integrating with Silverpop Engage
- Integrating with Adobe Campaign
- Integrating with ExactTarget
- Analytics with External Providers
- Integrating with the Adobe Marketing Cloud
- Manually Configuring the Integration with Adobe Target
- Prerequisites for Integrating with Adobe Target
- Adobe Classifications
- Solutions Integration
- Target Integration with Experience Fragments
- Best Practices
- Content Management