文档Target开发人员指南

初始化SDK

最近更新： 2024年7月20日
  • 主题：
  • APIs/SDKs

创建对象：

  • 有经验的
  • 开发人员

请按照​ 初始化SDK ​图中的步骤进行操作，以确保以正确的顺序执行加载Adobe Target at.js JavaScript库所需的所有必要任务。

TIP
单击本主题中的图像以展开到全屏。

初始化SDK图

对于多页面应用程序，每当页面重新加载或访客导航到网站上的新页面时，就会出现此流程。

NOTE
下图中的步骤编号与以下部分相对应。 步骤编号没有特定顺序，也不反映创建活动时在Target UI中执行的步骤顺序。

初始化SDK关系图

单击以下链接以导航到所需的部分：

  • 1.1：加载访客API SDK
  • 1.2：设置客户Id
  • 1.3：配置自动页面加载请求
  • 1.4：配置闪烁处理
  • 1.5：配置数据映射
  • 1.6：促销活动
  • 1.7：基于购物车的标准
  • 1.8：基于热门程度的标准
  • 1.9：基于项目的标准
  • 1.10：基于用户的标准
  • 1.11：自定义标准
  • 1.12：提供包含规则中使用的属性
  • 1.13：提供excludedIds
  • 1.14：传递entity.event.detailsOnly=true参数
  • 1.15：配置远程数据映射
  • 1.16：加载at.js

1.1：加载访客API SDK

此步骤有助于确保正确加载、配置和初始化VisitorAPI.js库。

查看详细信息

加载访客API SDK关系图

先决条件

  • 若要使用访客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同步和匹配率

操作

  • 在网页上嵌入VisitorAPI.js文件。
  • 了解访客ID/API服务🔗的可用配置。
  • 加载VisitorAPI.js文件后，使用Visitor.getInstance方法以您需要的必要配置进行初始化。
  • 熟悉可用方法。

返回此页面顶部的图表。

1.2：设置客户Id

此步骤可帮助确保将访客的已知ID（CRM ID、用户ID等）与Adobe的匿名ID关联以进行跨设备个性化。

查看详细信息

设置客户ID

先决条件

  • 访客的已知ID应该可以在Data Layer中使用。

设置客户ID
有关详细信息，请参阅setCustomerIDs。

读数

  • mbox3rdPartyId的实时配置文件同步

操作

  • 使用visitor.setCustomerIDs设置访客已知ID。

返回此页面顶部的图表。

1.3：配置自动页面加载请求

此步骤使at.js能够获取在加载at.js JavaScript库文件时必须在页面上渲染的所有体验。

查看详细信息

配置自动页面加载请求

先决条件

  • 并非数据层中的所有数据都必须发送到Target。 请咨询您的业务团队（数字营销团队），确定哪些数据对于实验、优化和个性化很有价值。 仅此数据应发送到Target。
  • 确保您不会向Target发送任何个人身份信息(PII)数据。

配置自动页面加载请求

有关更多信息，请参阅 targetGlobalSettings()。

读数

了解targetGlobalSettings()中的pageLoadEnabled设置。

操作

  • 修改window.targetGlobalSettings对象以启用自动页面加载请求。

返回此页面顶部的图表。

1.4：配置闪烁处理

此步骤有助于确保在交付体验时不会出现页面闪烁。

查看详细信息

配置闪烁处理图

先决条件

  • 与负责网页性能的团队讨论使用at.js使用的默认方法控制闪烁的利弊。 您可以搜索设计模式，以便使用自定义闪烁处理解决方案，如加载器动画。 如果找不到模式，则可以请求一个新模式。

配置闪烁处理

有关更多信息，请参阅 targetGlobalSettings()。

将bodyHidingEnabled设置为true会在页面加载请求正在进行时隐藏整个页面主体。 如果您出于任何原因（例如，稍后数据尚未准备就绪）未启用自动页面加载请求，则最好将此设置设置为false。

如果您禁用了bodyHidingEnabled，因为您不希望触发APLR并且希望稍后触发页面请求，或者您不需要处理闪烁，则必须实施自己的闪烁处理。 您可以通过两种方式处理闪烁：隐藏受测试区域，或在受测试区域上显示引发器。

读数

  • at.js 如何管理闪烁
  • 了解targetGlobalSettings()中的bodyHiddenStyle和bodyHidingEnabled对象。

