用于at.js的On-device decisioning

从版本2.5.0开始,at.js提供on-device decisioning。 On-device decisioning允许您在浏览器上缓存A/B测试体验定位 (XT)活动以执行内存中决策,而不会向Adobe TargetEdge Network发送阻止网络请求。

NOTE
On-device decisioning可用于客户端和服务器端实施。 本文介绍了客户端的on-device decisioning。 有关服务器端的on-device decisioning的信息,请参阅服务器端实施文档此处

Target还可以通过实时服务器调用,灵活地从您的实验和机器学习驱动的(ML驱动的)个性化活动中提供最相关和最新的体验。 换句话说,当性能最重要时,您可以选择使用on-device decisioning。 但是,当需要最相关、最新且ML驱动的体验时,可以改为进行服务器调用。

on-device decisioning有哪些好处?

on-device decisioning的优点包括:

  • 提供超快的决策和体验。 ​在内存中和浏览器上执行分段和决策,以避免阻止网络请求。
  • 增强应用程序性能。 ​在不影响最终用户体验的情况下运行实验并向您的客户和用户提供个性化。
  • 提高Google网站质量分数。 ​由于决策在内存中进行,请提高您在线业务的Google网站质量分数,以使消费者更容易发现它。
  • 从实时分析中学习。 ​通过Analytics for Target (A4T)报表实时了解您的活动表现。 A4T允许您在关键时刻调整策略。

受支持的功能

Adobe Target JS SDK使客户能够灵活地选择数据的性能和新鲜度以供决策。 换言之,如果通过机器学习提供最相关且最引人入胜的个性化内容对您来说最重要,则应进行实时服务器调用。 但是,当性能更加关键时,应该做出设备上决策和内存决策。 要使on-device decisioning正常工作,请参阅支持的功能列表:

  • 活动类型
  • 受众定位
  • 分配方法

有关详细信息,请参阅on-device decisioning🔗的支持的功能。

on-device decisioning的工作原理是什么?

在启用on-device decisioning的情况下部署和初始化at.js时,将从最接近访客的Akamai CDN下载并缓存访客浏览器本地的一个规则工件,其中包含用于A/B和XT活动、受众及资产的on-device decisioning。 当从at.js发出检索体验的请求时,将根据在缓存的规则工件中编码的元数据,在内存中做出有关返回哪个体验的决策。

决策方法

通过on-device decisioning,Target引入了一个名为“决策方法”的新设置。 决策方法设置指示at.js如何交付您的体验。 决策方法具有三个值:

  • 仅服务器端
  • 仅限设备端
  • 混合

仅服务器端

仅服务器端是在您的Web资产上实施和部署at.js 2.5.0及更高版本时开箱即用的默认决策方法。

仅将服务器端用作默认配置意味着在Target边缘网络上做出所有决策,其中涉及阻止服务器调用。 此方法可能会引入增量延迟,但它还提供了显着的优势,例如让您能够应用Target的机器学习功能,包括RecommendationsAutomated Personalization (AP)和自动定位活动。

此外,通过使用Target的用户配置文件(跨会话和渠道保留)增强您的个性化体验,可为您的业务带来强大的成果。

最后,服务器端仅允许您使用Adobe Experience Cloud并微调可通过Audience Manager和Adobe Analytics区段定位的受众。

下图说明了您的访客、浏览器、at.js 2.5.0+和Adobe Target Edge网络之间的交互情况。 此流程图会捕获新访客和回访访客。

(单击图像可展开至全宽。)

仅服务器端流程图 {modal="regular"}

以下列表对应于图中的数字:

