配置搜索分析

启用 Meilisearch Cloud 分析，以帮助您了解用户在您的应用程序中如何搜索。

本指南将引导您完成激活分析、更新项目 URL 和配置所有数据点的过程。

您必须拥有 Meilisearch Cloud 帐户才能访问搜索分析。

登录您的 Meilisearch Cloud 帐户并导航到您的项目概览。找到“分析和监控”部分，然后单击“启用分析和监控”按钮

Meilisearch Cloud 将开始处理您的请求。“分析和监控”部分将在启用该功能后更新。

当您启用分析时，Meilisearch Cloud 会更改您的项目的 API URL。Meilisearch Cloud 只能跟踪发送到此 URL 的查询的指标。

更新您的应用程序，以便所有 API 请求都指向新的 URL

curl \
  -X POST 'https://edge.meilisearch.com/indexes/products/search' \
  -H 'Content-Type: application/json' \
  --data-binary '{ "q": "green socks" }'

之前的 API URL 仍然可用，但以它为目标的请求不会向分析界面发送任何数据。如果您使用之前的 URL 创建了任何自定义 API 密钥，您将需要替换它们。

为了跟踪点击率和平均点击位置等指标，Meilisearch Cloud 需要知道用户何时点击搜索结果。

每次用户点击搜索结果时，您的应用程序都必须向 Meilisearch Cloud 分析路由的 POST 端点发送一个 click 事件

curl \
  -X POST 'https://edge.meilisearch.com/events' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer DEFAULT_SEARCH_API_KEY' \
  --data-binary '{
    "eventType": "click",
    "eventName": "Search Result Clicked",
    "indexUid": "products",
    "objectId": "0",
    "position": 0
  }'

默认情况下，Meilisearch 将分析事件与触发它们的用户最近的搜索关联。

有关更多信息，请参阅 分析事件端点参考。

要跟踪转化率，首先要确定在您的应用程序中什么应该算作转化。例如，在网上商店中，转化可能是用户完成结账过程。

一旦您确定了在您的应用程序中什么算作转化，请将其配置为向 Meilisearch Cloud 分析路由的 POST 端点发送一个 conversion 事件

curl \
  -X POST 'https://edge.meilisearch.com/events' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer DEFAULT_SEARCH_API_KEY'
  --data-binary '{
    "eventType": "conversion",
    "eventName": "Product Added To Cart",
    "indexUid": "products",
    "objectId": "0",
    "position": 0
  }'

默认情况下，Meilisearch 将分析事件与触发它们的用户最近的搜索关联。

不可能将多个 conversion 事件与同一次搜索关联。

有关更多信息，请参阅 分析事件端点参考。