使用 Adobe Target 和 Web SDK 个性化
Adobe Experience Platform Web SDK 可以投放和渲染在中管理的个性化体验 Adobe Target 到Web渠道。 您可以使用WYSIWYG编辑器,称为 可视化体验编辑器 (VEC)或非可视化界面, 基于表单的体验编辑器,创建、激活和交付您的活动和个性化体验。
以下功能已经过测试,当前在中受支持 Target:
Web SDK 系统图
下图可帮助您了解的工作流 Target 和 Web SDK edge decisioning.
b.作为用户操作在单页应用程序(SPA)中显示的视图的个性化内容将缓存,这样便可在触发视图时即时应用而无需额外的服务器调用。
的问题。Edge Network发送访客ID和Cookie中的其他值,例如同意、会话ID、身份、Cookie检查和个性化。
正在启用 Adobe Target
要启用 Target,请执行以下操作:
- 启用 Target 在您的 数据流 ,并提供相应的客户端代码。
- 添加
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
decisionScopes
<String>
xdm
data
典型 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属性发送到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参数。