添加数据元素、规则和库

在本课程中,您将创建第一个数据元素、规则和库。

数据元素和规则是标记的基本构建块。 数据元素会存储您要发送到营销和广告解决方案的属性,而规则会在适当的条件下触发向这些解决方案发送的请求。库是在页面上加载以用于完成所有工作的 JavaScript 文件。在本课程中,您将使用所有这三项来让示例页面完成一些工作。

注意

Adobe Experience Platform Launch将作为一套数据收集技术集成到Adobe Experience Platform中。 界面中已推出一些术语更改,在使用此内容时,您应该注意这些更改:

学习目标

在本课程结束后,您将能够:

  • 创建数据元素
  • 创建规则
  • 创建库
  • 将更改添加到库
  • 验证您的库是否正在 Web 浏览器中加载
  • 使用“工作库”功能提高工作效率

为页面名称创建数据元素

数据元素是数据层的标记版本。 它们可以存储来自您自己的数据层对象、Cookie、本地存储对象、查询字符串参数、页面元素、meta 标记等的值。在本练习中,您将为页面名称创建一个数据元素,稍后您将在 Target 和 Analytics 实施中使用该数据元素。

创建数据元素

  1. 在左侧导航中,单击 数据元素

  2. 由于您尚未在此资产中创建任何数据元素,因此会显示一个简短视频,该视频中提供了有关此主题的其他信息。如有需要,请观看此视频。

  3. 单击 Create New Data Element 按钮:

    单击 Create New Data Element 按钮

  4. 命名数据元素,例如 Page Name

  5. 使用 JavaScript Variable 数据元素类型指向示例页面数据层中的一个值:digitalData.page.pageInfo.pageName

  6. 选中 Force lowercase valueClean text 复选框,以使大小写标准化,并删除无关空格

  7. Storage Duration 设置保留为 None,因为该值通常在每个页面上都不同

  8. 单击 Save 按钮以保存数据元素

    创建 Page Name 数据元素

注意

可以通过“扩展”来扩展数据元素功能​__。例如,ContextHub 扩展允许您使用该扩展的功能添加数据元素。

创建规则

接下来,您将以简单的规则使用此数据元素。规则是标记中最强大的功能之一,允许您指定当访客与您的网站交互时应发生的情况。 如果满足您的规则中所列的标准,规则将触发您指定的操作。

您将创建一个用于将 Page Name 数据元素值输出到浏览器控制台的规则。

创建规则

  1. 在左侧导航中,单击 规则

  2. 由于您尚未在此资产中创建任何规则,因此会显示一个简短视频,该视频中提供了有关此主题的其他信息。如有需要,请观看此视频。

  3. 单击 Create New Rule 按钮:

    单击 Create New Rule 按钮

  4. 将规则命名为 All Pages - Library Loaded。此命名约定可指示规则触发的位置和时间,从而更便于在标记属性逐步完善时识别并重复使用。

  5. 在 Events 下,单击 Add。事件可告知标记规则应何时触发,事件有多种类型,包括页面加载、单击、自定义JavaScript事件等。

    命名规则并添加事件

    1. 对于事件类型,选择 Library Loaded (Page Top)。请注意,当您选择事件类型时,标记会使用您选择的内容预填充事件的名称。 另请注意,事件的默认顺序为 50。在标记中,排序是一项强大功能,当您有多个由同一事件触发的规则时,这项功能可让您精确控制各操作的顺序。 您将在本教程的后面部分使用此功能。

    2. 单击 Keep Changes 按钮

    选择事件

  6. 由于此规则应在所有页面上触发,因此将 Conditions 保留为空。如果您打开 Conditions 模式窗口,则会发现条件可以根据各种选项(包括 URL、数据元素值、日期范围等)添加限制条件和排除条件。

  7. 在 Actions 下,单击 Add

  8. 选择 Action Type > Custom Code,此时这是唯一的选项。稍后在教程中,当您添加扩展时,会有更多的选项可用。

  9. 选择 </> Open Editor 以打开代码编辑器

    选择操作

  10. 将以下代码添加到代码编辑器中。此代码会将 Page Name 数据元素的值输出到浏览器控制台,以便您能够确认它在正常工作:

    console.log('The page name is '+_satellite.getVar('Page Name'));
    
  11. 保存代码编辑器

    输入自定义代码

  12. 在操作配置屏幕上,单击 Keep Changes

  13. 单击 Save 以保存规则

在规则页面上,您应会看到新规则:
规则显示在页面上

将更改保存到库

在数据收集界面中配置一组扩展、数据元素和规则后,您需要将这些功能和逻辑打包到一组JavaScript代码中,之后您可以在网站上部署该代码,以便当访客访问网站时,将触发营销标记。 库便是执行此操作的一组 JavaScript 代码。

在前面的课程中,您在示例页面上实施了开发环境的嵌入代码。在加载示例页面时,返回了与嵌入代码URL有关的404错误,因为尚未构建标记库并且未将其分配给环境。 现在,您要将新的数据元素和规则放置到库中,以便示例页面可以执行一些操作。

添加和构建库

  1. 在左侧导航中,单击 发布流程

  2. 单击 Add New Library

    Add New Library

  3. 命名库,例如 Initial Setup

  4. 选择 Environment > Development

  5. 单击 Add All Changed Resources

    Add All Changed Resources

  6. 请注意,在单击 Add All Changed Resources 标记将汇总您刚才所做的更改。

  7. 单击 Save & Build for Development

    Save & Build for Development

片刻后,状态圆点将变为绿色,这表示库已成功构建。

库已构建

验证您的工作

现在,验证您的规则是否按预期运行。

重新加载示例页面。如果查看开发人员工具 — >网络选项卡,您现在应会看到标记库的200响应!

库加载并显示 200 响应

如果您查看开发人员工具的“控制台”,则应当看到文本“The page name is home”

控制台消息

恭喜,您已创建第一个数据元素和规则并构建了第一个标记库!

使用工作库功能

在标记中进行多项更改时,如果每次想要查看结果时都必须打开“发布”选项卡、添加更改并构建库,这样会很麻烦。 现在,您已创建“Initial Setup”库,接下来可以使用“工作库”功能快速保存所做的更改并重新构建库,所有这些操作只需一步即可完成。

对“All Pages - Library Loaded”规则进行小幅更改。在左侧导航中,单击 规则 然后,单击 All Pages - Library Loaded 规则打开。

重新打开规则

Edit Rule 页面上,单击 Working Library ​** 下拉菜单,然后选择您的 Initial Setup 库。

选择 Initial Setup 作为工作库

选择库后,您应当看到 Save 按钮现在默认为 Save to Library。在标记中进行更改后,您可以使用此选项自动将所做的更改直接添加到工作库中和/或重新构建该库。

我们来测试一下。打开您的 Custom Code 操作并在文本“The page name is”后面添加一个冒号,以使整个代码块如下所示:

console.log('The page name is: '+_satellite.getVar('Page Name'));

保存代码,保留操作中的更改,现在单击 Save to Library and Build 按钮。

保存并构建选项现已存在

等待片刻,直到 Working Library 下拉菜单旁重新显示绿色圆点。现在,重新加载示例页面,您应当看到控制台消息中反映了所做的更改(您可能需要清除浏览器缓存并重新加载,才能看到对页面所做的更改):

带有冒号的控制台消息

这是一种更快的工作方式,您将在本教程的其余部分使用此方法。

下一课程“使用 Experience Cloud Debugger 切换环境”>

在此页面上