配置搜索分析

启用 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 事件与同一次搜索关联。

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