上载和实施端到端测试

注意

Adobe Experience Platform Launch已在Adobe Experience Platform中重新命名为一套数据收集技术。 因此，产品文档中的术语有一些改动。有关术语更改的综合参考，请参阅以下文档。

要在Adobe Experience Platform中测试标记扩展，请使用标记API和/或命令行工具上传扩展包。 接下来，使用Platform UI或数据收集UI将扩展包安装到资产，并在标记库和内部版本中执行其功能。

本文档介绍如何为扩展实施端到端测试。

注意

本指南假定您正在使用MacOS，且已安装并可用Node.js和npm。

验证扩展

当您的团队对扩展的性能以及在 沙盒 工具中，您应该可以将扩展包上传到标记。

上载之前，请验证是否存在任何必填字段或设置。例如，查看 扩展清单，您的 扩展配置，您的 视图和 库模块 （至少）是良好做法。

您的徽标文件就是一个具体示例：向 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 集成

要使用API或命令行工具，您需要具有Adobe I/O的技术帐户。您必须在I/O控制台中创建技术帐户，然后使用Uploader工具上传扩展包。

有关创建用于Adobe Experience Platform中标记的技术帐户的信息，请参阅 访问令牌 的双曲余切值。

重要

要在 Adobe I/O 中创建集成，您必须是 Experience Cloud 组织管理员或 Experience Cloud 组织开发人员。

如果您无法创建集成，则可能您没有正确的权限。 这需要组织管理员为您完成步骤或将您分配为开发人员。

上载扩展包

现在，您已经拥有凭据，可以端到端地测试扩展包。

首次上载扩展包时，它会进入 development 状态。这意味着它仅对您自己的组织可见，并且仅对已标记为进行扩展开发的资产可见。

使用命令行在包含.zip包的目录中运行以下命令。

npx @adobe/reactor-uploader

npx 允许您下载和运行 npm 包，而无需将其实际安装到计算机上。这是运行 Uploader 的最简单方法。

Uploader要求您输入多段信息。 技术帐户ID、API密钥和其他一些信息可以从Adobe I/O控制台中检索。 导航到 I/O 控制台中的集成页面。从下拉菜单中选择正确的组织，找到正确的集成，然后选择 查看.

  • 私钥的路径是什么？/path/to/private.key。这是您在上面步骤 2 中保存私钥的位置。
  • 您的组织 ID 是什么？从您之前保持打开状态的I/O控制台概述页面中复制并粘贴该内容。
  • 您的技术帐户 ID 是什么？请从I/O控制台复制并粘贴此代码。
  • 您的 API 密钥是什么？请从I/O控制台复制并粘贴此代码。
  • 客户端密码是什么？ 请从I/O控制台复制并粘贴此代码。
  • 要上载的 extension_package 的路径是什么？/path/to/extension_package.zip。如果从包含 .zip 包的目录中调用 Uploader，则只需从列表中选择该包，而不需要键入路径。

随后将上载扩展包，并且 Uploader 将为您提供 extension_package 的 ID。

注意

在上载或打补丁时，扩展包将处于待处理状态，而系统将异步提取该包并进行部署。在此过程进行时，您可以轮询 extension_package 使用API和UI中状态的ID。 您将在目录中看到一个标记为“Pending”的扩展卡。

注意

如果您计划经常运行Uploader，那么每次输入所有这些信息可能会带来负担。 您还可以从命令行将这些参数作为参数传入。 有关更多信息，请参阅 NPM 文档的命令行参数部分。

创建开发资产

登录UI并选择 标记 在左侧导航中， 属性 屏幕。 资产是要部署的标记的容器，可用于一个或多个网站。

首次登录时，您的屏幕上不会显示任何资产。 选择 New Property，以创建一个资产。输入名称和 URL。使用测试网站的URL或将在其中测试扩展的页面。 此域字段可由某些扩展使用，也可由使用核心扩展的条件使用。

注意

localhost 将不能用作URL值。 如果您使用的是 localhost URL。 例如， example.com。

要将此资产用于扩展开发测试，您必须将 高级OPTIONS 并确保选中 为扩展开发配置.

选择底部的 Save，以保存您的新资产。

此时将出现“Properties（属性）”屏幕。 选择刚刚创建的资产的名称。此时会显示资产概述屏幕。 它提供指向系统每个区域的链接，以及左侧列中的全局导航链接。

安装扩展

要在此资产中安装扩展，请选择 扩展 链接。 的 核心 扩展显示在 已安装 屏幕。 核心扩展包含数据收集中的所有标签管理功能。

要添加扩展，请选择 目录 选项卡。

目录将显示每个可用扩展的卡图标。如果您的扩展未显示在目录中，请确保您已完成上面“Adobe管理控制台”的“设置和创建扩展包”部分中的步骤。 如果Platform未完成初始处理，则扩展包也可能显示为“Pending”。

如果您已执行上述步骤，但仍未在目录中看到Pending或Failed扩展包，则应直接使用API检查扩展包的状态。 有关如何进行相应API调用的信息，请阅读 获取扩展包 （在API文档中）。

扩展包处理完成后，选择 安装 卡底部。

此时会打开配置屏幕（如果扩展具有配置屏幕）。 添加配置扩展所需的任何信息，然后选择底部的 Save。此处显示的配置屏幕示例使用了需要像素ID的Facebook扩展。

