与AdobeDynamic Tag Management集成 integrating-with-adobe-dynamic-tag-management
将AdobeDynamic Tag Management与AEM集成,以便您可以使用Dynamic Tag Management Web属性跟踪AEM站点。 Dynamic Tag Management允许营销人员管理用于收集数据的标记,并在各种数字营销系统中分发数据。 例如,使用Dynamic Tag Management收集AEM网站的使用情况数据,并分发数据以在Adobe Analytics或Adobe Target中进行分析。
在集成之前,请创建跟踪AEM站点域的Dynamic Tag Management Web属性。 必须配置Web属性的托管选项,以便您可以配置AEM以访问Dynamic Tag Management库。
配置集成后,对Dynamic Tag Management部署工具和规则的更改不需要在AEM中更改Dynamic Tag Management配置。 这些更改可自动供AEM使用。
部署选项 deployment-options
以下部署选项会影响与Dynamic Tag Management集成的配置。
Dynamic Tag Management托管 dynamic-tag-management-hosting
AEM支持在云中托管或在AEM上托管的动态Tag Management。
- 云托管: Dynamic Tag Management JavaScript库存储在云中,您的AEM页面直接引用它们。
- AEM托管: Dynamic Tag Management生成JavaScript库。 AEM使用工作流模型来获取和安装库。
您的实施使用的托管类型决定了您执行的某些配置和实施任务。 有关托管选项的信息,请参阅“动态Tag Management帮助”中的托管 — 嵌入选项卡。
暂存和生产库 staging-and-production-library
确定您的AEM创作实例使用的是Dynamic Tag Management暂存代码还是生产代码。
通常,您的创作实例使用动态Tag Management暂存库,而生产实例使用生产库。 此方案允许您使用创作实例测试未批准的动态Tag Management配置。
如果需要,您的创作实例可以使用生产库。 通过Web浏览器插件,您能够在使用暂存库之间进行切换,以便当库是云托管库时,进行测试。
使用Dynamic Tag Management部署挂钩 using-the-dynamic-tag-management-deployment-hook
当AEM托管Dynamic Tag Management库时,您可以使用Dynamic Tag Management部署挂接服务自动将库更新推送到AEM。 在对库进行更改时(例如,在编辑Dynamic Tag Management Web属性时),将推送库更新。
要使用部署挂接,Dynamic Tag Management必须能够连接到托管库的AEM实例。 启用Dynamic Tag Management服务器对AEM的访问权限。
在某些情况下,可能无法访问AEM,例如当AEM位于防火墙后面时。 在这些情况下,您可以使用AEM轮询导入程序选项定期检索库。 cron作业表达式规定了库下载计划。
启用部署挂接服务的访问 enabling-access-for-the-deployment-hook-service
启用Dynamic Tag Management部署挂接服务以访问AEM,以便该服务可以更新AEM托管的库。 指定根据需要更新暂存和生产库的Dynamic Tag Management服务器的IP地址:
- 暂存:
107.21.99.31
- 生产:
23.23.225.112
和204.236.240.48
使用Web控制台或sling:OsgiConfig
节点执行配置:
- 在Web控制台中,使用“配置”页面上的“AdobeDTM部署挂接配置”项。
- 对于OSGi配置,服务PID为
com.adobe.cq.dtm.impl.servlets.DTMDeployHookServlet
。
下表描述了要配置的属性。
dtm.staging.ip.whitelist
dtm.production.ip.whitelist
创建动态Tag Management配置 creating-the-dynamic-tag-management-configuration
创建云配置,以便AEM实例可以使用Dynamic Tag Management进行身份验证并与您的Web资产交互。
常规设置 general-settings
自托管属性 — 暂存和生产 self-hosting-properties-staging-and-production
通过Dynamic Tag Management配置的以下属性,AEM可以托管Dynamic Tag Management库。 利用这些属性,AEM可以下载并安装库。 或者,您也可以自动更新库,以确保它们反映在Dynamic Tag Management管理应用程序中所做的任何更改。
某些资产会使用从Dynamic Tag Management Web资产的“嵌入”选项卡的“库下载”部分中获取的值。 有关信息,请参阅Dynamic Tag Management帮助中的库下载。
在AEM上托管Dynamic Tag Management库时,AEM会根据您的配置自动配置Web资产的某些属性。 请参阅下表中的说明。
云托管属性 — 暂存和生产 cloud-hosting-properties-staging-and-production
在云托管动态标签配置时,您可以为Dynamic Tag Management配置配置以下属性。
以下过程使用触屏优化UI来配置与Dynamic Tag Management的集成。
-
在边栏中,单击“工具” > “操作” > “云” > “Cloud Service” 。
-
在Dynamic Tag Management区域中,将显示以下用于添加配置的链接之一:
- 如果这是您添加的第一个配置,请单击立即配置。
- 单击显示配置,如果已创建一个或多个配置,则单击可用配置旁边的+链接。
-
键入配置的标题,然后单击“创建”。
-
在API令牌字段中,输入Dynamic Tag Management用户帐户的API令牌属性的值。
要获取API令牌的值,请联系DTM客户关怀团队。
note note NOTE 在Dynamic Tag Management用户明确请求过期的API令牌之前,该API令牌不会过期。 -
单击连接到DTM。 AEM通过Dynamic Tag Management进行身份验证,并检索与您的帐户关联的公司列表。
-
选择公司,然后选择用于跟踪AEM网站的资产。
-
如果您在创作实例上使用暂存代码,请取消选择在创作实例上包含生产代码。
-
根据需要在“暂存设置”选项卡和“生产设置”选项卡上提供属性的值,然后单击“确定”。
手动下载Dynamic Tag Management库 manually-downloading-the-dynamic-tag-management-library
手动下载Dynamic Tag Management库以立即在AEM上更新它们。 例如,如果您想要在轮询导入程序计划自动下载库之前测试更新的库,请手动下载。
-
在边栏中,单击“工具” > “操作” > “云” > “Cloud Service” 。
-
在Dynamic Tag Management区域中,单击显示配置,然后单击您的配置。
-
在暂存设置区域或生产设置区域中,单击触发下载工作流按钮以下载和部署库捆绑包。
/etc/clientlibs/dtm/my config/companyID/propertyID/servertype
下。myconfig
companyID
propertyID
servertype
将动态Tag Management配置与您的站点关联 associating-a-dynamic-tag-management-configuration-with-your-site
将您的动态Tag Management配置与网站页面关联,以便AEM将所需的脚本添加到页面。 将站点的根页面与配置关联。 该页面的所有后代都将继承关联。 如有必要,您可以在子页面中覆盖关联。
使用以下过程可将页面及其后代与Dynamic Tag Management配置相关联。
-
在经典UI中打开站点的根页面。
-
使用Sidekick打开页面属性。
-
在“Cloud Service”选项卡中,单击添加服务,选择动态Tag Management ,然后单击确定。
-
使用Dynamic Tag Management下拉菜单选择您的配置,然后单击“确定”。
使用以下过程可覆盖页面的继承配置关联。 覆盖将影响页面和所有页面子项。
-
在经典UI中打开页面。
-
使用Sidekick打开页面属性。
-
在“Cloud Service”选项卡上,单击“继承自”属性旁边的挂锁图标,然后在确认对话框中单击“是”。
-
删除或选择其他Dynamic Tag Management配置,然后单击“确定”。