上载和实施端到端测试
要在Adobe Experience Platform中测试标记扩展,请使用标记API和/或命令行工具来上传扩展包。 接下来,使用Platform UI或数据收集UI将扩展包安装到资产,并在标记库和内部版本中执行其功能。
本文档介绍如何对扩展实施端到端测试。
验证扩展 validate
当您的团队对扩展的性能以及他们在沙盒工具中看到的结果感到满意后,您就可以将扩展包上载到标记了。
上载之前,请验证是否存在任何必填字段或设置。例如,最佳做法是(至少)查看扩展清单、扩展配置、视图和库模块。
您的徽标文件就是一个具体示例:向您的extension.json
文件中添加"iconPath": "example.svg",
行,并将该徽标图像文件包含在您的项目中。 这是将为扩展显示的图标的相对路径。 它不应以斜杠开头,必须引用一个扩展名为 .svg
的 SVG 文件。SVG在呈现正方形时应正常显示,并且可通过用户界面缩放。 有关详细信息,请参阅如何缩放SVG文章。
extension.json
中添加一个项目,并包含指向 Exchange 列表的链接。您的扩展清单应包含如下条目:"exchangeUrl":"https://www.adobeexchange.com/experiencecloud.details.12345.html"
,以指向 Exchange 列表的 URL。创建Adobe I/O集成 integration
要使用API或命令行工具,您需要具有Adobe I/O的技术帐户。您必须在I/O控制台中创建技术帐户,然后使用Uploader工具上载扩展包。
有关创建技术帐户以用于Adobe Experience Platform中的标记的信息,请参阅Reactor API快速入门指南。
如果无法创建集成,则您可能没有正确的权限。 这需要组织管理员为您完成这些步骤或将您指定为开发人员。
上载扩展包 upload
现在您有了凭据,可以端到端地测试扩展包了。
首次上载扩展包时,它会进入development
状态。 这意味着它仅对您自己的组织可见,并且仅对标记为进行扩展开发的资产可见。
使用命令行在包含.zip包的目录中运行以下命令。
npx @adobe/reactor-uploader
npx
允许您下载和运行npm包,而无需将其实际安装到计算机上。 这是运行 Uploader 的最简单方法。
jwt-auth
凭据通过运行
npx @adobe/reactor-uploader@v5.2.0
一直使用到2025年1月1日弃用。 所需的参数此处找到
jwt-auth
版本以运行。上传程序仅要求您输入几条信息。 可以从Adobe I/O控制台检索clientId
和clientSecret
。 导航到I/O控制台中的集成页面。 从下拉菜单中选择正确的组织,找到正确的集成,然后选择 查看。
- 您的
clientId
是什么? 请从I/O控制台复制并粘贴此项。 - 您的
clientSecret
是什么? 请从I/O控制台复制并粘贴此项。 - 如果从包含 .zip 包的目录中调用 Uploader,则只需从列表中选择该包,而不需要键入路径。
随后将上载扩展包,并且 Uploader 将为您提供 extension_package 的 ID。
extension_package
ID的状态。 您将在目录中看到一个标记为“Pending(待处理)”的扩展卡片。创建开发资产 property
登录UI并在左侧导航中选择 标记 后,将显示属性屏幕。 资产是要部署的标记的容器,可用于一个或多个网站。
首次登录时,屏幕上不会显示任何资产。 选择 New Property,以创建一个资产。输入名称和 URL。使用测试网站或要测试扩展的页面的URL。 此域字段可以由某些扩展使用,也可以由使用核心扩展的条件使用。
localhost
不能用作URL值。 如果您使用localhost
URL,请改用任何模拟值进行测试。 例如,example.com。若要将此属性用于扩展开发测试,必须展开 高级OPTIONS,并确保选中 为扩展开发配置 的框。
选择底部的 Save,以保存您的新资产。
出现“Properties(属性)”屏幕。 选择刚刚创建的资产的名称。此时会显示“Property Overview”屏幕。 它提供指向系统每个区域的链接,左侧列中包含全局导航链接。
安装扩展 install-extension
要在此属性中安装扩展,请选择左列主导航链接中的 Extensions 链接。 Core 扩展显示在 Installed 屏幕上。 核心扩展包含数据收集中的所有标记管理功能。
要添加扩展,请选择 目录 选项卡。
目录将显示每个可用扩展的卡图标。如果您的扩展未显示在目录中,请确保您已完成Adobe管理控制台的“设置”和“创建扩展包”部分中的上述步骤。 如果Platform尚未完成初始处理,则扩展包也可能显示为“Pending”。
如果您已执行上述步骤,但仍未在目录中看到“Pending”或“Failed”扩展包,则应直接使用API检查扩展包的状态。 有关如何进行适当API调用的信息,请参阅API文档中的获取扩展包。
扩展包处理完毕后,选择卡底部的 安装。
配置屏幕将打开(如果扩展具有)。 添加配置扩展所需的任何信息,然后选择底部的 保存。 此处显示的配置屏幕示例使用了Facebook扩展,该扩展需要像素ID。
现在,您应该看到 Installed 扩展页面中包含 Core 扩展和您的扩展。
创建资源以测试扩展 resources
扩展可为Adobe Experience Platform用户提供一些新功能。 这些变量通常显示在数据元素或规则生成器中。
数据元素
标记数据元素的目的是帮助用户保留值。 每个数据元素都是到源数据的映射或指示符。单个数据元素是一个变量,可以映射到查询字符串、URL、Cookie值、JavaScript变量等。 从左侧导航栏中选择 数据元素,然后 创建新数据元素。
扩展可以根据需要定义数据元素类型,以便扩展运行,或者只是为用户提供方便。当扩展提供数据元素类型时,这些类型会显示在 创建数据元素 屏幕上为用户提供的下拉列表中:
当用户从 Extension 下拉列表中选择您的扩展时,数据元素类型 下拉列表中将填充您的扩展提供的所有数据元素类型。 然后,用户可以将每个数据元素映射到其源值。接下来,在数据元素更改事件或自定义代码事件中构建规则时,可以使用数据元素来触发要执行的规则。数据元素还可以在数据元素条件或规则中的其他条件、例外或操作中使用。
创建数据元素(设置映射)后,用户只需引用数据元素即可引用源数据。如果值的来源发生变化(网站重新设计等),用户只需在UI中更新一次映射,所有数据元素都会自动接收新的源值。
规则
在左侧导航中选择 规则 链接,然后选择 创建新规则。
首先,为规则输入一个描述性名称。 创建规则 屏幕的设置类似于if-then
语句。
如果事件发生,条件通过评估,并且没有例外,则会触发操作。扩展中也存在相同的流程,您可以在其中创建或利用事件、条件、例外、数据元素或操作。
以Facebook扩展为例,为页面在测试网站上加载的每次添加一个事件。
Window Loaded
事件类型 可确保每当页面在测试站点上加载时,都会触发此规则。 选择 保留更改。 对于此示例,请忽略 Conditions,因为应该为测试站点上的任何页面触发规则。
在 操作 下,选择 添加。 将显示 Action Configuration 屏幕。接下来,您必须选择要应用规则的扩展以及触发规则时要发生的操作。 从 扩展 下拉列表中选择 Facebook Pixel,从 操作类型 下拉列表中选择 发送页面查看。 在以下 编辑规则 屏幕上选择 保留更改,然后选择 保存。
测试扩展时,请选择任何相关的事件、条件等。 扩展提供的任何事件、条件等。
Publish您的更改 publish
在主导航中,选择 Publishing,然后选择 Add New Library 链接:
库是扩展、数据元素和规则如何彼此交互以及如何与网站交互的一组说明。库会被编译为内部版本。一个库可以包含用户希望一次进行或测试的任意多个更改。
在 创建库 屏幕上,在 名称 文本字段中添加名称。 标记提供了一个名为 开发 的默认开发环境。 从 环境 下拉列表中选择 开发。 为简单起见,请添加所有可用资源。 选择 添加所有更改的资源,然后选择 保存。
现在,所有更改都已包含在新创建的库(在提供的示例中名为 dev)中,请选择 保存并生成到开发。
生成过程完成后,库名称旁边会显示一个绿色的 success 指示符。
标记库现已发布并可供使用。 测试页面必须使用新创建的库,才能在浏览器中测试最终用户的页面行为。
在测试网站上安装标记 install-data-collection-tags
安装说明可从“环境”选项卡中获取。 此页面显示所有可用的环境,并允许您创建更多环境。 由于库已发布到开发环境,请选择 开发 行上 INSTALL 列中的框图标。
出现开发环境的 Web安装说明 对话框。 选择复制图标以复制整个<script>
标记。
通过将单个<script>
标记放入文档或网站模板的<head>
部分中,完成安装。 接下来,访问测试网站以检查已发布的标记库的行为。
测试 test
以下是在测试页面或站点上验证扩展的有用控制台命令列表。
_satellite.setDebug(true);
将启用调试模式并将有用的日志记录语句输出到控制台。_satellite._container
对象包含有关已部署库的有用信息,包括有关所包含内部版本、数据元素、规则和扩展的详细信息。
此测试的目的是检查已部署库的功能,并确保扩展包在编译到库之后按预期运行。
当发现需要对扩展包进行更改时,迭代过程与开发过程类似。
-
对项目中的代码进行更改。
-
使用沙盒工具验证更改。
-
使用 Packager 工具创建新的 .zip 包
-
使用Uploader工具上载新的.zip包。 该过程遵循与之前有关初始上传的相同说明。 但是,您会注意到,由于在开发模式下已存在具有该名称的扩展包,因此此新包将覆盖旧版本,而不是创建新包。
note note NOTE 可以在命令行上传递参数,以避免重复输入凭据,从而节省时间。 有关此内容的更多信息,请阅读reactor-uploader文档。 1. 更新现有包时,可以跳过安装步骤。
-
修改资源 — 如果任何扩展组件的配置已更改,您将需要在UI中更新这些资源。
-
将最新更改添加到库中,然后再次构建。
-
完成另一轮测试。