步骤
描述
1
Adobe Experience Cloud Identity Service检索Experience Cloud访客ID。
2
at.js 库会同步加载,并隐藏文档正文。
也可以选择在页面上实施预先隐藏的代码片段,以异步方式加载at.js库。
3
at.js库会隐藏正文以防止闪烁。
4
将会发出页面加载请求,其中包括已配置的所有参数,例如(ECID、客户ID、自定义参数、用户配置文件等)。
5
配置文件脚本在执行后进入配置文件存储区。
配置文件存储区从受众库请求符合条件的受众(例如,从Adobe Analytics、Adobe Audience Manager等共享的受众)。
客户属性会以批量过程发送到配置文件存储区。
6
配置文件存储区用于受众资格和分段以筛选活动。
7
在从实时Target活动中确定体验后,将选择生成的内容。
8
at.js库会隐藏页面上与必须呈现的体验关联的相应元素。
9
at.js库会显示主体,以便可以加载页面的其余部分以供访客查看。
10
at.js库操作DOM以呈现来自TargetEdge Network的体验。
11
体验会呈现给访客。
12
加载整个网页。
13
Analytics 数据会发送到数据收集服务器。
14
目标数据会通过SDID匹配到Analytics数据,并且会进行相应处理以保存到Analytics报表存储中。 然后,便可以在Analytics和Target中通过Analytics for Target (A4T)报表查看Analytics数据。

仅限设备端

“仅限设备端”是必须在at.js 2.5.0及更高版本中设置的决策方法,当时on-device decisioning只应在您的网页中使用。

On-device decisioning能够以惊人的速度交付您的体验和个性化活动,因为决策是从包含您所有符合on-device decisioning条件的活动的缓存规则工件做出的。

要了解有关哪些活动符合on-device decisioning条件的更多信息,请参阅on-device decisioning🔗中的支持的功能。

仅当在所有需要Target决策的页面上的性能都非常关键时,才应使用此决策方法。 此外,请记住,选择此决策方法时,将不会交付或执行您不符合on-device decisioning条件的Target活动。 at.js库2.5.0及更高版本配置为仅查找缓存的规则工件以做出决策。

下图说明了您的访客、浏览器、at.js 2.5.0+和Akamai CDN之间的交互。 Akamai CDN将在访客首次访问时缓存规则构件。 对于新访客进行的首次页面访问,必须从Akamai CDN下载JSON规则构件,才能在访客的浏览器中缓存到本地。 下载JSON规则工件后,将立即做出决策,而无需阻止网络调用。 以下流程图可捕获新访客。

(单击图像可展开至全宽。)

仅限设备上的流程图 {modal="regular"}

以下列表对应于图中的数字:

NOTE
Adobe Target管理员服务器使所有符合on-device decisioning条件的活动符合条件,生成JSON规则工件并将其传播到Akamai CDN。 系统持续监控您的活动是否有更新,以输出新的JSON规则工件并传播到Akamai CDN。
步骤
描述
1
Adobe Experience Cloud Identity Service检索Experience Cloud访客ID。
2
at.js 库会同步加载,并隐藏文档正文。
也可以使用页面上实施的可选预隐藏代码片段异步加载at.js库。
3
at.js库会隐藏正文以防止闪烁。
4
at.js库会发出请求,请求从距离访客最近的Akamai CDN检索JSON规则构件。
5
Akamai CDN使用JSON规则工件进行响应。
6
JSON规则工件会缓存在访客浏览器的本地。
7
at.js库解释JSON规则构件并执行决策以检索体验并隐藏测试的元素。
8
at.js库会显示主体,以便可以加载页面的其余部分以供访客查看。
9
at.js库会操作DOM以呈现缓存的JSON规则工件中的体验。
10
体验会呈现给访客。
11
加载整个网页。
12
Analytics数据会发送到数据收集服务器。 目标数据会通过SDID匹配到Analytics数据,并且会进行相应处理以保存到Analytics报表存储中。 然后,便可以在Analytics和Target中通过Analytics for Target (A4T)报表查看Analytics数据。

下图说明了访客、浏览器at.js 2.5.0及更高版本与缓存的JSON规则工件之间的交互,这些工件用于访客的后续页面点击或回访。 由于JSON规则工件已缓存并在浏览器中可用,因此会立即做出决策,而无需阻止网络调用。 此流程图会捕获后续页面导航或回访访客。

(单击图像可展开至全宽。)

用于后续页面导航和重复访问的仅设备端流程图 {modal="regular"}

