将Dynamic Media查看器与Adobe Analytics和Experience Platform标记集成 integrating-dynamic-media-viewers-with-adobe-analytics-and-adobe-launch
Dynamic Media Viewer与Adobe Analytics和Experience Platform标记有何集成? what-is-dynamic-media-viewers-integration-with-adobe-analytics-and-adobe-launch
Dynamic Media查看器 通过Experience Platform Tags和Dynamic Media Viewers 5.13的扩展,Adobe Analytics和Experience Platform Tags客户可在其Experience PlatformTags配置中使用特定于Dynamic Media Viewers的事件和数据。
此集成意味着您可以使用Adobe Analytics跟踪网站上Dynamic Media查看器的使用情况。 同时,您可以将查看器显示的事件和数据与来自Adobe或第三方的任何其他Experience Platform标签扩展结合使用。
要了解有关Adobe扩展或第三方扩展的更多信息,请参阅 Adobe扩展 《Experience Platform标签用户指南》中的。
本主题适用于以下内容: Adobe Experience Manager项目的站点管理员、开发人员和运营人员。
集成的限制 limitations-of-the-integration
- Dynamic Media查看器的Experience Platform标记集成在Experience Manager创作节点中不起作用。 在发布WCM页面之前,您不会看到该页面中的任何跟踪。
- Dynamic Media查看器的Experience Platform标记集成不支持“弹出式”操作模式,在该模式下,使用“资源详细信息”页面上的“URL”按钮可获取查看器URL。
- Experience Platform标记集成不能与旧版查看器Analytics集成同时使用(通过
config2=
参数)。 - 对视频跟踪的支持仅限于核心播放跟踪,如中所述 跟踪概述. 特别是,不支持QoS、广告、章节/区段或错误跟踪。
- 使用的数据元素不支持数据元素的存储持续时间配置 Dynamic Media查看器 扩展。 存储持续时间必须设置为 无.
集成的用例 use-cases-for-the-integration
与Experience Platform标记集成的主要用例是同时使用Experience Manager Assets和Experience Manager Sites的客户。 在此类场景中,您可以设置Experience Manager创作节点和Experience Platform标记之间的标准集成,然后将您的Sites实例与Experience Platform标记属性关联。 之后,添加到Sites页面的任何Dynamic Media WCM组件都将跟踪来自查看器的数据和事件。
请参阅 在Experience Manager Sites中跟踪Dynamic Media查看器.
集成支持的辅助用例是那些仅使用Experience Manager Assets或Dynamic Media Classic的客户。 在这种情况下,您将获取查看者的嵌入代码并将其添加到网站页面。 然后,从Experience Platform标签中获取Experience Platform标签库的生产URL,并将其手动添加到网页代码中。
数据和事件跟踪在集成中的工作原理 how-data-and-event-tracking-works-in-the-integration
该集成利用了两种独立类型的Dynamic Media Viewers跟踪: Adobe Analytics 和 适用于音频和视频的Adobe Analytics.
关于使用Adobe Analytics进行跟踪 about-tracking-using-adobe-analytics
通过Adobe Analytics,您可以跟踪用户在网站上与Dynamic Media查看器交互时执行的操作。 Adobe Analytics还允许您跟踪特定于查看器的数据。 例如,您可以跟踪和记录视图加载事件以及资产名称、发生的任何缩放操作和视频播放操作。
在Experience Platform标签中, 数据元素 和 规则 共同启用Adobe Analytics跟踪。
关于Experience Platform标签中的数据元素 about-data-elements-in-adobe-launch
Experience Platform标记中的数据元素是一个命名属性,其值是静态定义的,或根据网页或Dynamic Media查看器数据的状态进行动态计算。
数据元素定义中可用的选项取决于Experience Platform标记属性中安装的扩展列表。 “核心”扩展已预安装,在任何配置中均可开箱即用。 此“核心”扩展允许定义数据元素,其值来自Cookie、JavaScript代码、查询字符串和许多其他源。
对于Adobe Analytics跟踪,必须安装多个其他扩展,如中所述 扩展的安装和设置. Dynamic Media Viewers扩展添加了定义数据元素的功能,该数据元素的值是动态查看器事件的参数。 例如,可以引用查看器类型或加载时查看器报告的资产名称、最终用户缩放时报告的缩放级别等。
Dynamic Media Viewer扩展会自动使其数据元素的值保持最新。
定义数据元素后,可以使用数据元素选取器小组件,将数据元素用于Experience Platform标记UI的其他位置。 特别是,为Dynamic Media查看器跟踪而定义的数据元素由规则中Adobe Analytics扩展的“设置变量”操作引用(请参阅下文)。
请参阅 数据元素 《Experience Platform标签用户指南》中的。
关于Experience Platform标签中的规则 about-rules-in-adobe-launch
Experience Platform标记中的规则是一种不可知配置,它定义了构成规则的三个区域: 活动, 条件、和 操作:
- 活动 (if)告知Experience Platform标签何时触发“规则”。
- 条件 (如果)在触发Experience Platform时,告知规则标记还应允许或禁止哪些其他限制。
- 操作 (然后)告诉规则标记Experience Platform触发规则时要执行的操作。
“事件”、“条件”和“操作”部分中可用的选项取决于Experience PlatformTags属性中安装的扩展。 此 核心 扩展已预安装,并且在任何配置中均可现成使用。 扩展为事件提供了多个选项,例如基本的浏览器级操作,其中包括焦点更改、按键和表单提交。 它还包含适用于条件的选项,例如Cookie值、浏览器类型等。 对于“操作”,只有“自定义代码”选项可用。
对于Adobe Analytics跟踪,必须安装其他多个扩展,如中所述 扩展的安装和设置. 具体来说:
- Dynamic Media Viewers扩展可将受支持的事件列表扩展到特定于Dynamic Media查看器的事件,例如查看器加载、资源交换、放大和视频播放。
- Adobe Analytics扩展扩展了支持的操作列表,添加了向跟踪服务器发送数据所需的两个操作: 设置变量 和 发送信标.
要跟踪Dynamic Media查看器,可以使用以下任何类型:
- Dynamic Media Viewers扩展、核心扩展或任何其他扩展中的事件。
- 规则定义中的条件。 或者,您可以将conditions区域留空。
在操作部分,您需要拥有 设置变量 操作。 此操作可告知Adobe Analytics如何使用数据填充跟踪变量。 同时, 设置变量 操作不会将任何内容发送到跟踪服务器。
此 设置变量 操作后必须跟有 发送信标 操作。 此 发送信标 操作会实际将数据发送到analytics跟踪服务器。 这两个操作, 设置变量 和 发送信标,来自Adobe Analytics扩展。
请参阅 规则 《Experience Platform标签用户指南》中的。
示例配置 sample-configuration
Experience Platform标记中的以下示例配置演示了如何在加载查看器时跟踪资源名称。
-
从 数据元素 选项卡,定义数据元素
AssetName
该引用项asset
的参数LOAD
Dynamic Media Viewers扩展中的事件。 -
从 规则 选项卡,定义规则 TrackAssetOnLoad.
在此规则中, 事件 字段使用 加载 Dynamic Media Viewers扩展中的事件。
-
操作配置具有Adobe Analytics扩展中的两种操作类型:
设置变量,将您选择的analytics变量映射到的
AssetName
数据元素。发送信标,会将跟踪信息发送到Adobe Analytics。
-
生成的规则配置如下所示:
关于适用于音频和视频的Adobe Analytics about-adobe-analytics-for-audio-and-video
当Experience Cloud帐户订阅使用Adobe Analytics for Audio and Video时,就足以在中启用视频跟踪 Dynamic Media查看器 扩展设置。 视频量度在Adobe Analytics中可用。 视频跟踪取决于Adobe Medium Analytics for Audio and Video扩展的存在。
请参阅 扩展的安装和设置.
目前,对视频跟踪的支持仅限于“核心播放”跟踪,如中所述 跟踪概述. 特别是,不支持QoS、广告、章节/区段或错误跟踪。
使用Dynamic Media查看器扩展 using-the-dynamic-media-viewers-extension
如中所述 集成的用例,即可通过Experience Manager Sites中新的Experience Platform标签集成以及使用嵌入代码来跟踪Dynamic Media查看器。
在Experience Manager Sites中跟踪Dynamic Media查看器 tracking-dynamic-media-viewers-in-aem-sites
要在Experience Manager Sites中跟踪Dynamic Media查看器,请在 配置所有集成片段 部分必须执行。 具体而言,您必须创建IMS配置和Experience PlatformTags Cloud配置。
在正确配置后,您使用Dynamic Media支持的WCM组件添加到站点页面的任何Dynamic Media查看器都会自动跟踪到Adobe Analytics或Adobe Analytics for Video的数据,或同时跟踪这两者。
请参阅 使用Adobe站点将Dynamic Media资产添加到页面.
使用嵌入代码跟踪Dynamic Media查看器 tracking-dynamic-media-viewers-using-embed-code
对于未使用Experience Manager Sites或将Dynamic Media查看器嵌入到Experience Manager Sites外部的网页中(或同时使用两者)的客户,仍可以使用“Experience Platform标记”集成。
从完成配置步骤 配置Adobe Analytics 和 配置Experience Platform标签 部分。 但是,不需要执行与Experience Manager相关的配置步骤。
在正确配置后,您可以使用Dynamic Media查看器将支持Experience Platform标签添加到网页。
请参阅 添加Experience Platform标记嵌入代码 详细了解如何使用Experience Platform标签库嵌入代码。
要详细了解如何使用Experience ManagerDynamic Media的嵌入代码功能,请参阅 在网页上嵌入视频查看器或图像查看器.
使用嵌入代码跟踪Dynamic Media查看器:
- 设置一个网页以便嵌入Dynamic Media查看器。
- 通过首次登录Experience Platform Tags获取Experience Platform Tags库的嵌入代码(请参阅 配置Experience Platform标签)。
- 选择 属性,然后选择 环境 选项卡。
- 选取与网页环境相关的环境级别。 然后,在 安装 列中,选中框图标。
- 在Web安装说明中 对话框中,复制完整的Experience PlatformTags库嵌入代码以及周围的
<script/>
标记之间。
Dynamic Media Viewers扩展参考指南 reference-guide-for-the-dynamic-media-viewers-extension
关于Dynamic Media查看器配置 about-the-dynamic-media-viewers-configuration
如果满足以下条件,则Dynamic Media Viewer扩展会自动与Experience Platform标记库集成:
-
Experience Platform标签库全局对象(
_satellite
)在页面上。 -
Dynamic Media查看器扩展函数
_dmviewers_v001()
定义于_satellite
. -
config2=
未指定查看器参数,这意味着查看器不使用旧版Analytics集成。
此外,还有一个选项,可通过指定来明确禁用查看器中的Experience Platform标记集成 launch=0
查看器的配置中的参数。 此参数的默认值为 1
.
配置Dynamic Media查看器扩展 configuring-the-dynamic-media-viewers-extension
Dynamic Media查看器扩展的唯一配置选项是 为音频和视频启用Adobe Medium分析.
如果选中(启用)此选项,并且已安装和配置Adobe Medium Analytics for Audio and Video扩展,则会将视频播放量度发送到Adobe Analytics for Audio and Video解决方案。 禁用此选项将关闭视频跟踪。
如果启用此选项 不含 如果安装了Adobe Medium Analytics for Audio and Video扩展,则选项无效。
关于Dynamic Media查看器扩展中的数据元素 about-data-elements-in-the-dynamic-media-viewers-extension
Dynamic Media Viewers 扩展提供的唯一数据元素类型是 数据元素类型 下拉列表中的 查看器事件。
选中后,数据元素编辑器将呈现一个包含两个字段的表单:
- DM 查看器事件数据类型 - 一个下拉列表,标识了 Dynamic Media 查看器扩展支持的所有查看器事件(具有参数)以及特殊的 COMMON 项目。COMMON 项目表示事件参数列表,这些事件参数对查看器发送的所有类型事件都是通用的。
- 跟踪参数 — 选定Dynamic Media查看器事件的参数。
请参阅 Dynamic Media查看器参考指南 有关每种查看器类型支持的事件列表;请转到特定查看器部分,然后选择支持Adobe Analytics跟踪子部分。 目前,《Dynamic Media查看器参考指南》未记录事件参数。
现在让我们考虑Dynamic Media查看器的生命周期 数据元素. 当页面上发生相应的Dynamic Media查看器事件后,将填充此类数据元素的值。 例如,假设数据元素指向 加载 事件及其“asset”参数。 此数据元素的值在查看器首次运行LOAD事件后会收到有效数据。 如果数据元素指向 缩放 event及其“scale”参数中,此类“数据元素”的值将保持为空,直到查看器发送 缩放 事件了。
同样,当查看器在页面上发送相应事件时,数据元素的值也会自动更新。即使在规则配置中未指定特定事件,也会发生值更新。例如,假设数据元素 缩放比例 为ZOOM事件的“缩放”参数定义。 但是,规则配置中唯一存在的规则是由触发的 加载 事件。 的值 缩放比例 每次用户在查看器中运行缩放时仍会更新。
任何Dynamic media查看器在网页上都有唯一标识符。 数据元素会跟踪值本身,以及填充该值的查看器。 例如,假设同一页面上有多个查看器,并且 资产名称 指向 加载 事件及其“asset”参数。 此 资产名称 数据元素会维护与页面上加载的每个查看器关联的资产名称集合。
数据元素返回的确切值取决于上下文。 如果在由Dynamic Media查看器事件触发的规则中请求数据元素,则会为启动该规则的查看器返回数据元素值。 此外,数据元素是在某个规则中请求的,该规则由某个其他Experience Platform标记扩展中的事件触发。 此时,数据元素的值来自上次更新此数据元素的查看器。
请考虑以下示例设置:
-
具有两个Dynamic Media缩放查看器的网页: 查看器1 和 查看器2.
-
缩放比例 数据元素指向 缩放 事件及其“规模”参数。
-
Trackpan 具有以下特征的规则:
- 使用Dynamic Media查看器 平移 事件作为触发器。
- 发送值 缩放比例 数据元素到Adobe Analytics。
-
TrackKey 具有以下特征的规则:
- 使用核心Experience Platform标记扩展中的按键事件作为触发器。
- 发送值 缩放比例 数据元素到Adobe Analytics。
现在,假定用户加载网页时带有两个查看器。 在 查看器1,则将缩放比例放大到50%;然后,放大 查看器2,则将缩放比例放大到25%。 在 查看器1,然后平移图像,最后按键盘上的键。
用户的活动会导致对Adobe Analytics进行以下两次跟踪调用:
- 第一次调用是因为 Trackpan 规则在用户登录时触发 查看器1. 该调用发送50%作为的值 缩放比例 数据元素,因为数据元素知道规则触发自 查看器1 并提取相应的比例值;
- 第二次调用是因为 TrackKey 用户按键盘上的键时会触发规则。 该调用发送25%作为值 缩放比例 数据元素,因为规则不是由查看器触发。 因此,数据元素会返回最新的值。
以上设置的示例也会影响数据元素值的生命周期。 即使将查看器本身放置在网页上,Dynamic Media查看器管理的数据元素的值也会存储在Experience Platform标记库代码中。 这项功能意味着如果存在由非Dynamic Media Viewer扩展触发的规则,并且引用此类数据元素,则数据元素将返回最后一个已知值。 即使查看者不再出现在网页上。
无论如何,Dynamic Media Viewers驱动的数据元素值不会存储在本地存储或服务器上;而是仅存储在客户端Experience Platform标签库中。 在网页重新加载时,此类数据元素的值消失。
通常,数据元素编辑器支持 存储持续时间选择. 但是,使用Dynamic Media查看器扩展的数据元素仅支持存储持续时间选项 无. 可以在用户界面中设置任何其他值,但在此情况下未定义数据元素行为。 扩展可自行管理数据元素的值:在整个查看器生命周期中维护查看器事件参数值的数据元素。
关于Dynamic Media查看器扩展中的规则 about-rules-in-the-dynamic-media-viewers-extension
在规则编辑器中,扩展会为事件编辑器添加新的配置选项。 此外,该编辑器提供了一个选项,让您可以在操作编辑器中手动引用事件参数作为短手选项,而不是使用预配置的数据元素。
关于事件编辑器 about-the-events-editor
在事件编辑器中,Dynamic Media Viewers扩展会添加 事件类型 已调用 查看器事件.
选中后,事件编辑器将呈现下拉列表 Dynamic Media Viewer事件,列出Dynamic Media查看器支持的所有可用事件。
关于操作编辑器 about-the-actions-editor
通过Dynamic Media Viewers扩展,您可以使用Dynamic Media Viewers的事件参数来映射到Adobe Analytics扩展的“设置变量”编辑器中的Analytics变量。
最简单的方法是完成以下两步流程:
- 首先,定义一个或多个数据元素,其中每个数据元素表示Dynamic Media Viewer事件的一个参数。
- 最后,在Adobe Analytics扩展的设置变量编辑器中,选择数据元素选取器图标(三个栈叠的磁盘)以打开选择数据元素对话框,然后从中选择数据元素。
但是,可以使用替代方法并绕过数据元素创建。您可以直接引用Dynamic Media Viewer事件中的参数。 在中输入事件参数的完全限定名称 值 Analytics变量分配的输入字段。 请务必使用百分号(%)括起来。 例如,
%event.detail.dm.LOAD.asset%
使用数据元素与使用直接事件参数引用之间有一个重要的区别。 对于数据元素,哪个事件触发Set Variables操作并不重要。 触发规则的事件可能与动态查看器无关(例如从核心扩展中选择网页)。 但是,在使用直接参数引用时,请务必确保触发规则的事件与它引用的事件参数相对应。
例如,如果规 %event.detail.dm.LOAD.asset%
则是由Dynamic Media Viewer扩展的 LOAD 事件触发的,则引用将返回正确的资产名称。 但是,对于任何其他事件,它都会返回一个空值。
下表列出了Dynamic Media Viewer事件及其支持的参数:
配置所有集成片段 configuring-all-the-integration-pieces
开始之前
Adobe建议您仔细阅读本节之前的所有文档,以便了解整个集成。
此部分介绍将Dynamic Media查看器与Adobe Analytics和Adobe Analytics for Audio and Video集成所需的配置步骤。 虽然可以将Dynamic Media查看器扩展用于Experience Platform标记中的其他目的,但本文档未介绍此类场景。
您即将使用以下Adobe产品来配置集成:
- Adobe Analytics — 用于配置跟踪变量和报表。
- Experience Platform标记 — 用于定义属性、一个或多个规则以及一个或多个数据元素,以启用查看器跟踪。
此外,如果此集成解决方案与Experience Manager Sites一起使用,则必须完成以下配置:
- Adobe Developer控制台 — 为Experience Platform标签创建集成。
- Experience Manager创作节点 — IMS配置和Experience Platform标记云配置。
在配置过程中,确保您有权访问Adobe Experience Cloud中启用了Adobe Analytics和Experience Platform标签的公司。
配置Adobe Analytics以进行集成 configuring-adobe-analytics-for-the-integration
配置Adobe Analytics后,将为该集成设置以下内容:
- 已放置并选择一个报表包。
- Analytics变量可用于接收跟踪数据。
- 报表可用于查看Adobe Analytics中收集的数据。
另请参阅 Analytics实施指南.
要配置Adobe Analytics以进行集成,请执行以下操作:
-
首先从Experience Cloud访问Adobe Analytics 主页. 在菜单栏上,选择页面右上角附近的解决方案图标(一个三乘三的圆点表),然后选择 分析.
现在,选择一个报表包。
选择报表包 selecting-a-report-suite
-
在 Adobe Analytics 页面的右上角附近,在 搜索报告 字段的右侧,从下拉列表中选择正确的报表包。如果有多个可用报表包,并且您不确定要使用哪个报表包,请与 Adobe Analytics 管理员联系,帮助您选择要使用的报表包。
在以下示例中,用户创建了一个名为的报表包 DynamicMediaViewersExtensionDoc 并从下拉列表中选择它。 报表包名称只是一个示例。 您最终选择的报表包的名称由您决定。
如果没有可用的报表包,您必须或您的Adobe Analytics管理员创建一个报表包,然后才能继续配置。
在Adobe Analytics中,报表包受管理 管理员 > 报表包.
现在设置Adobe Analytics变量。
设置Adobe Analytics变量 setting-up-adobe-analytics-variables
-
指定一个或多个要用于跟踪Dynamic Media查看者在网页上的行为的Adobe Analytics变量。
可以使用Adobe Analytics支持的任何类型的变量。 关于变量类型的决策(如自定义流量) [prop],转化 [eVar])由Analytics实施的特定需求驱动。
请参阅 prop和eVar概述.
在本文档中,仅使用自定义流量(props)变量,因为它们会在网页上发生操作后的几分钟内在Analytics报表中变得可用。
要启用新的自定义流量变量,请在Adobe Analytics的工具栏上,转到 管理员 > 报表包.
-
在 报表包管理器 页面上,选择正确的报表,然后在工具栏上,转到 编辑设置 > 流量 > 流量变量.
-
选择一个未使用的变量,为其指定一个描述性名称( 查看器资产(prop 30)),然后在“已启用”列中将该组合框更改为“已启用”。
以下屏幕截图是自定义流量变量( prop30),以跟踪查看器使用的资源名称:
-
在变量列表的底部,选择 保存.
设置报表 setting-up-a-report
-
通常,在Adobe Analytics中设置报表是由特定项目需求驱动的。 因此,详细报表设置超出了此集成的范围。
但是,您完全可以知道,在中设置自定义流量变量后,自定义流量报表将在Adobe Analytics中自动可用 设置Adobe Analytics变量.
例如,报告 查看器资产(prop 30) 变量可从“报表”菜单的 自定义流量 > 自定义流量21 - 30 > 查看器资产(prop 30).
在查看器资产(prop 30)创 建后直接访问此报告 ,不显示任何数据;在整合的这一阶段,人们就会期待它。
为集成配置Experience Platform标记 configuring-adobe-launch-for-the-integration
配置Experience Platform标记后,将为该集成设置以下内容:
- 创建一个新资产,将所有配置放在一起。
- 扩展的安装和设置。 资产中安装的所有扩展的客户端代码将一起编译到一个库中。 此库稍后将被网页使用。
- 数据元素和规则的配置。 此配置定义要从Dynamic Media查看器获取哪些数据,何时触发跟踪逻辑,以及在Adobe Analytics中将查看器数据发送到何处。
- 发布库。
要为集成配置Experience Platform标记,请执行以下操作:
-
首先从Experience Cloud访问Experience Platform标签 主页. 在菜单栏上,选择页面右上角附近的解决方案图标(3x3点表),然后选择 标记.
您还可以 直接打开Experience Platform标签.
在Experience Platform标签中创建资产 creating-a-property-in-adobe-launch
Experience Platform标记中的资产是一个命名配置,可将所有设置保留在一起。 将生成配置设置库并发布到不同的环境级别(开发、暂存和生产)。
另请参阅 配置选择属性.
要在Experience Platform标签中创建资产,请执行以下操作:
-
在Experience Platform标签中,选择 新建属性.
-
在 创建属性 对话框的 名称 字段中,键入描述性名称,如网站的标题。例如,
DynamicMediaViewersProp.
-
在 域 字段中,输入网站的域。
-
在 高级选项 下拉框中,启用 配置以进行扩展开发(以后无法修改),以防您要使用的扩展(本例中为 Dynamic Media 查看器)尚未发布。
-
选择 保存。
选择已创建的资产,然后继续执行 扩展的安装和设置.
安装和设置扩展 installing-and-setup-of-extensions
Experience Platform标签中所有可用的扩展都列在 扩展 > 目录.
要安装扩展,请选择 安装. 如果需要,请执行一次性扩展配置,然后选择 保存.
在需要时,必须安装和配置以下扩展:
- (必需) Experience CloudID服务 扩展
无需其他配置,接受任何建议值。 完成后,请确保选择 保存.
请参阅 Identity Service扩展Experience Cloud.
- (必需) Adobe Analytics 扩展
要配置此扩展,您需要在Adobe Analytics中位于下的报表包ID 管理员 > 报表包,位于 报表包ID 列标题。
(仅供演示之用, DynamicMediaViewersExtensionDoc 在以下屏幕截图中使用报表包。 此 ID 在之前的选择报表包中创建并使用。)
在“安装扩展”页面的 开发报表包 字段、测试报表包 字段和 生产报表包 字段中输入报表包 ID。
仅当您打算使用视频跟踪时,才配置以下项目:
在 安装扩展 页面,展开 常规,然后指定跟踪服务器。 跟踪服务器遵循模板 <trackingNamespace>.sc.omtrdc.net
,其中 <trackingNamespace>
是在预配电子邮件中获取的信息。
选择 保存。
请参阅 Adobe Analytics扩展.
- (可选。 仅在需要视频跟踪时才需要) 用于音频和视频的Adobe Medium Analytics 扩展
填写跟踪服务器字段。 的跟踪服务器 用于音频和视频的Adobe Medium Analytics 扩展不同于用于Adobe Analytics的跟踪服务器。 它遵循模板 <trackingNamespace>.hb.omtrdc.net
,其中 <trackingNamespace>
是来自配置电子邮件的信息。
所有其他字段都是可选的。
请参阅 Adobe Medium Analytics for Audio and Video扩展.
- (必需) Dynamic Media查看器 扩展
选择 启用 Adobe Analytics for Video 以启用(打开)视频检测信号跟踪。
截至本文撰写, Dynamic Media查看器 仅当为开发创建了Experience Platform标记属性时,扩展才可用。
请参阅 在Experience Platform标签中创建资产.
安装并设置扩展后,Extensions > Installed区域中至少会列出以下五个扩展(如果不跟踪视频,则四个)。
设置数据元素和规则 setting-up-data-elements-and-rules
在Experience Platform标记中,创建跟踪Dynamic Media查看器所需的数据元素和规则。
请参阅 数据和事件跟踪在集成中的工作原理 有关使用Experience Platform标记进行跟踪的概述。
请参阅 示例配置 Experience Platform标签中的示例配置,用于演示如何在加载查看器时跟踪资源名称。
请参阅 配置Dynamic Media查看器扩展 以了解有关扩展功能的详细信息。
发布库 publishing-a-library
要更改“Experience Platform标记”配置(包括设置的属性、扩展、规则和数据元素),您必须 发布 这些变化。 Experience Platform标记中的发布操作可通过Property配置下的Publishing选项卡执行。
Experience Platform标记可能具有多个开发环境、一个暂存环境和一个生产环境。 默认情况下,Platform中的Experience Platform标签云配置将Experience Manager创作Experience Manager指向Platform标签的“暂存”环境。 Experience Manager发布节点指向Experience Platform标签的生产环境。 这种安排意味着使用默认Experience Manager设置时,有必要将Experience Platform标记库发布到暂存环境。 这样,您就可以在Experience Manager创作中使用它。 然后,您可以将其发布到生产环境,以便在Experience Manager发布中使用。
请参阅 环境 有关Experience Platform标签环境的更多信息。
发布库的过程涉及以下两个步骤:
- 通过将所有必需的更改(新更改和更新)包含到库中来添加和构建新库。
- 在不同环境级别(从开发到暂存和生产)中向上移动库。
添加和构建新库 adding-and-building-a-new-library
-
首次在Experience Platform标签中打开“发布”选项卡时,库列表为空。
在左列中,选择 添加新库.
-
在“创建新库”页面上,使用 名称 字段中,输入新库的描述性名称。 例如,
DynamicMediaViewersLib
从“环境”下拉列表中,选择“环境”级别。 最初,仅开发级别可供选择。 在页面的左下角附近,选择 添加所有已更改资源.
-
在页面的右上角附近,选择 保存并构建用于开发.
几分钟后,库将创建并准备就绪。
note note NOTE 下次更改Experience Platform标签配置时,转到 发布 选项卡 属性 配置,然后选择您之前创建的库。 从库发布屏幕中,选择 添加所有已更改资源,然后选择 保存并构建用于开发.
在环境级别中向上移动库 moving-a-library-up-through-environment-levels
-
添加新库后,可在开发环境中找到它。 要将其移至暂存环境级别(与已提交列相对应),请从库的下拉菜单中,选择 提交以供审批.
-
在确认对话框中,选择 提交.
在库移至Submitted列后,从库的下拉菜单中选择 为暂存构建.
-
要将库从暂存环境移动到生产环境(即“已发布”列),请执行类似的过程。
首先,从下拉菜单中选择 批准以发布.
-
从下拉菜单中,选择 构建并发布到生产环境.
请参阅 发布 有关Experience Platform标记中发布过程的详细信息。
配置Adobe Experience Manager以进行集成 configuring-adobe-experience-manager-for-the-integration
先决条件:
- Experience Manager同时运行创作实例和发布实例。
- Experience Manager创作节点是在Dynamic Media中设置的。
- Dynamic Media WCM组件已在Experience Manager Sites中启用。
Experience Manager配置包含以下两个主要步骤:
- Experience ManagerIMS的配置。
- Experience Platform标签云的配置。
配置Experience ManagerIMS configuring-aem-ims
-
在Experience Manager创作中,选择“工具”图标(锤子),然后转到 安全性 > Adobe IMS配置.
-
在“AdobeIMC配置”页面的左上角附近,选择 创建.
-
在 Adobe IMS技术帐户配置 页面,在 云解决方案 下拉列表,选择 Experience Platform数据收集.
-
启用 创建新证书,然后在文本字段中,为您的证书输入任何有意义的值。 例如, AdobeLaunchIMSCert. 选择 创建证书.
将显示以下信息消息:
要检索有效的访问令牌,必须将新证书的公共密钥添加到Adobe Developer上的技术帐户中!
要关闭“信息”对话框,请选择 确定.
-
选择 下载公钥 要下载公钥文件(
*.crt
)。note note NOTE 此时, 保持打开 该 Adobe IMS技术帐户配置 页面; 不要 关闭页面并 不要 选择 下一个. 您稍后将在这些步骤中返回此页面。 -
在新的浏览器选项卡中,导航至 Adobe Developer控制台.
-
从 Adobe I/O控制台集成 页面,在右上角附近,选择 新集成.
-
在 创建新集成 对话框,请确保 访问API 单选按钮处于选中状态,然后选择 继续.
-
第二个 创建新集成 页面,启用(打开) Experience Platform标记API 单选按钮。 在页面的右下角,选择 继续.
-
在第三个 创建新集成 页面上,执行以下操作:
-
在 名称 字段,输入描述性名称。 例如, DynamicMediaViewersIO.
-
在 描述 字段中,输入集成的说明。
-
在 公钥证书 区域,上传您的公钥文件(
*.crt
)之前,您在这些步骤中下载的内容。 -
在 为Experience Platform标记API选择角色 标题,选择 管理员.
-
在 为Experience Platform标记API选择一个或多个产品配置文件 标题,选择名为的产品配置文件 标记 — <your_company_name>.
-
-
选择 创建集成.
-
在 已创建集成 页面,选择 继续查看集成详细信息.
-
此时将显示集成详细信息页面,如下所示:
note note NOTE 保持打开此集成详细信息页面。您将需要 概述 和 JWT 一会儿就跳卡。
集成详细信息页面 -
返回之前打开的 Adobe IMS 技术帐户配置 页面。在页面的右上角,选择 下一个 以打开 帐户 中的页面 Adobe IMS技术帐户配置 窗口。
(如果之前关闭了页面,请返回Experience Manager作者,然后转到 工具 > 安全性 > Adobe IMS配置. 选择 创建。在 云解决方案 下拉列表,选择 Experience Platform标记. 在 证书 下拉列表中,选择之前创建的证书的名称。
Adobe IMS技术帐户配置 — 证书页面 -
此 帐户 页面包含五个字段,需要您使用上一步中集成详细信息页面中的信息填写。
Adobe IMS技术帐户配置 — 帐户页面 -
在 帐户 页中,填写以下字段:
- 标题 — 输入描述性帐户标题。
- 授权服务器 — 返回之前打开的集成详细信息页面。 选择 JWT 选项卡。 复制服务器名称(不含路径),如下面突出显示的那样。
返回到 帐户 页面,然后将名称粘贴到相应的字段中。
例如,https://ims-na1.adobelogin.com/
(示例服务器名称仅用于解释)
集成详细信息页面 — JWT选项卡 -
API 密钥 - 返回到“集成详细信息”页面。选择 概述 选项卡,然后导航到右侧 API密钥(客户端ID) 字段,选择 复制.
返回到 帐户 页面,然后将密钥粘贴到相应的字段中。
集成详细信息页面 -
客户端密钥 - 返回到“集成详细信息”页面。从 概述 选项卡,选择 检索客户端密码. 右侧 客户端密码 字段,选择 复制.
返回到 帐户 页面,然后将密钥粘贴到相应的字段中。
-
有效负荷 — 返回集成详细信息页面。 从 JWT 选项卡,在JWT有效负载字段中,复制整个JSON对象代码。
返回到 帐户 页面,然后将代码粘贴到相应的字段中。
集成详细信息页面 — JWT选项卡填写了所有字段的“帐户”页显示如下:
-
在右上角附近 帐户 页面,选择 创建.
配置Experience ManagerIMS后,您现在有新的IMSAccount列在下 Adobe IMS配置.
为集成配置Experience Platform标签云 configuring-adobe-launch-cloud-for-the-integration
-
在Experience Manager创作中的左上角附近,选择“工具”图标(锤子),然后转到 Cloud Service > Experience Platform标记配置.
-
在 Experience Platform标记配置 页面上,在左侧面板中,选择要为其应用Experience Manager标签配置的Experience Platform站点。
仅供示例使用,
We.Retail
在下面的屏幕快照中选择了站点。 -
在页面的左上角附近,选择 创建.
-
在 常规 第(1/3页)的 创建Experience Platform标记配置 窗口中,填写以下字段:
-
标题 — 输入描述性配置标题。 例如:
We.Retail Tags cloud configuration
。 -
关联的Adobe IMS配置 — 选择您之前在中创建的IMS配置 配置Experience ManagerIMS.
-
公司 — 从 公司 从下拉列表中,选择您的Experience Cloud公司。 该列表会自动填充。
-
属性 — 从“属性”下拉列表中,选择您之前创建的“Experience Platform标记”属性。 该列表会自动填充。
-
填写完所有字段后, 常规 页面将类似于以下内容:
-
在左上角附近,选择 下一个.
-
在 暂存 第2/3页, 创建Experience Platform标记配置 窗口中,填写以下字段:
在 库URI (统一资源标识符)字段,请检查Experience Platform标记库的暂存版本的位置。 Experience Manager会自动填充此字段。
此步骤使用部署到Experience PlatformCDN的Adobe标签库仅供解释。
note note NOTE 检查以确保自动填充的库URI(统一资源标识符)的格式不正确。 如有必要,请修复该错误,以使URI表示协议相关的URI。 也就是说,它从双正斜线开始。 例如: //assets.adobetm.com/launch-xxxx
。您的 暂存 页面可能类似于以下内容。 此 存档 和 异步加载库 选项包括 非 设置:
-
在右上角附近,选择 下一个.
-
在 生产 第(3/3页)的 创建Experience Platform标记配置 窗口,如果需要,请修复自动填充的生产URI,类似于在上一个窗口中完成的情况 暂存 页面。
-
在右上角附近,选择 创建.
您的新Experience Platform标签云配置现已创建并列于您的网站旁边。
-
选择新的Experience Platform标记云配置(选中后,配置标题左侧会显示一个复选标记)。 在工具栏上,选择 Publish.
目前,Experience Manager作者不支持将Dynamic Media查看器与Experience Platform标记集成。
但是,Experience Manager发布节点支持此功能。 使用Experience Platform标签云配置的默认设置,Experience Manager发布会使用Experience Platform标签的生产环境。 因此,每次在测试期间都必须将Experience PlatformTags库更新从开发推送到生产环境。
可以解决此限制。 在上面的Experience Manager发布的Experience Platform标记云配置中,指定Experience Platform标记库的开发或暂存URL。 这样做会使Experience Manager发布节点使用Experience Platform标记库的开发版本或暂存版本。
请参阅 集成Experience Platform标签和Experience Manager 有关设置Experience Platform标签云配置的更多信息。