前往首頁v1.12文件

    將搜尋分析事件綁定至使用者

    預設情況下，Meilisearch 使用 IP 位址來識別使用者並計算總使用者指標。本指南將說明如何使用 X-MS-USER-ID HTTP 標頭來手動將分析事件連結至特定使用者。

    如果您是從後端進行搜尋，這會很有用，因為否則所有搜尋都會顯示來自您伺服器的 IP 位址，因此很難準確追蹤個別使用者的數量。

    需求

    將 X-MS-USER-ID 新增至您的搜尋查詢

    在您的搜尋請求中包含 X-MS-USER-ID 標頭

    curl \
  -X POST 'https://127.0.0.1:7700/indexes/INDEX_NAME/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer DEFAULT_SEARCH_API_KEY' \
  -H 'X-MS-USER-ID: MEILISEARCH_USER_ID' \
  --data-binary '{}'

    將 MEILISEARCH_USER_ID 替換為任何能唯一識別該使用者的值。當您從自己的後端執行搜尋時，這可能是已驗證使用者的 ID，或是使用者 IP 位址的雜湊。

    將 X-MS-USER-ID 新增至分析事件

    接下來，將您的分析事件提交至分析端點。在您的 API 呼叫中傳送相同的標頭和值

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

    結論

    在本指南中，您已了解如何透過為搜尋請求和分析事件指定相同的 HTTP 標頭，將分析事件連結至特定使用者。