以下列表对应于图中的数字:

NOTE
Adobe Target管理员服务器使所有符合on-device decisioning条件的活动符合条件,生成JSON规则工件并将其传播到Akamai CDN。 系统持续监控您的活动是否有更新,以输出新的JSON规则工件并传播到Akamai CDN。
步骤
描述
1
Adobe Experience Cloud Identity Service检索Experience Cloud访客ID。
2
at.js 库会同步加载,并隐藏文档正文。
也可以使用页面上实施的可选预隐藏代码片段异步加载at.js库。
3
at.js库会隐藏正文以防止闪烁。
4
at.js库解释JSON规则工件并在内存中执行决策以检索体验。
5
已测试的元素被隐藏。
6
at.js库会显示主体,以便可以加载页面的其余部分以供访客查看。
7
at.js库会操作DOM以呈现缓存的JSON规则工件中的体验。
8
体验会呈现给访客。
9
加载整个网页。
10
Analytics数据会发送到数据收集服务器。 目标数据会通过SDID匹配到Analytics数据,并且会进行相应处理以保存到Analytics报表存储中。 然后,便可以在Analytics和Target中通过Analytics for Target (A4T)报表查看Analytics数据。

混合

混合决策方法是必须在at.js 2.5.0及更高版本中设置的决策方法,当时on-device decisioning和需要对Adobe Target Edge网络进行网络调用的活动都必须执行。

当您同时管理on-device decisioning活动和服务器端活动时,考虑如何在您的页面上部署和预配Target时,可能会有点复杂和繁琐。 使用混合决策方法,Target知道何时必须对Adobe Target Edge网络进行服务器调用以执行需要服务器端执行的活动,以及何时仅执行设备上决策。

JSON规则工件包含元数据,用于通知at.js mbox是正在运行的服务器端活动还是on-device decisioning活动。 此决策方法可确保通过on-device decisioning快速完成您想要交付的活动,对于需要更强大的ML驱动型个性化的活动,这些活动将通过Adobe Target Edge网络完成。

下图说明了您的访客、浏览器、at.js 2.5.0及更高版本、Akamai CDN以及首次访问您页面的新访客的Adobe TargetEdge Network之间的交互。 此图的要点是,在通过Adobe Target Edge网络做出决策时,将异步下载JSON规则构件。

此方法可确保包含许多活动的工件大小不会对决策的延迟产生负面影响。 同步下载JSON规则工件并在此后进行决策也会对延迟产生不利影响,并且可能不一致。 因此,混合决策方法是一种最佳实践建议,始终为新访客决策进行服务器端调用,并且并行缓存JSON规则构件。 对于任何后续页面访问和回访,将通过JSON规则工件从缓存和内存中做出决策。

(单击图像可展开至全宽。)

首次访客的混合流程图 {modal="regular"}

以下列表对应于图中的数字:

NOTE
Adobe Target管理员服务器使所有符合on-device decisioning条件的活动符合条件,生成JSON规则工件并将其传播到Akamai CDN。 系统持续监控您的活动是否有更新,以输出新的JSON规则工件并传播到Akamai CDN。
步骤
描述
1
Adobe Experience Cloud Identity Service检索Experience Cloud访客ID。
2
at.js 库会同步加载,并隐藏文档正文。
也可以使用页面上实施的可选预隐藏代码片段异步加载at.js库。
3
at.js库会隐藏正文以防止闪烁。
4
向Adobe TargetEdge Network发出页面加载请求,其中包括已配置的所有参数,例如(ECID、客户ID、自定义参数、用户配置文件等)。
5
同时,at.js会发出请求,请求从最接近访客的Akamai CDN检索JSON规则构件。
6
(Adobe Target个Edge Network)配置文件脚本在执行后进入配置文件存储区。 配置文件存储区从受众库请求符合条件的受众(例如,从Adobe Analytics、Adobe Audience Manager等共享的受众)。
7
Akamai CDN使用JSON规则工件进行响应。
8
配置文件存储区用于受众资格和分段以筛选活动。
9
在从实时Target活动中确定体验后,将选择生成的内容。
10
at.js库会隐藏页面上与必须呈现的体验关联的相应元素。
11
at.js库会显示主体,以便可以加载页面的其余部分以供访客查看。
12
at.js库操作DOM以呈现来自TargetEdge Network的体验。
13
体验会呈现给访客。
14
加载整个网页。
15
Analytics数据会发送到数据收集服务器。 目标数据会通过SDID匹配到Analytics数据,并且会进行相应处理以保存到Analytics报表存储中。 然后,便可以在Analytics和Target中通过Analytics for Target (A4T)报表查看Analytics数据。

