与Adobe动态标签管理集成

Adobe动态标签管理与AEM集成,以便您能够使用动态标签管理Web属性跟踪AEM站点。 动态标签管理使营销人员能够管理用于收集数据的标签,并在数字营销系统中分发数据。 例如,使用动态标签管理收集AEM网站的使用数据并分发数据以在Adobe Analytics或Adobe Target分析。

在集成之前,您需要创建跟踪AEM站点域的动态标签管理web属性。 必须配置web属性的托管选项,以便配置AEM以访问动态标签管理库。

配置集成后,对动态标签管理部署工具和规则的更改无需在AEM中更改动态标签管理配置。 AEM可以自动使用这些更改。

注意

如果您使用具有自定义代理配置的DTM,则需要同时配置HTTP客户端代理配置,因为AEM的某些功能使用3.x API,而另一些则使用4.x API:

部署选项

以下部署选项影响与动态标签管理集成的配置。

动态标签管理托管

AEM支持托管在云中或托管在AEM上的动态标签管理。

  • 云托管:动态标签管理javascript库存储在云中,AEM页面直接引用它们。
  • AEM托管:动态标签管理生成javascript库。 AEM使用工作流模型来获取和安装库。

实施所使用的托管类型决定了您执行的一些配置和实施任务。 有关托管选项的信息,请参阅动态标签管理帮助中的托管——嵌入选项卡

暂存和生产库

确定AEM作者实例是使用动态标签管理暂存还是生产代码。

通常,您的创作实例使用动态标签管理暂存库,而生产实例使用生产库。 此方案允许您使用作者实例测试未批准的动态标签管理配置。

如果需要,您的创作实例可以使用生产库。 Web浏览器插件可用,使您能够在云托管库时,在使用临时库进行测试之间切换。

使用动态标签管理部署挂接

AEM托管动态标签管理库时,您可以使用动态标签管理部署挂接服务将库更新自动推送到AEM。 当对库进行更改(如编辑动态标签管理Web属性时)时,将推送库更新。

要使用部署挂接,动态标签管理必须能够连接到承载库的AEM实例。 必须启用对动态标签管理服务器的AEM访问。

在某些情况下,AEM可以是不可到达的,例如,当AEM位于防火墙后时。 在这些情况下,您可以使用AEM轮询导入程序选项定期检索库。 cron作业表达式指示库下载的计划。

启用部署挂接服务的访问

启用动态标签管理部署挂接服务以访问AEM,以便该服务可以更新AEM托管的库。 根据需要指定更新暂存库和生产库的动态标签管理服务器的IP地址:

  • 暂存: 107.21.99.31
  • 生产:23.23.225.112204.236.240.48

使用Web控制台sling:OsgiConfig节点执行配置:

  • 在Web控制台中,使用“配置”页上的AdobeDTM部署挂接配置项。
  • 对于OSGi配置,服务PID为com.adobe.cq.dtm.impl.servlets.DTMDeployHookServlet

下表说明了要配置的属性。

Web控制台属性 OSGi属性 描述
暂存DTM IP白名单 dtm.staging.ip.whitelist 用于更新暂存库的动态标签管理服务器的IP地址。
生产DTM IP白名单 dtm.production.ip.whitelist 用于更新生产库的动态标签管理服务器的IP地址。

创建动态标签管理配置

创建云配置,以便AEM实例可以使用动态标签管理进行身份验证并与您的Web属性交互。

注意

当您的DTM Web属性包括Adobe Analytics工具并且您也在使用内容分析时,请避免在您的页面上包含两个Adobe Analytics跟踪代码。 在Adobe Analytics云配置中,选择“不包括跟踪代码”选项。

常规设置

属性 描述
API令牌 动态标签管理用户帐户的API令牌属性值。 AEM使用此属性通过动态标签管理进行身份验证。
公司 与您的登录ID关联的公司。
属性 您为管理AEM站点的标记而创建的Web属性的名称。
包含有关作者的生产代码

选择此选项可使AEM作者实例和发布实例使用动态标签管理库的生产版本。

如果未选择此选项,暂存设置将应用于作者实例,生产设置将应用于发布实例。

自托管属性——暂存和生产

动态标签管理配置的以下属性使AEM能够托管动态标签管理库。 属性使AEM能够下载并安装库。 或者,您可以自动更新库,确保它们反映在动态标签管理应用程序中所做的任何更改。

某些属性使用您从“嵌入”选项卡的“库下载”部分获得的值作为Dynamic Tag Management Web属性。 有关信息,请参阅动态标签管理帮助中的库下载

注意

在AEM上承载动态标签管理捆绑包时,必须先在动态标签管理中启用库下载,然后才能创建配置。 此外,必须启用Akamai,因为Akamai提供供下载的库。

在AEM上托管动态标签管理库时,AEM会根据您的配置自动配置web属性的某些属性。 请参阅下表中的说明。

属性 描述
使用自托管 选择何时在AEM上托管动态标签管理库文件。 选择此选项将显示此表中的其他属性。
DTM 包 URL 用于下载动态标签管理库的URL。 从动态标签管理的库下载页面的下载URL部分获取此值。 出于安全原因,必须手动配置此值。
下载工作流

用于下载和安装动态标签管理库的工作流模型。 默认模型为“Default DTM Bundle Download(默认DTM捆绑下载)”。 除非已创建自定义模型,否则使用此模型。

请注意,默认下载工作流会在下载库时自动激活它们。

