Web SDK标记扩展快速入门

使用Adobe Experience Platform的​标记(以前为Launch)将事件数据从您的网站发送到Edge Network和下游Adobe解决方案。

在执行以下步骤之前,请确保您可以访问以下属性权限

  • Develop
  • Manage extensions

此外,请确保您拥有以下类别的所有权限

  • 数据建模
  • 身份标识

创建 XDM 架构 schema

体验数据模型(XDM)是一个开源规范,以架构的形式为数据提供通用结构和定义。 在向Edge Network发送数据时,强烈建议配置架构。

  1. 使用您的Adobe ID凭据登录experience.adobe.com
  2. 导航到​Data Collection > Schemas
  3. 选择 Create schema
  4. 选择​Experience Event,然后选择​Next
  5. 为架构指定所需的名称,然后选择​Finish
  6. (可选)您可以为要收集的任何其他数据添加更多字段或字段组

架构画布

NOTE
保存后,架构仅允许​ 累加 ​更改。 有关详细信息,请参阅架构演变

创建数据流 datastream

数据流是一种配置,用于告知Edge Network如何处理您向其发送的数据。 当您将数据流配置为将数据发送到给定产品时,数据流会以特定产品所理解的方式自动将相关数据传递到每个相应的产品。

  1. 导航到​Data Collection > Datastreams
  2. 选择 New datastream
  3. 为数据流指定所需的名称,并在​ Mapping schema ​下选择最近创建的架构。
  4. 选择 Save

数据流列表

创建标记属性

创建架构和数据流后,即可创建和配置标记属性。

  1. 导航到​Data Collection > Tags
  2. 选择 New property
  3. 为标记属性指定所需的名称和域,然后选择​Save

安装标记扩展

Web SDK标记扩展安装在给定的标记属性上。

  1. 导航到​Data Collection > Tags > Extensions
  2. 选择 Catalog 选项卡。
  3. 使用搜索功能查找​ Adobe Experience Platform Web SDK ​扩展。
  4. 选择扩展卡片,然后选择右侧的​Install

安装SDK

配置标记扩展

安装Web SDK标记扩展时,您会自动转到配置页面。

  1. 数据流部分下,为每个环境选择所需的数据流。

所有其他配置设置均由您填写或可选。 设置任何所需的配置设置,然后选择​Save

创建变量数据元素

Adobe建议使用变量数据元素来存储要发送到Adobe的有效负载。 XDM对象也是可用的数据元素,但在适用的用例中较旧,并且更有限。

  1. 导航到​Data Collection > Tags

  2. 选择所需的标记属性。

  3. 选择​Data elements > Create new data element

  4. 在左侧为数据元素指定以下属性:

    • Name:任何所需的名称
    • Extension: Adobe Experience Platform Web SDK
    • Data element type: Variable
  5. 在右侧设置以下属性:
    变量类型: XDM
    Sandbox:您在其中创建架构的沙盒
    Schema:所需的架构

  6. 选择 Save

创建规则

规则决定您何时要触发某些操作或设置变量。 通过创建在加载库时运行的规则,您可以轻松填充要在每个页面上包含值的变量。

  1. 导航到​Data Collection > Tags

  2. 选择所需的标记属性。

  3. 选择​Rules > Add rule

  4. 为规则指定所需的名称。

  5. 选择+旁边的“Events”图标。

  6. 为事件指定以下设置:

    • Extension: Core
    • Event type: Library loaded (page top)
  7. 选择 Keep changes

上述步骤建立了规则的标准部分,该部分将在库加载后触发。 以下步骤确定在满足该标准时应采取的操作。

  1. 选择+旁边的“Actions”图标。

  2. 在左侧为操作指定以下设置:

    • Extension: Adobe Experience Platform Web SDK
    • Action type: Send event
  3. 在右侧设置以下字段:

    • XDM: XDM变量数据元素
  4. 选择 Keep changes

操作配置

发布

tag属性包含将数据发送到Edge Network所需的所有组件。

  1. 导航到​Data Collection > Publishing flow
  2. 选择 Add library
  3. 为库指定所需的名称。 在版本控制软件中工作时,请考虑此名称与提交名称类似。
  4. 将环境下拉菜单设置为​Development
  5. 选择 Add all changed resources
  6. 选择 Save & build to Development

现在,您的更改将部署到开发环境。

  1. 导航到​Data Collection > Environments
  2. 选择开发环境旁边的安装图标
  3. 在网站的测试网页中安装嵌入代码。

验证标记是否适用于开发环境后,您可以使用Publishing flow界面将库发布到暂存环境,然后最终发布到生产环境。

  1. 将扩展和规则添加到​,将其构建到​环境,并在您的网站上安装嵌入代码。
  2. 使用​ Adobe Experience Platform Debugger ​进行验证。

您现在有一个精简设置,用于捕获事件并将它们发送到Edge Network。 您现在可以通过以下方式进一步构建实施:将字段添加到架构、将产品添加到数据流或将数据元素添加到标记属性。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743