Adobe Experience Platform Web SDK 可以提供和呈现在中管理的个性化体验 Adobe Target 到web渠道。 您可以使用WYSIWYG编辑器,称为 可视化体验编辑器 (VEC),或者非可视化界面, 基于表单的体验编辑器,以创建、激活和提供活动和个性化体验。
的 Adobe Target文档 其中包含的主题包含特定于Platform Web SDK的信息,这些信息与Target特性和功能相关。
以下功能已经过测试,目前在 Target:
下图可帮助您了解 Target 和 Platform Web SDK 边缘决策。
调用 | 详细信息 |
---|---|
1 | 设备加载 Platform Web SDK. 的 Platform Web SDK 向边缘网络发送请求,其中包含XDM数据、数据流环境ID、传递的参数和客户ID(可选)。 页面(或容器)已预隐藏。 |
2 | 边缘网络会向边缘服务发送请求,以便通过访客ID、同意和其他访客上下文信息(如地理位置和设备友好名称)来扩充请求。 |
3 | 边缘网络将扩充的个性化请求发送到 Target 具有访客ID和传入参数的边缘。 |
4 | 配置文件脚本先执行,然后馈送到中 Target 配置文件存储。 配置文件存储从 受众库 (例如,从 Adobe Analytics, Adobe Audience Manager, Adobe Experience Platform)。 |
5 | 根据URL请求参数和配置文件数据, Target 确定要为访客显示哪些活动和体验以用于当前页面查看和将来预取的查看。 Target 然后将此数据发送回边缘网络。 |
6 | a.边缘网络会将个性化响应发送回页面,其中可能包含其他个性化的配置文件值。 当前页面上的个性化内容会在默认内容不发生闪烁的情况下尽快显示。 b.单页应用程序(SPA)中作为用户操作结果显示的视图的个性化内容会被缓存,这样在触发视图时,便可以立即应用该内容,而无需额外的服务器调用。 c.边缘网络发送访客ID以及Cookie中的其他值,例如同意、会话ID、身份、Cookie检查、个性化等。 |
7 | 边缘网络转发 Analytics for Target (A4T)详细信息(活动、体验和转化元数据) Analytics 边缘。 |
启用 Target,请执行以下操作:
renderDecisions
选项。然后,您也可以选择添加以下选项:
decisionScopes
:通过向事件添加此选项来检索特定活动(对于通过基于表单的编辑器创建的活动非常有用)。要将VEC与 Platform Web SDK 实施、安装和激活 Firefox 或 铬黄 VEC助手扩展。
有关更多信息,请参阅 可视化体验编辑器助手扩展 在 Adobe Target指南.
请参阅 呈现个性化内容 以了解更多信息。
在为 Target 通过 Platform Web SDK, XDM 必须定义和使用。 在定义XDM架构、类和架构字段组后,您可以创建 Target 由XDM数据定义的用于定位的受众规则。 在 Target,则XDM数据会显示在 Audience Builder 作为自定义参数。 XDM使用点表示法进行序列化(例如, web.webPageDetails.name
)。
如果 Target 具有使用自定义参数或用户配置文件的预定义受众的活动,无法通过SDK正确交付这些活动。 您必须改用XDM,而不是使用自定义参数或用户配置文件。 但是,通过 Platform Web SDK 不需要XDM的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
with renderAttempted
标志设置为 false
renderAttempted
标志设置为 true
renderAttempted
标志设置为 true
renderAttempted
标志设置为 true
禁用自动渲染时,命题数组包含:
propositions
with renderAttempted
标志设置为 false
renderAttempted
标志设置为 false
renderAttempted
标志设置为 false
renderAttempted
标志设置为 false
的 Platform Web SDK 允许您将用户档案更新为 Target 和 Platform Web SDK 作为体验事件。
要更新 Target 配置文件,请确保配置文件数据与以下内容一起传递:
“data {“
“__adobe.target”
“profile.”
例如,如下所示键 | 类型 | 描述 |
---|---|---|
renderDecisions |
布尔型 | 指示个性化组件是否应解释DOM操作 |
decisionScopes |
数组 <String> |
要检索决策的范围列表 |
xdm |
对象 | 在XDM中格式化的数据,这些数据会作为体验事件进入Platform Web SDK中 |
data |
对象 | 发送到的任意键/值对 Target 解决方案。 |
典型 Platform 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 属性以及是否通过 Platform 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已被弃用。 使用 Platform Web SDK 调试.
建议: 在 Target,则命题会将与从活动中选择的体验相关联。
架构: 决策的架构是 Target.
范围: 决定的范围。 在 Target,范围为mBox。 全局mBox是 __view__
范围。
XDM: XDM将序列化为点符号,然后放入 Target 作为mBox参数。