这是 Recommendations AI、Retail Search 和新的 Retail 控制台的文档。

归因令牌

本页面介绍了如何使用归因令牌随时间推移提高搜索效果。

归因令牌是由 Retail 生成并随每次搜索请求返回的唯一 ID,可让 Retail 将用户操作和搜索结果彼此相关联,并将训练搜索排名模型提高搜索质量。

将归因令牌添加到用户事件中的操作是可选的。如果您未提供归因令牌,Retail 将根据访问者 ID 和时间戳调整搜索响应和提取的用户事件中的结果,从而粗略估计归因令牌。

归因令牌的工作原理

predictsearch 方法返回的每个响应中都会包含一个独一无二的 attributionToken。例如:

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

在您的网站上会根据 Retail API 的结果显示商品时,当用户与返回的产品(例如,视图或add-to- cart点击)时,您必须返回归因令牌。此反馈环可让 Retai 提供有关结果对业务的影响的信息。

如何返回归因令牌

如需返回归因令牌,请将其添加到您为用户对推荐或搜索结果中对产品执行的任何操作而记录的用户事件中。用户对产品可以执行的操作取决于您网站的设计;常见操作包括将产品添加到收藏列表、请求详细查看、将产品添加到购物车或一键购买。

要返回归因令牌,您必须先将其与产品相关联,因为它会显示在您网站上的推荐面板或搜索结果中。一种常见的方法是将其附加到与可以在推荐面板中执行的操作相关的所有网址。例如:

https://www.example.com/54321/?rtoken=abc123

当用户在推荐面板或搜索结果(生成用户事件)中与该产品进行交互时,可以从网址链接中解析出归因令牌,并将其插入到您发送给 Retail 进行该交互的用户事件。

例如,假设您请求与向用户显示商品相关的预测。Retail 会返回一组建议的目录 ID 以及关联的归因令牌。

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

您的网站在推荐面板中显示推荐项,并在推荐面板中为每个网址返回该预测返回的归因令牌。您应将网站配置为记录该事件以发送到 Retail(请参阅用户事件以获取用户事件对象示例)。当用户点击结果中的某个产品以查看更详细的视图时,请添加归因令牌,其中包含您在该点击上记录的用户事件。用户事件类似于以下示例:

{
  "eventType" : "detail-page-view",
  "visitorId": "visitor1",
  "userInfo": {
    "userId": "user1"
   },
   "attributionToken": "abc123",
   "productDetails": [{
     "product": {
        "id": "abc"
       }
     }]
}

如果用户因为建议或搜索结果而与显示的产品交互,并且您在该交互的用户事件中添加了归因令牌,则 Retail 会使用此信息进行评估。

例如,假设用户在搜索结果中看到了某件商品,然后使用该结果将该商品添加到心愿单中,并获得商品的详细视图。您必须为从搜索结果生成的两个用户事件添加归因令牌(add-to-cartdetail-page-view)。

现在,假设同一用户通过详细视图将该产品添加到购物车中。您不需要在该操作中添加归因令牌,因为它是从详细视图(而不是搜索结果)执行的。同样,如果该用户最终购买了该产品,但不是直接从搜索结果购买,则在购买事件中返回归因令牌没有什么益处。