操作

  • 修改window.targetGlobalSettings对象以设置bodyHiddenStyle和bodyHidingEnabled。

返回此页面顶部的图表。

1.5：配置数据映射

此步骤有助于确保设置必须发送到Target的所有数据。

查看详细信息

数据映射关系图

先决条件

  • 数据层应准备好必须发送给Target的所有数据。

  • Recommendations：扩充用户档案。

    • 传递entity.id以根据基于上次查看产品的条件捕获最近查看的条件和项的数据。
    • 传递entity.id以根据最喜爱的类别捕获热门程度标准的数据。
    • 如果自定义标准基于配置文件属性，或者在任何标准的包含规则筛选中使用配置文件属性，请传递该属性。

  • Recommendations：摄取产品数据。

    • 可以传递其他实体参数（保留和自定义）以摄取或更新Recommendations中的产品目录。
    • 还可以使用Target UI或API使用实体源更新产品目录。

将数据映射到Target

有关详细信息，请参阅targetPageParams()。

读数

  • targetPageParams()
  • 计划和实施推荐
  • 设置您的Recommendations目录

操作

  • 使用targetPageParams()函数设置必须发送到Target的所有必需数据。

返回此页面顶部的图表。

1.6：促销活动

添加促销项目并控制它们在您的Target Recommendations 设计中的位置。

查看详细信息

可用选项

  • 按ID提升
  • 按收藏集促销
  • 按属性促销

需要实体参数

  • 使用“按属性促销”选项时，必须传递促销中的项目属性。

返回此页面顶部的图表。

1.7：基于购物车的标准

根据用户的购物车内容提供推荐。

查看详细信息

可用标准

  • People Who Viewed These, Viewed Those
  • People Who Viewed These, Bought Those
  • People Who Bought These, Bought Those

需要实体参数

  • cartIds

读数

  • 基于购物车

返回此页面顶部的图表。

1.8：基于热门程度的标准

根据项目在整个网站中的整体受欢迎程度或用户最喜爱或查看次数最多的类别、品牌、流派等中的项目受欢迎程度提供推荐。

查看详细信息

可用标准

  • 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：基于项目的标准

根据查找的用户正在查看或最近查看过的项目的相似项目提供推荐。

查看详细信息

可用标准

  • 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：基于用户的标准

根据用户的行为提供推荐。

查看详细信息

可用标准

  • Recently Viewed Items
  • Recommended for You

需要实体参数

  • entity.id

读数

  • 基于用户

返回此页面顶部的图表。

1.11：自定义标准

根据您上传的自定义文件提出推荐。

查看详细信息

可用标准

  • Custom algorithm

需要实体参数

entity.id或用作自定义算法键的属性

读数

  • 自定义标准

返回此页面顶部的图表。

1.12：提供包含规则中使用的属性

查看详细信息

读数

  • 使用动态和静态包含规则

返回此页面顶部的图表。

1.13：提供excludedIds

传递要从推荐中排除的实体ID。 例如，可排除购物车中已有的商品。

查看详细信息

读数

  • 我可以动态排除实体吗？

返回此页面顶部的图表。

1.14：传递entity.event.detailsOnly=true参数

使用实体属性将产品或内容信息传递到Target Recommendations。

查看详细信息

读数

  • 实体属性

返回此页面顶部的图表。

1.15：配置远程数据映射（远程）

此步骤可确保设置必须发送到Target的所有数据。

查看详细信息

远程数据映射图

先决条件

  • 数据层应准备好所有必须发送到Target的数据。

设置数据提供程序

有关详细信息，请参阅数据提供程序。

读数

targetPageParams函数

操作

使用targetPageParams()函数设置必须发送到Target的所有必需数据。

返回此页面顶部的图表。

1.16：加载at.js

此步骤可确保加载并初始化at.js JavaScript库。

查看详细信息

加载Adobe Target at.js关系图

先决条件

  • 下载或请求您的数字营销团队获取at.js 2.*x* JavaScript库文件。

读数

  • Target的工作方式
  • at.js 的工作原理
  • 不通过标记管理器实施 Target

操作

在必须进行试验、优化、个性化和数据收集的所有网页上嵌入at.js文件。

返回此页面顶部的图表。

继续执行步骤2：配置数据收集。

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3