使用 Adobe Target 和 Web SDK 个性化

上次更新: 2023-12-06
  • 主题:
  • Web SDK
    查看有关此主题的更多信息
  • 创建对象:
  • Developer
    User
    Admin
    Leader

Adobe Experience Platform Web SDK 可以投放和渲染在中管理的个性化体验 Adobe Target 到Web渠道。 您可以使用WYSIWYG编辑器,称为 可视化体验编辑器 (VEC)或非可视化界面, 基于表单的体验编辑器,创建、激活和交付您的活动和个性化体验。

重要

了解如何使用将Target实施迁移到Platform Web SDK 将Target从at.js 2.x迁移到Platform Web SDK 教程。

了解如何使用首次实施Target 利用Web SDK实施Adobe Experience Cloud 教程。 有关特定于Target的信息,请参阅名为的教程部分 使用Platform Web SDK设置Target.

以下功能已经过测试,当前在中受支持 Target:

Web SDK 系统图

下图可帮助您了解的工作流 Target 和 Web SDK edge decisioning.

使用Platform Web SDK的Adobe Target Edge Decisioning示意图

调用 详细信息
1 设备加载 Web SDK. 此 Web SDK 使用XDM数据、数据流环境ID、传入参数和客户ID(可选)向边缘网络发送请求。 页面(或容器)已预先隐藏。
2 边缘网络将请求发送到边缘服务,以使用访客ID、同意和其他访客上下文信息(如地理位置和设备友好名称)扩充其内容。
3 边缘网络将扩充的个性化请求发送至 Target 使用访客ID和传入的参数进行Edge。
4 配置文件脚本先执行,然后注入到 Target 配置文件存储。 配置文件存储从获取区段 受众库 (例如,从共享区段 Adobe Analytics, Adobe Audience Manager, Adobe Experience Platform)。
5 根据URL请求参数和配置文件数据, Target 确定可为访客显示的当前页面视图和未来预取视图的活动和体验。 Target 然后将它发回到edge network。
6 a.边缘网络将个性化响应发送回页面,其中可能包含其他个性化的配置文件值。 当前页面上的个性化内容会在默认内容不发生闪烁的情况下尽快显示。
b.作为用户操作在单页应用程序(SPA)中显示的视图的个性化内容将缓存,这样便可在触发视图时即时应用而无需额外的服务器调用。
的问题。Edge Network发送访客ID和Cookie中的其他值,例如同意、会话ID、身份、Cookie检查和个性化。
7 边缘网络转发 目标分析 (A4T)的详细信息(活动、体验和转化元数据) Analytics 边缘。

正在启用 Adobe Target

要启用 Target,请执行以下操作:

  1. 启用 Target 在您的 数据流 ,并提供相应的客户端代码。
  2. 添加 renderDecisions 选项添加到您的事件。

然后,您还可以选择添加以下选项:

  • decisionScopes:通过将此选项添加到您的事件中,检索特定活动(对于使用基于表单的编辑器创建的活动非常有用)。
  • 预隐藏代码片段:仅隐藏页面的某些部分。

使用Adobe Target VEC

要将VEC与 Web SDK 实施,安装并激活 Firefox铬黄 VEC助手扩展。

有关更多信息,请参阅 可视化体验编辑器助手扩展Adobe Target指南.

呈现个性化内容

请参阅 呈现个性化内容 以了解更多信息。

XDM中的受众

在为定义受众时 Target 通过交付的活动 Web SDK, XDM 必须定义和使用。 定义XDM架构、类和架构字段组后,您可以创建 Target 由XDM数据定义的用于定位的受众规则。 范围 Target, XDM数据显示在 Audience Builder 作为自定义参数。 XDM使用点表示法序列化(例如, web.webPageDetails.name)。

如果您拥有 Target 如果活动包含使用自定义参数或用户配置文件的预定义受众,则无法通过SDK正确交付这些活动。 您必须改用XDM,而不是使用自定义参数或用户配置文件。 但是,提供开箱即用的受众定位字段,支持它们通过 Web SDK 而不需要XDM。 这些字段在 Target 不需要XDM的UI:

  • 定位库
  • 地域
  • 网络
  • 操作系统
  • 网站页面
  • 浏览器
  • 流量源
  • 时间范围

有关更多信息,请参阅 受众类别Adobe Target指南.

响应令牌

响应令牌用于将元数据发送到Google或Facebook等第三方。 响应令牌在中返回 meta 字段范围 propositions -> items. 以下是示例:

{
  "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
  "scope": "__view__",
  "scopeDetails": ...,
  "renderAttempted": true,
  "items": [
    {
      "id": "0",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
        "experience.id": "0",
        "activity.id": "126736",
        "offer.name": "Default Content",
        "offer.id": "0"
      }
    }
  ]
}

要收集响应令牌,您必须订阅 alloy.sendEvent 承诺,反复访问 propositions,并从提取详细信息 items -> meta.

proposition 具有 renderAttempted 布尔字段,指示是否 proposition 是否呈现。 请参阅下面的示例:

alloy("sendEvent",
  {
    renderDecisions: true,
    decisionScopes: [
      "hero-container"
    ]
  }).then(result => {
    const { propositions } = result;

    // filter rendered propositions
    const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);

    // collect the item metadata that represents the response tokens
    const collectMetaData = (items) => {
      return items.filter(item => item.meta !== undefined).map(item => item.meta);
    }

    const pageLoadResponseTokens = renderedPropositions
      .map(proposition => collectMetaData(proposition.items))
      .filter(e => e.length > 0)
      .flatMap(e => e);
  });

启用自动渲染时,建议数组包含:

在页面加载时:

  • 基于表单的编辑器 propositions 替换为 renderAttempted 标志设置为 false
  • 基于可视化体验编辑器的建议,具有 renderAttempted 标志设置为 true
  • 基于可视化体验编辑器的单页应用程序视图建议 renderAttempted 标志设置为 true

查看时 — 更改(对于缓存的视图):

  • 基于可视化体验编辑器的单页应用程序视图建议 renderAttempted 标志设置为 true

禁用自动渲染时,建议数组包含:

在页面加载时:

  • Form-based Composer基于 propositions 替换为 renderAttempted 标志设置为 false
  • Visual Experience Composer基于的主张,带有 renderAttempted 标志设置为 false
  • Visual Experience Composer用于单页应用程序视图的基于的建议 renderAttempted 标志设置为 false

查看时 — 更改(对于缓存的视图):

  • 基于可视化体验编辑器的单页应用程序视图建议,具有 renderAttempted 标志设置为 false

单个配置文件更新

此 Web SDK 允许您将配置文件更新到 Target 配置文件和 Web SDK 作为体验事件。

要更新 Target 配置文件时,请确保使用以下各项来传递配置文件数据:

  • "data {"
  • "__adobe.target"
  • 前缀 "profile."
类型 描述
renderDecisions 布尔值 指示个性化组件是否应解释DOM操作
decisionScopes 数组 <String> 要检索决策的作用域列表
xdm 对象 在Web SDK中作为体验事件登陆的XDM格式的数据
data 对象 发送到的任意键/值对 Target 目标类下的解决方案。

典型 Web SDK 使用此命令的代码如下所示:

sendEvent包含配置文件数据

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform data }
});

如何将配置文件属性发送到Adobe Target:

alloy("sendEvent", {
  renderDecisions: true,
  data: {
    __adobe: {
      target: {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

请求建议

下表列出了 Recommendations 属性以及是否通过 Web SDK:

类别 属性 支持状态
Recommendations — 默认实体属性 entity.id 受支持
entity.name 受支持
entity.categoryId 受支持
entity.pageUrl 受支持
entity.thumbnailUrl 受支持
entity.message 受支持
entity.value 受支持
entity.inventory 受支持
entity.brand 受支持
entity.margin 受支持
entity.event.detailsOnly 受支持
Recommendations — 自定义实体属性 entity.yourCustomAttributeName 受支持
Recommendations — 保留的mbox/页面参数 excludedIds 受支持
cartIds 受支持
productPurchasedId 受支持
类别亲和度的页面或物料类别 user.categoryId 受支持

如何将Recommendations属性发送到Adobe Target:

alloy("sendEvent", {
  renderDecisions: true,
  data: {
    __adobe: {
      target: {
        "entity.id": "123",
        "entity.genre": "Drama"
      }
    }
  }
});

调试

已弃用mboxTrace和mboxDebug。 使用 Web SDK 调试.

术语

建议: 在 Adobe Target,建议与从活动中选择的体验相关联。

架构: 决策的结构是中的优惠类型 Adobe Target.

范围: 决定的范围。 在 Adobe Target,范围是mBox。 全局mBox是 __view__ 范围。

XDM: XDM将序列化为点表示法,然后放入 Adobe Target 作为mBox参数。

在此页面上