启用 Meilisearch Cloud 分析功能，帮助您了解用户如何在应用中执行搜索。

本指南将带您完成激活分析功能、更新项目 URL 以及配置所有数据点的完整流程。

​
前提条件

您必须拥有 Meilisearch Cloud 账户才能使用搜索分析功能。

​
在项目概览中启用分析

登录您的 Meilisearch Cloud 账户并导航至项目概览页面。找到”分析与监控”部分，点击”启用分析与监控”按钮：

Meilisearch Cloud 将开始处理您的请求。当功能启用后，“分析与监控”部分会相应更新。

激活分析功能将自动启用监控功能。

​
更新应用中的 URL

当您启用分析功能时，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 的请求不会向分析界面发送任何数据。如果您之前使用旧 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": "搜索结果点击",
    "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",  # 索引UID
    "objectId": "0",  # 对象ID
    "position": 0  # 位置
  }'

默认情况下，Meilisearch 会将分析事件与触发事件的用户最近一次搜索关联起来。

无法将多个 conversion 事件与同一搜索关联。

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