add guide on analytics event configuration, remove previous guides

Author: guimachiavelli

.code-samples.meilisearch.yaml

@@ -1285,21 +1285,24 @@ analytics_event_click_1: |-
       "eventType": "click",
       "eventName": "Search Result Clicked",
       "indexUid": "products",
+      "userId": "SEARCH_USER_ID",
       "queryUid": "019a01b7-a1c2-7782-a410-bb1274c81393",
       "objectId": "0",
       "objectName": "DOCUMENT_DESCRIPTION",
       "position": 0
     }'
 analytics_event_conversion_1: |-
   curl \
-    -X POST 'https://edge.meilisearch.com/events' \
+    -X POST 'https://PROJECT_URL/events' \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer DEFAULT_SEARCH_API_KEY'
     --data-binary '{
       "eventType": "conversion",
       "eventName": "Product Added To Cart",
       "indexUid": "products",
+      "userId": "SEARCH_USER_ID",
       "objectId": "0",
+      "objectName": "DOCUMENT_DESCRIPTION",
       "position": 0
     }'
 analytics_event_bind_search_1: |-

docs.json

@@ -206,8 +206,7 @@
               {
                 "group": "Analytics",
                 "pages": [
-                  "learn/analytics/configure_analytics",
-                  "learn/analytics/configure_monitoring",
+                  "learn/analytics/configure_analytics_events",
                   "learn/analytics/bind_events_user",
                   "learn/analytics/migrate_analytics_monitoring",
                   "learn/analytics/events_endpoint"

learn/analytics/configure_analytics.mdx

@@ -0,0 +1,43 @@
+---
+title: Configure Meilisearch Cloud analytics events
+description: By default, Meilisearch Cloud analytics tracks metrics such as number of users and latency. Follow this guide to track advanced events such as user conversion and click-through rates.
+---
+
+import CodeSamplesAnalyticsEventConversion1 from '/snippets/samples/code_samples_analytics_event_conversion_1.mdx';
+import CodeSamplesAnalyticsEventClick1 from '/snippets/samples/code_samples_analytics_event_click_1.mdx';
+
+## Requirements
+
+You must have a [Meilisearch Cloud](https://meilisearch.com/cloud) account to access search analytics.
+
+## Configure click-through rate and average click position
+
+To track click-through rate and average click position, Meilisearch Cloud needs to know when users click on search results.
+
+Every time a user clicks on a search result, your application must send a `click` event to the `POST` endpoint of Meilisearch Cloud analytics route:
+
+<CodeSamplesAnalyticsEventClick1 />
+
+You must explicitly submit a `userId` associated with the event. This can be any arbitrary string you can use to identify the user, such as their profile ID in your application or their hashed IP address. You may submit user IDs directly on the event payload, or setting a `X-MS-USER-ID` request header.
+
+Specifying a `queryUid` is optional but recommended as it ensures Meilisearch correctly associates the search query with the event. You can find the query UID in the `metadata` field present in Meilisearch Cloud's search query response.
+
+For more information, consult the [analytics events endpoint reference](/learn/analytics/events_endpoint).
+
+## Configure conversion rate
+
+To track conversion rate, first identify what should count as a conversion for your application. For example, in a web shop, a conversion might be a user finalizing the checkout process.
+
+Once you have established what counts as a conversion in your application, configure it to send a `conversion` event to the `POST` endpoint of Meilisearch Cloud analytics route:
+
+<CodeSamplesAnalyticsEventConversion1 />
+
+You must explicitly submit a `userId` associated with the event. This can be any arbitrary string you can use to identify the user, such as their profile ID in your application or their hashed IP address. You may submit user IDs directly on the event payload, or setting a `X-MS-USER-ID` request header.
+
+Specifying a `queryUid` is optional but recommended as it ensures Meilisearch correctly associates the search query with the event. You can find the query UID in the `metadata` field present in Meilisearch Cloud's search query response.
+
+<Note>
+It is not possible to associate multiple `conversion` events with the same query.
+</Note>
+
+For more information, consult the [analytics events endpoint reference](/learn/analytics/events_endpoint).