Web SDK标记扩展快速入门
使用Adobe Experience Platform的标记(以前为Launch)将事件数据从您的网站发送到Edge Network和下游Adobe解决方案。
在执行以下步骤之前,请确保您可以访问以下属性权限:
- Develop
- Manage extensions
此外,请确保您拥有以下类别的所有权限:
- 数据建模
- 身份标识
创建 XDM 架构 schema
体验数据模型(XDM)是一个开源规范,以架构的形式为数据提供通用结构和定义。 在向Edge Network发送数据时,强烈建议配置架构。
- 使用您的Adobe ID凭据登录experience.adobe.com。
- 导航到Data Collection > Schemas。
- 选择 Create schema。
- 选择Experience Event,然后选择Next。
- 为架构指定所需的名称,然后选择Finish。
- (可选)您可以为要收集的任何其他数据添加更多字段或字段组。
创建数据流 datastream
数据流是一种配置,用于告知Edge Network如何处理您向其发送的数据。 当您将数据流配置为将数据发送到给定产品时,数据流会以特定产品所理解的方式自动将相关数据传递到每个相应的产品。
- 导航到Data Collection > Datastreams。
- 选择 New datastream。
- 为数据流指定所需的名称,并在 Mapping schema 下选择最近创建的架构。
- 选择 Save。
创建标记属性
创建架构和数据流后,即可创建和配置标记属性。
- 导航到Data Collection > Tags。
- 选择 New property。
- 为标记属性指定所需的名称和域,然后选择Save。
安装标记扩展
Web SDK标记扩展安装在给定的标记属性上。
- 导航到Data Collection > Tags > Extensions。
- 选择 Catalog 选项卡。
- 使用搜索功能查找 Adobe Experience Platform Web SDK 扩展。
- 选择扩展卡片,然后选择右侧的Install。
配置标记扩展
安装Web SDK标记扩展时,您会自动转到配置页面。
- 在数据流部分下,为每个环境选择所需的数据流。
所有其他配置设置均由您填写或可选。 设置任何所需的配置设置,然后选择Save。
创建变量数据元素
Adobe建议使用变量数据元素来存储要发送到Adobe的有效负载。 XDM对象也是可用的数据元素,但在适用的用例中较旧,并且更有限。
-
导航到Data Collection > Tags。
-
选择所需的标记属性。
-
选择Data elements > Create new data element。
-
在左侧为数据元素指定以下属性:
- Name:任何所需的名称
- Extension: Adobe Experience Platform Web SDK
- Data element type: Variable
-
在右侧设置以下属性:
变量类型: XDM
Sandbox:您在其中创建架构的沙盒
Schema:所需的架构 -
选择 Save。
创建规则
规则决定您何时要触发某些操作或设置变量。 通过创建在加载库时运行的规则,您可以轻松填充要在每个页面上包含值的变量。
-
导航到Data Collection > Tags。
-
选择所需的标记属性。
-
选择Rules > Add rule。
-
为规则指定所需的名称。
-
选择
+旁边的“Events”图标。 -
为事件指定以下设置:
- Extension: Core
- Event type: Library loaded (page top)
-
选择 Keep changes。
上述步骤建立了规则的标准部分,该部分将在库加载后触发。 以下步骤确定在满足该标准时应采取的操作。
-
选择
+旁边的“Actions”图标。 -
在左侧为操作指定以下设置:
- Extension: Adobe Experience Platform Web SDK
- Action type: Send event
-
在右侧设置以下字段:
- XDM: XDM变量数据元素
-
选择 Keep changes。
发布
tag属性包含将数据发送到Edge Network所需的所有组件。
- 导航到Data Collection > Publishing flow。
- 选择 Add library。
- 为库指定所需的名称。 在版本控制软件中工作时,请考虑此名称与提交名称类似。
- 将环境下拉菜单设置为Development。
- 选择 Add all changed resources。
- 选择 Save & build to Development。
现在,您的更改将部署到开发环境。
- 导航到Data Collection > Environments。
- 选择开发环境旁边的安装图标
- 在网站的测试网页中安装嵌入代码。
验证标记是否适用于开发环境后,您可以使用Publishing flow界面将库发布到暂存环境,然后最终发布到生产环境。
- 将扩展和规则添加到库,将其构建到环境,并在您的网站上安装嵌入代码。
- 使用 Adobe Experience Platform Debugger 进行验证。
您现在有一个精简设置,用于捕获事件并将它们发送到Edge Network。 您现在可以通过以下方式进一步构建实施:将字段添加到架构、将产品添加到数据流或将数据元素添加到标记属性。