下图说明了访客、浏览器、at.js 2.5.0及更高版本和缓存的JSON规则工件之间的交互,这些工件用于后续页面导航或回访。 在此图表中,仅重点介绍为后续页面导航或回访作出设备上决策的用例。 请记住,根据某些页面中活跃的活动,可以进行服务器端调用以执行服务器端决策。

(单击图像可展开至全宽。)

用于后续页面导航和重复访问的混合流程图 {modal="regular"}

以下列表对应于图中的数字:

NOTE
Adobe Target管理员服务器使所有符合on-device decisioning条件的活动符合条件,生成JSON规则工件并将其传播到Akamai CDN。 系统持续监控您的活动是否有更新,以输出新的JSON规则工件并传播到Akamai CDN。
步骤
描述
1
Adobe Experience Cloud Identity Service检索Experience Cloud访客ID。
2
at.js 库会同步加载,并隐藏文档正文。
也可以使用页面上实施的可选预隐藏代码片段异步加载at.js库。
3
at.js库会隐藏正文以防止闪烁。
4
系统会提出检索体验的请求。
5
at.js库确认JSON规则工件已缓存,并在内存中执行决策以检索体验。
6
已测试的元素被隐藏。
7
at.js库会显示主体,以便可以加载页面的其余部分以供访客查看。
8
at.js库会操作DOM以呈现缓存的JSON规则工件中的体验。
9
体验会呈现给访客。
10
加载整个网页。
11
Analytics数据会发送到数据收集服务器。 目标数据会通过SDID匹配到Analytics数据,并且会进行相应处理以保存到Analytics报表存储中。 然后,便可以在Analytics和Target中通过Analytics for Target (A4T)报表查看Analytics数据。

如何启用on-device decisioning?

On-device decisioning适用于使用At.js 2.5.0及更高版本的所有Target客户。

要启用on-device decisioning:

NOTE
您必须具有管理员或审批者用户角色才能启用或禁用“设备端决策”切换开关。
  1. 单击​ Administration > Implementation > Account details

  2. 在​ Account details ​下,将​ On-Device Decisioning ​切换开关滑动到“开”位置。

    On-device decisioning切换

    如果启用了on-device decisioning,则会显示“将所有现有的on-device decisioning合格活动包含在项目中”选项。

  3. (视情况而定)如果您希望所有符合on-device decisioning条件的实时Target活动自动包含在项目中,请将切换开关滑动到“开”位置。

    将此切换保留为关闭表示您必须重新创建和激活任何on-device decisioning活动,才能将其包含在生成的规则工件中。 换言之,在打开设备上决策切换开关之前处于实时状态的任何活动均不包含在规则工件中。

启用“设备端决策”切换后,Target开始为您的客户端生成和传播规则工件

WARNING
在初始化Adobe Target SDK以使用on-device decisioning之前,请确保启用此切换功能。 规则工件首先需要生成并传播到Akamai CDN才能使on-device decisioning正常工作。 第一个规则工件生成并传播到Akamai CDN可能需要五到十分钟。

如何配置at.js 2.5.0及更高版本以使用on-device decisioning?

  1. 单击​ Administration > Implementation > Account details

  2. 在​ Implementation Methods > Main Implementation Method ​下,单击您的at.js版本(必须是at.js 2.5.0或更高版本)旁边的​ Edit

    编辑主要实施方法设置

    note warning
    WARNING
    在更改这些默认设置之前,请咨询客户关怀团队,以避免影响您当前的实施。
  3. 选择所需的决策方法:

    • 仅服务器端
    • 仅限设备端
    • 混合

    编辑at.js设置面板

