归因令牌

本页面介绍了如何使用归因令牌来逐步提升性能。

归因令牌是 Vertex AI Search 为零售生成的唯一 ID，随每个预测或搜索请求一起返回。它们使零售业 Vertex AI Search 能够将用户操作和结果相互关联，并训练重排名模型以提高结果质量。

将归因令牌添加到用户事件中的操作是可选的。如果您未提供归因令牌，Vertex AI Search forRetail 将根据访问者 ID 和时间戳将预测或搜索响应中的结果与提取的用户事件进行匹配，从而估算归因令牌。

归因令牌的工作原理

predict 或 search 方法返回的每个响应中都会包含一个独一无二的 attributionToken。例如：

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

如果您的网站基于 Vertex AI Search 零售中的结果展示商品，您必须在用户与返回的商品互动（例如查看或 add-to-cart 点击）时从该结果中返回归因令牌。此反馈环使 Vertex AI Search for Retail 能够提供相关信息，说明您的搜索结果对业务的影响。

如何返回归因令牌

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

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

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

当用户在推荐面板或搜索结果（生成用户事件）中与该产品互动时，系统可以从网址链接中解析归因令牌，并将其插入您针对该互动发送给 Vertex AI Search forRetail 的用户事件中。

例如，假设您请求与向用户显示商品相关的预测。适用于零售业的 Vertex AI Search 会返回一组推荐的目录 ID 以及关联的归因令牌。

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

您的网站在推荐面板中显示推荐项，并在推荐面板中为每个网址返回该预测返回的归因令牌。您应将网站配置为记录该事件，以便发送到用于零售业的 Vertex AI Search。如需查看用户事件对象的示例，请参阅搜索用户事件。当用户点击结果中的某个商品以查看更详细的视图时，您可以在该点击中记录的用户事件中包含归因令牌。用户事件类似于以下示例：

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

当用户与因推荐或搜索结果而展示的商品互动，并且您在该互动的用户事件中添加归因令牌时，Vertex AI Search for Retail 将使用该信息进行评估。

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

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