前往首页v1.10文档

    配置搜索分析

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

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

    要求

    您必须拥有一个 Meilisearch Cloud 账户才能访问搜索分析功能。

    在项目概览中启用分析

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

    The analytics section of the project overview. It shows one button, "Enable analytics", and a short explanation of the feature.

    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": "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 事件与同一搜索关联。

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