全局设置

您可以为所有Target决策配置默认决策方法。 各种决策方法是仅服务器端、仅设备上和混合。 在Target UI中选择的决策方法在decisioningMethod字段下的window.targetGlobalSettings中配置。 在targetGlobalSettings()中了解有关decisioningMethod的更多信息。

<head>
    <script type="text/javascript">

        window.targetGlobalSettings = {
            clientCode: "yourClientCodeHere",
            imsOrgId: "imsOrgId@AdobeOrg",
            decisioningMethod: "on-device"

        };
    </script>

    <script type="text/javascript" src="at.js"></script>
</head>

自定义设置

如果您在window.targetGlobalSettings中设置了decisioningMethod,但想要根据用例覆盖每个Adobe Target决策的decisioningMethod,则可以通过在At.js2.5.0+的getOffers()调用中指定decisioningMethod来执行此过程。

adobe.target.getOffers({

  decisioningMethod:"on-device",
  request: {
    execute: {
      mboxes: [
        {
          index: 0,
          name: "homepage"
        }
      ]
    }
 }
});
NOTE
要在getOffers()调用中将“设备上”或“混合”用作决策方法,请确保全局设置将decisioningMethod设置为“设备上”或“混合”。 at.js库2.5.0及更高版本必须知道是否在页面上加载后立即下载和缓存JSON规则构件。 如果将全局设置的决策方法设置为“服务器端”,并且将“设备上”或“混合”决策方法传递到getOffers()调用中,则at.js 2.5.0及更高版本将不会缓存JSON规则工件以执行您的设备上决策。

工件缓存TTL

Target表示您的活动符合on-device decisioning作为包含元数据、规则和条件的对象的条件。 此工件将缓存在Akamai CDN上。 在用户首次访问期间,用户的浏览器将下载并缓存表示您的on-device decisioning活动的工件。

在后续访问您的网站时,浏览器会自动检查它是否必须下载新版本的工件。 这项检查会增加延迟。 工件缓存TTL定义自上次成功下载以来,您不希望浏览器检查更新的工件的分钟数。 时间范围越长,性能越好。 时间范围越短,数据新鲜度越好,但代价是增加了延迟。

我如何知道某个活动符合on-device decisioning条件?

创建符合on-device decisioning条件的活动后,活动的“概述”页面中将显示一个标记为“符合设备上决策”的标签。

活动概述页面上的 设备上决策合格标签。

此标签并不意味着该活动将始终通过on-device decisioning交付。 仅当at.js 2.5.0及更高版本配置为使用on-device decisioning时,此活动才会在设备上执行。 如果at.js 2.5.0及更高版本未配置为使用设备端,则此活动仍将通过从at.js发出的服务器调用进行交付。

您可以通过“符合设备端决策”筛选条件,筛选在“活动”页面上符合on-device decisioning资格的所有活动。

符合设备端决策条件的活动页面筛选器。

NOTE
创建和激活符合on-device decisioning条件的活动后,可能需要五到十分钟才能将其包含在生成并传播到Akamai CDN存在点的规则工件中。

确保通过At.js 2.5.0交付我的on-device decisioning活动的步骤摘要+?

  1. 访问Adobe Target UI并导航到​ Administration > Implementation > Account Details ​以启用​ On-Device Decisioning ​切换。

  2. 启用​ "Include all existing on-device decisioning qualified activities in the artifact" ​切换。

    首个JSON规则工件生成操作最多可能需要10分钟。

  3. 创建并激活on-device decisioning🔗支持的活动类型,并验证它是否符合on-device decisioning条件。

  4. 通过at.js设置UI将​ Decisioning Method ​设置为​ "Hybrid" ​或​ "On-device only"

  5. 下载At.js 2.5.0及更高版本并将其部署到您的页面。

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