域提示

(可选)托管动态标签管理库的AEM服务器的域。 指定一个值以覆盖为Day CQ Link Externalizer服务配置的默认域。

连接到动态标签管理时,AEM使用此值为动态标签管理Web属性配置库下载属性的临时HTTP路径或生产HTTP路径。

安全域提示

(可选)通过HTTPS承载动态标签管理库的AEM服务器的域。 指定一个值以覆盖为Day CQ Link Externalizer服务配置的默认域。

连接到动态标签管理时,AEM使用此值为动态标签管理Web属性配置库下载属性的临时HTTPS路径或生产HTTPS路径。

共享密钥

(可选)用于解密下载的共享机密。 从动态标签管理的“库下载”页的“共享机密”字段获取此值。

注意: 必须在安装 AEM的计算机上安装OpenSSL库,以便AEM能够解密下载的库。

启用轮询导入程序

(可选)选择定期下载和安装动态标签管理库,以确保您使用的是更新版本。 选中后,动态标签管理不会向部署挂接URL发送HTTPPOST请求。

AEM自动为动态标签管理Web属性配置“库下载”属性的“部署挂接URL”属性。 选中后,该属性将配置为无值。 如果未选择,则属性将配置为动态标签管理配置的URL。

当动态标签管理部署挂接无法连接到AEM时启用轮询导入程序,例如,当AEM位于防火墙后时。

时间表表达式 (在选择“启用轮询导入程序”时显示并且为必填项。) 控制下载动态标签管理库的时间的cron表达式。

chlimage_1-352

云托管属性——暂存和生产

在云托管动态标签配置时,您可以为动态标签管理配置配置配置以下属性。

属性 描述
使用自托管 在云中托管动态标签管理库文件时,请清除此选项。
页眉代码

从主机的动态标签管理中获取的用于暂存的标题代码。 当您连接到动态标签管理时,会自动填充此值。

要在动态标签管理中查看代码,请单击嵌入选项卡,然后单击主机名。 展开“标题代码”部分,然后根据需要单击临时嵌入代码或生产嵌入代码区域的复制嵌入代码。

页脚代码

从主机的动态标签管理中获取的用于暂存的页脚代码。 当您连接到动态标签管理时,会自动填充此值。

要在动态标签管理中查看代码,请单击嵌入选项卡,然后单击主机名。 展开“页脚代码”部分,然后根据需要单击“暂存嵌入代码”或“生产嵌入代码”区域的“复制嵌入代码”。

chlimage_1-353

以下过程使用触屏优化UI配置与动态标签管理的集成。

  1. 在边栏上,单击工具>操作>云>Cloud Services。

  2. 在“动态标签管理”区域中,将显示以下用于添加配置的链接之一:

    • 如果这是您添加的第一个配置,请单击“立即配置”。
    • 如果已创建一个或多个配置,请单击“显示配置”,然后单击“可用配置”旁的+链接。

    chlimage_1-354

  3. 键入配置标题,然后单击创建。

  4. 在API令牌字段中,输入动态标签管理用户帐户的API令牌属性值。

    要获取API令牌的值,请与DTM客户关怀部门联系。

    注意

    API令牌直到动态标签管理用户明确请求它才会过期。

    chlimage_1-355

  5. 单击“连接到DTM”。 AEM使用动态标签管理进行身份验证并检索您的帐户关联的公司的列表。

  6. 选择公司,然后选择您用于跟踪AEM站点的属性。

  7. 如果您正在创作实例上使用暂存代码,请取消选择“在创作时包括生产代码”。

  8. 根据需要,在“暂存设置”选项卡和“生产设置”选项卡上提供属性值,然后单击“确定”。

手动下载动态标签管理库

手动下载动态标签管理库以立即在AEM上更新它们。 例如,当您希望在轮询导入程序计划自动下载库之前测试更新的库时,请手动下载。

  1. 在边栏上,单击工具>操作>云>Cloud Services。

  2. 在“动态标签管理”区域,单击“显示配置”,然后单击您的配置。

  3. 在“暂存设置”区域或“生产设置”区域,单击“触发器下载工作流”按钮以下载和部署库包。

    chlimage_1-356

注意

下载的文件存储在/etc/clientlibs/dtm/my config/companyID/propertyID/servertype下。

以下是直接从DTM配置中获取的。

  • myconfig
  • companyID
  • propertyID
  • servertype

将动态标签管理配置与站点关联

将您的动态标签管理配置与网站的页面相关联,以便AEM将所需的脚本添加到页面。 将站点的根页面与配置关联。 该页面的所有子代都继承关联。 如果需要,您可以覆盖子体页面上的关联。

请按照以下过程将页面和子体与动态标签管理配置相关联。

  1. 在经典UI中打开站点的根页面。

  2. 使用Sidekick打开页面属性。

  3. 在“Cloud Services”选项卡上,单击“添加服务”,选择“动态标签管理”,然后单击“确定”。

    chlimage_1-357

  4. 使用动态标签管理下拉菜单选择您的配置,然后单击确定。

请按照以下过程覆盖页面的继承配置关联。 覆盖会影响页面和所有页面后代。

  1. 在经典UI中打开页面。

  2. 使用Sidekick打开页面属性。

  3. 在“Cloud Services”选项卡上,单击“继承自”属性旁边的挂锁图标,然后在确认对话框中单击“是”。

    chlimage_1-358

  4. 删除或选择其他动态标签管理配置,然后单击确定。

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now