設定搜尋分析

啟用 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 的請求將不會傳送任何資料至分析介面。如果您使用先前的 URL 建立了任何自訂 API 金鑰，則需要替換它們。

為了追蹤點擊率和平均點擊位置等指標，Meilisearch Cloud 需要知道使用者何時點擊搜尋結果。

每次使用者點擊搜尋結果時，您的應用程式都必須將 click 事件傳送至 Meilisearch Cloud 分析路由的 POST 端點

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 事件與同一個搜尋關聯起來。

如需更多資訊，請參閱分析事件端點參考。