初始化SDK
请按照 初始化SDK 图中的步骤进行操作,以确保以正确的顺序执行加载Adobe Target at.js JavaScript库所需的所有必要任务。
初始化SDK图 diagram
对于多页面应用程序,每当页面重新加载或访客导航到网站上的新页面时,就会出现此流程。
{width="600" modal="regular"}
单击以下链接以导航到所需的部分:
1.1:加载访客API SDK load
此步骤有助于确保正确加载、配置和初始化VisitorAPI.js
库。
{width="400" modal="regular"}
先决条件
- 若要使用访客ID/API服务,贵公司必须启用Adobe Experience Cloud并拥有Organization ID。 有关详细信息,请参阅 Identity Service帮助 指南中的Experience Cloud要求:。
- 您需要
VisitorAPI.js
文件。 如果您实施了Adobe Analytics,则应该已经拥有此文件。 此文件也可以通过Adobe Experience Platform 标记扩展添加,也可以从Adobe Analytics代码管理器下载。
配置并引用VisitorAPI.js
有关详细信息,请参阅为Target实施Experience Cloud服务。
读数
- Experience Cloud标识服务概述
- 关于ID服务
- Cookie和Experience Cloud标识服务
- Experience CloudIdentity服务如何请求和设置ID
- 了解ID同步和匹配率
操作
1.2:设置客户Id set
此步骤可帮助确保将访客的已知ID(CRM ID、用户ID等)与Adobe的匿名ID关联以进行跨设备个性化。
{width="400" modal="regular"}
先决条件
- 访客的已知ID应该可以在Data Layer中使用。
设置客户ID
有关详细信息,请参阅setCustomerIDs。
读数
- mbox3rdPartyId的实时配置文件同步
操作
- 使用
visitor.setCustomerIDs
设置访客已知ID。
1.3:配置自动页面加载请求 automatic
此步骤使at.js能够获取在加载at.js JavaScript库文件时必须在页面上渲染的所有体验。
{width="400" modal="regular"}
先决条件
- 并非数据层中的所有数据都必须发送到Target。 请咨询您的业务团队(数字营销团队),确定哪些数据对于实验、优化和个性化很有价值。 仅此数据应发送到Target。
- 确保您不会向Target发送任何个人身份信息(PII)数据。
配置自动页面加载请求
有关更多信息,请参阅 targetGlobalSettings()。
读数
了解targetGlobalSettings()中的pageLoadEnabled
设置。
操作
- 修改
window.targetGlobalSettings
对象以启用自动页面加载请求。
1.4:配置闪烁处理 flicker
此步骤有助于确保在交付体验时不会出现页面闪烁。
{width="400" modal="regular"}
先决条件
- 与负责网页性能的团队讨论使用at.js使用的默认方法控制闪烁的利弊。 您可以搜索设计模式,以便使用自定义闪烁处理解决方案,如加载器动画。 如果找不到模式,则可以请求一个新模式。
配置闪烁处理
有关更多信息,请参阅 targetGlobalSettings()。
将bodyHidingEnabled
设置为true
会在页面加载请求正在进行时隐藏整个页面主体。 如果您出于任何原因(例如,稍后数据尚未准备就绪)未启用自动页面加载请求,则最好将此设置设置为false
。
如果您禁用了bodyHidingEnabled
,因为您不希望触发APLR并且希望稍后触发页面请求,或者您不需要处理闪烁,则必须实施自己的闪烁处理。 您可以通过两种方式处理闪烁:隐藏受测试区域,或在受测试区域上显示引发器。
读数
- at.js 如何管理闪烁
- 了解targetGlobalSettings()中的bodyHiddenStyle和bodyHidingEnabled对象。
操作
- 修改
window.targetGlobalSettings
对象以设置bodyHiddenStyle
和bodyHidingEnabled
。
1.5:配置数据映射 data-mapping
此步骤有助于确保设置必须发送到Target的所有数据。
{width="400" modal="regular"}
先决条件
-
数据层应准备好必须发送给Target的所有数据。
-
Recommendations:扩充用户档案。
- 传递
entity.id
以根据基于上次查看产品的条件捕获最近查看的条件和项的数据。 - 传递
entity.id
以根据最喜爱的类别捕获热门程度标准的数据。 - 如果自定义标准基于配置文件属性,或者在任何标准的包含规则筛选中使用配置文件属性,请传递该属性。
- 传递
-
Recommendations:摄取产品数据。
- 可以传递其他实体参数(保留和自定义)以摄取或更新Recommendations中的产品目录。
- 还可以使用Target UI或API使用实体源更新产品目录。
将数据映射到Target
有关详细信息,请参阅targetPageParams()。
读数
操作
- 使用
targetPageParams()
函数设置必须发送到Target的所有必需数据。
1.6:促销活动 promotion
添加促销项目并控制它们在您的Target Recommendations 设计中的位置。
1.7:基于购物车的标准 cart
根据用户的购物车内容提供推荐。
可用标准
- People Who Viewed These, Viewed Those
- People Who Viewed These, Bought Those
- People Who Bought These, Bought Those
需要实体参数
- cartIds
读数
1.8:基于热门程度的标准 popularity
根据项目在整个网站中的整体受欢迎程度或用户最喜爱或查看次数最多的类别、品牌、流派等中的项目受欢迎程度提供推荐。
可用标准
- Most Viewed Across the Site
- Most Viewed by Category
- Most Viewed by Item Attribute
- Top Sellers Across the Site
- Top Sellers by Category
- Top Sellers by Item Attribute
- Top by Analytics Metric
需要实体参数
entity.categoryId
或基于热门程度的项目属性(如果标准基于当前项目或项目属性)。- 对于网站中的“查看次数最多”/“销售最高”页面,无需传递任何内容。
读数
1.9:基于项目的标准 item
根据查找的用户正在查看或最近查看过的项目的相似项目提供推荐。
可用标准
- People Who Viewed This, Viewed That
- People Who Viewed This, Bought That
- People Who Bought This, Bought That
- Items with Similar Attributes
需要实体参数
entity.id
或任何用作键的配置文件属性
读数
- 基于项
1.10:基于用户的标准 user
根据用户的行为提供推荐。
1.11:自定义标准 custom
根据您上传的自定义文件提出推荐。
1.12:提供包含规则中使用的属性 inclusion
读数
1.13:提供excludedIds exclude
传递要从推荐中排除的实体ID。 例如,可排除购物车中已有的商品。
读数
1.14:传递entity.event.detailsOnly=true
参数 true
使用实体属性将产品或内容信息传递到Target Recommendations。
读数
1.15:配置远程数据映射(远程)
此步骤可确保设置必须发送到Target的所有数据。
{width="400" modal="regular"}
先决条件
- 数据层应准备好所有必须发送到Target的数据。
设置数据提供程序
有关详细信息,请参阅数据提供程序。
读数
操作
使用targetPageParams()
函数设置必须发送到Target的所有必需数据。
1.16:加载at.js web
此步骤可确保加载并初始化at.js JavaScript库。
{width="400" modal="regular"}
先决条件
- 下载或请求您的数字营销团队获取
at.js 2.*x*
JavaScript库文件。
读数
操作
在必须进行试验、优化、个性化和数据收集的所有网页上嵌入at.js文件。
继续执行步骤2:配置数据收集。