Integrating with Adobe Dynamic Tag Management integrating-with-adobe-dynamic-tag-management
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 deployment-options
The following deployment options affect the configuration of the integration with Dynamic Tag Management.
Dynamic Tag Management Hosting 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 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 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 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.
dtm.staging.ip.whitelist
dtm.production.ip.whitelist
Creating the Dynamic Tag Management Configuration 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 general-settings
Self Hosting Properties - Staging and Production 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.
Cloud Hosting Properties - Staging and Production cloud-hosting-properties-staging-and-production
You configure the following properties for your Dynamic Tag Management configuration when Dynamic Tag Configuration is cloud-hosted.
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 note 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-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 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.