现在，您应该看到 Installed 扩展页面中包含 Core 扩展和您的扩展。

创建资源以测试扩展

扩展可为Adobe Experience Platform用户提供新功能。 这些规则通常显示在数据元素或规则生成器中。

数据元素

标记数据元素旨在帮助用户保留值。 每个数据元素都是到源数据的映射或指示符。单个数据元素是一个变量，可以映射到查询字符串、URL、Cookie 值、JavaScript 变量等。选择 数据元素 和 创建新数据元素.

扩展可以根据需要定义数据元素类型，以便扩展运行，或者只是为用户提供方便。当扩展提供数据元素类型时，这些类型会显示在 创建数据元素 屏幕：

当用户从 扩展 下拉菜单， 数据元素类型 下拉列表中填充了扩展提供的所有数据元素类型。 然后，用户可以将每个数据元素映射到其源值。接下来，在数据元素更改事件或自定义代码事件中构建规则时，可以使用数据元素来触发要执行的规则。数据元素还可用于数据元素条件或规则中的其他条件、例外或操作。

创建数据元素（设置映射）后，用户只需引用数据元素即可引用源数据。如果值的来源发生变化（网站重新设计等），用户只需在UI中更新一次映射，所有数据元素都将自动接收新的源值。

规则

选择 规则 链接，然后 创建新规则.

首先，为规则输入一个描述性名称。 的 创建规则 屏幕的设置如同 if-then 语句。

如果事件发生，条件通过评估，并且没有例外，则会触发操作。扩展中也存在相同的流程，您可以在其中创建或利用事件、条件、例外、数据元素或操作。

使用Facebook扩展示例，为页面在测试网站上加载的每次事件添加一个事件。

的 Window Loaded 事件类型 确保每当页面在测试网站上加载时，都会触发此规则。 选择 保留更改. 在本例中，忽略 条件 ，因为应触发测试网站上任何页面的规则。

在 操作 选择 添加. 的 操作配置 屏幕。接下来，您必须选择要应用规则的扩展，以及触发规则时要发生的操作。 选择 Facebook Pixel 从 扩展 下拉列表和 发送页面查看 从 操作类型 下拉列表。 选择 保留更改，然后 保存 以下内容 编辑规则 屏幕。

测试扩展时，请选择任何相关事件、条件等。 扩展提供的任何事件、条件等。

发布更改

在主导航中，选择 Publishing，然后选择 Add New Library 链接：

库是扩展、数据元素和规则如何彼此交互以及如何与网站交互的一组说明。库会被编译为内部版本。一个库可以包含用户希望一次进行或测试的任意多个更改。

在 创建库 ，在 名称 文本。 标记提供了一个名为 开发. 选择 开发 从 环境 下拉列表。 为简便起见，请添加所有可用资源。 选择 Add All Changed Resources，然后选择 保存.

注意

在将资源添加到库时，将会拍摄该资源截至此确切时间的快照并将其添加到库中。当您稍后对资源进行更改（例如，因为需要进行修复）时，还需要更新库以包含对资源的最新更改。Add All Changed Resources 按钮也可以用于此目的。

现在，所有更改都已包含在新创建的库中(名为 开发 在提供的示例中)，选择 保存并构建到开发环境.

构建过程完成后，将显示绿色 成功 指示器显示在库名称旁边。

标记库现已发布并可供使用。 测试页面必须使用新创建的库才能测试最终用户在浏览器中的页面行为。

在测试网站上安装标记

“环境”选项卡中提供了安装说明。 此页面显示所有可用的环境，还允许您创建更多环境。 将库发布到开发环境后，选择 安装 列 开发 行。

的 Web安装说明 将显示“开发”环境的对话框。 选择复制图标以复制整个 <script> 标记。

通过放置此单个 <script> 标记内部 <head> 文档或网站模板的部分。 接下来，访问测试网站以检查已发布标记库的行为。

测试

以下是用于在测试页面或网站上验证扩展的有用控制台命令列表。

  • _satellite.setDebug(true); 将启用调试模式，并将有用的日志记录语句输出到控制台。
  • 的 _satellite._container 对象包含有关已部署库的有用信息，包括有关所包含内部版本、数据元素、规则和扩展的详细信息。

此测试的目标是检查已部署库的功能，并确保扩展包在编译到库中后按预期方式运行。

当发现需要对扩展包进行更改时，迭代过程与开发过程类似。

  1. 更改项目中的代码。

  2. 使用沙盒工具验证更改.

  3. 使用 Packager 工具创建新的 .zip 包

  4. 使用Uploader工具上传新的.zip包。 此过程遵循与初始上传相同的说明。 但是，您会注意到，由于开发模式中已存在具有该名称的扩展包，因此此新包将覆盖旧版本，而不是创建新包。

    注意

    可以在命令行上传递参数，以避免凭据的重复输入，从而节省时间。 有关此内容的更多信息，请阅读 反应堆装载机文档.

    1. 更新现有包时，可以跳过安装步骤。

  5. 修改资源 — 如果任何扩展组件的配置已更改，则需要在UI中更新这些资源。

  6. 将最新更改添加到库，然后再次构建.

  7. 完成另一轮测试。

在此页面上