分析事件终点
本参考文档描述了 /events
端点,您应该使用该端点向 Meilisearch Cloud 提交分析事件。它还描述了接受的事件对象以及您必须在其中包含的数据。
/events
端点
/events
端点仅适用于已激活分析和监控的 Meilisearch Cloud 项目。
发送事件
POSThttps://edge.meilisearch.com/events
向 Meilisearch Cloud 发送分析事件。接受 click
和 conversion
事件。
将分析事件绑定到用户
默认情况下,Meilisearch 将分析事件与触发它们的用户最近的搜索关联起来。在您的搜索和事件请求中包含相同的 X-MS-USER-ID
标头,以手动将分析事件绑定到用户。
示例
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
}'
响应:201 Created
click
事件对象
click
事件必须传递一个包含以下字段的对象
{
"eventType": "click",
"eventName": "Search Result Clicked",
"indexUid": "products",
"objectId": "0",
"position": 0
}
eventType
:一个字符串,指示这是一个click
事件eventName
:描述事件的字符串indexUid
:一个字符串,指示点击的文档的索引objectId
:一个字符串,指示点击的文档的主键position
:一个整数,指示点击的文档在搜索结果列表中的位置
conversion
事件对象
conversion
事件必须传递一个包含以下字段的对象
{
"eventType": "conversion",
"eventName": "Product Added To Cart",
"indexUid": "products",
"objectID": "0",
"position": 0
}
eventType
:指示这是一个conversion
事件eventName
:描述事件的字符串indexUid
:文档的索引objectID
:文档的主键position
:文档在搜索结果列表中的位置