Update from code changes: document search funnel actions

es/optimize/analytics.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Analíticas"
-description: "Consulta el tráfico, tendencias de búsqueda, uso del asistente y comentarios de los usuarios en el panel de analíticas de Mintlify para mejorar tu contenido."
+title: "Panel de analíticas de Mintlify para tu documentación"
+description: "Consulta el tráfico, las tendencias de búsqueda, los embudos, el uso del asistente y los comentarios de los usuarios en el panel de analíticas de Mintlify."
 keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
 boost: 3
 ---
@@ -69,6 +69,25 @@ Revisa tus analíticas del asistente para:
 - **Encontrar dónde tienen dificultades los usuarios**: Filtra por feedback negativo para ver qué conversaciones valoraron mal los usuarios y prioriza mejorar el contenido subyacente.
 - **Revisar el historial de chat**: Obtén datos detallados y de alta intención sobre cómo piensan tus usuarios acerca de tu producto revisando las conversaciones con el asistente. Ve qué términos usan, en qué necesitan ayuda y qué tareas intentan realizar.
 
+<div id="assistant-funnel">
+  ### Embudo de conversaciones del asistente
+</div>
+
+En la sección de Impresiones, utiliza el selector de embudo de usuarios para cambiar entre Búsqueda a respuesta y Conversación del asistente. Búsqueda a respuesta está seleccionada de forma predeterminada. Selecciona Conversación del asistente para ver las etapas del asistente.
+
+El embudo de conversaciones del asistente muestra cómo progresan las sesiones desde el inicio de una conversación hasta interactuar con una respuesta. Úsalo para identificar dónde los usuarios dejan de interactuar con el asistente.
+
+| Etapa | Descripción |
+| --- | --- |
+| **Iniciada** | La sesión tuvo actividad del asistente que no se marcó como spam. |
+| **Respondida** | El asistente completó al menos una respuesta en la sesión. |
+| **Seguimiento** | El asistente completó al menos dos respuestas en la sesión. |
+| **Con interacción** | La sesión interactuó con una respuesta al hacer clic en una fuente, copiar una respuesta, hacer clic en un resultado de búsqueda web o enviar comentarios. |
+
+Revisa el abandono entre etapas para comprender si los usuarios reciben respuestas y continúan interactuando con ellas. El embudo cuenta las sesiones dentro del rango de tiempo seleccionado, excluye las sesiones marcadas como spam y requiere interacción después de una respuesta.
+
+No necesitas configurar el embudo. Abre la página de analíticas, selecciona un rango de tiempo y revisa la sección de Impresiones.
+
 <Frame>
   <img
     src="/images/analytics/assistant-light.png"
@@ -95,6 +114,24 @@ Revisa tus analíticas de búsquedas para:
 - **Identificar consultas frecuentes**: Utiliza las consultas frecuentes para comprender qué temas son más importantes para tus usuarios. Identifica lagunas en la cobertura y prioriza las actualizaciones de contenido.
 - **Identificar tasas de clics bajas**: Las tasas de clics (CTR) muestran cuántos usuarios hacen clic en un resultado de búsqueda después de escribir una consulta. Un CTR bajo puede indicar que los resultados de búsqueda no son relevantes para las consultas de los usuarios. Si tienes términos de búsqueda frecuentes con un CTR bajo, considera mejorar la relevancia de los resultados de búsqueda añadiendo palabras clave y actualizando tu contenido.
 
+<div id="search-funnel">
+  ### Embudo de búsqueda
+</div>
+
+El embudo de búsqueda muestra cómo avanzan las sesiones desde que abren la búsqueda hasta que realizan una acción después de visitar un resultado. Úsalo para detectar dónde dejan de interactuar los usuarios.
+
+| Etapa | Descripción |
+| --- | --- |
+| **Abierta** | La sesión abrió la interfaz de búsqueda. |
+| **Consulta realizada** | La sesión envió una consulta de búsqueda. |
+| **Clic en resultado** | La sesión hizo clic en un resultado de búsqueda. |
+| **Página visitada** | La sesión vio la página abierta desde un resultado de búsqueda. |
+| **Acción realizada** | La sesión realizó una acción después de visitar la página, como hacer clic en un CTA, usar un menú contextual, copiar un bloque de código, llamar a un playground de API o enviar comentarios sobre la página. |
+
+Revisa el abandono entre etapas para identificar si los usuarios tienen problemas para encontrar un resultado, entender una página o continuar con una acción. El embudo cuenta sesiones del período seleccionado y requiere que la acción ocurra después de visitar la página.
+
+No necesitas configurarlo. Abre la página de [analíticas](https://app.mintlify.com/analytics), selecciona un período y revisa la sección de búsqueda. Las analíticas requieren un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=analytics).
+
 <Frame>
   <img
     src="/images/analytics/search-light.png"
@@ -121,6 +158,20 @@ La sección de impresiones de la página de analíticas muestra con qué frecuen
 
 La sección muestra un gráfico de clics en la llamada a la acción (CTA) a lo largo del tiempo y una tabla clasificada de páginas con vistas de página, clics y tasa de clics del CTA.
 
+<div id="interactions-overview">
+  ### Resumen de interacciones
+</div>
+
+En la parte superior de la sección de interacciones de usuarios, la tarjeta **Resumen** resume la interacción durante el rango de tiempo seleccionado. Muestra el total de interacciones, el promedio de interacciones por sesión y la tasa de clics del CTA.
+
+- **Total de interacciones**: El número combinado de clics en el CTA y acciones a nivel de página.
+- **Promedio de interacciones por sesión**: El total de interacciones dividido entre las sesiones con actividad de CTA, de acciones o de vistas de página.
+- **Tasa de clics del CTA**: Los clics en el CTA divididos entre las vistas de página humanas. La tasa no puede superar el 100 %.
+
+Cada métrica incluye una insignia de variación que compara el período seleccionado con el período anterior. Al cambiar el rango de tiempo de las analíticas, se actualizan los valores y las variaciones de comparación. La tasa de clics del CTA se muestra como un porcentaje.
+
+Utiliza estas métricas para comprender con qué nivel de actividad los visitantes interactúan con tu contenido y tus llamadas a la acción.
+
 Revisa tus analíticas de impresiones para:
 
 - **Identificar páginas de alta intención**: Las páginas con una alta tasa de clics del CTA suelen indicar visitantes que están listos para dar el siguiente paso, como registrarse en tu producto o hablar con tu equipo de ventas.

fr/optimize/analytics.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Analytique"
+title: "Tableau de bord analytique Mintlify pour vos docs"
 description: "Suivez le trafic, les tendances de recherche, l'utilisation de l'assistant et les retours des utilisateurs dans le tableau de bord d'analytique Mintlify."
 keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
 boost: 3
@@ -69,6 +69,25 @@ Examinez vos analyses de l'assistant pour :
 - **Repérer les points de friction** : filtrez par retours négatifs pour voir quelles conversations les utilisateurs ont mal notées et priorisez l'amélioration du contenu sous-jacent.
 - **Consulter l'historique des conversations** : obtenez des données détaillées à forte intention sur la façon dont vos utilisateurs perçoivent votre produit en examinant leurs conversations avec l'assistant. Voyez les termes qu'ils emploient, ce sur quoi ils ont besoin d'aide et les tâches qu'ils cherchent à accomplir.
 
+<div id="assistant-funnel">
+  ### Entonnoir de conversations de l'assistant
+</div>
+
+Dans la section Impressions, utilisez le sélecteur d'entonnoir utilisateur pour basculer entre Recherche vers réponse et Conversation avec l'assistant. Recherche vers réponse est sélectionné par défaut. Sélectionnez Conversation avec l'assistant pour afficher les étapes de l'assistant.
+
+L'entonnoir de conversations de l'assistant montre comment les sessions progressent du démarrage d'une conversation à l'interaction avec une réponse. Utilisez-le pour identifier les étapes auxquelles les utilisateurs cessent d'interagir avec l'assistant.
+
+| Étape | Description |
+| --- | --- |
+| **Démarrée** | La session a enregistré une activité de l'assistant qui n'a pas été signalée comme spam. |
+| **Répondue** | L'assistant a terminé au moins une réponse au cours de la session. |
+| **Suivi** | L'assistant a terminé au moins deux réponses au cours de la session. |
+| **Engagée** | La session a interagi avec une réponse en cliquant sur une source, en copiant une réponse, en cliquant sur un résultat de recherche web ou en envoyant un retour. |
+
+Examinez les abandons entre les étapes pour déterminer si les utilisateurs reçoivent des réponses et continuent d'interagir avec celles-ci. L'entonnoir compte les sessions de la période sélectionnée, exclut les sessions signalées comme spam et exige une interaction après une réponse.
+
+Aucune configuration de l'entonnoir n'est nécessaire. Ouvrez la page d'analytique, sélectionnez une période, puis consultez la section Impressions.
+
 <Frame>
   <img
     src="/images/analytics/assistant-light.png"
@@ -95,6 +114,24 @@ Examinez vos analyses de recherche pour :
 - **Identifier les requêtes fréquentes** : utilisez les requêtes fréquentes pour comprendre quels sujets sont les plus importants pour vos utilisateurs. Repérez les lacunes de couverture et priorisez les mises à jour du contenu.
 - **Identifier les faibles taux de clic** : le taux de clic (CTR) indique combien d'utilisateurs cliquent sur un résultat de recherche après avoir saisi une requête. Un CTR faible peut indiquer que les résultats de recherche ne sont pas pertinents par rapport aux requêtes des utilisateurs. Si vous avez des termes de recherche fréquents avec un CTR faible, envisagez d'améliorer la pertinence des résultats de recherche en ajoutant des mots-clés et en mettant à jour votre contenu.
 
+<div id="search-funnel">
+  ### Entonnoir de recherche
+</div>
+
+L'entonnoir de recherche montre comment les sessions progressent de l'ouverture de la recherche à une action après la consultation d'un résultat. Utilisez-le pour repérer les étapes où les utilisateurs cessent d'interagir.
+
+| Étape | Description |
+| --- | --- |
+| **Ouverte** | La session a ouvert l'interface de recherche. |
+| **Requête effectuée** | La session a envoyé une requête de recherche. |
+| **Résultat cliqué** | La session a cliqué sur un résultat de recherche. |
+| **Page consultée** | La session a consulté la page ouverte depuis un résultat de recherche. |
+| **Action effectuée** | La session a effectué une action après la consultation, comme cliquer sur un CTA, utiliser un menu contextuel, copier un bloc de code, appeler un playground d'API ou envoyer un retour sur la page. |
+
+Examinez les abandons entre les étapes pour déterminer si les utilisateurs ont du mal à trouver un résultat, à comprendre une page ou à poursuivre une action. L'entonnoir compte les sessions de la période sélectionnée et exige que l'action ait lieu après la consultation de la page.
+
+Aucune configuration n'est nécessaire. Ouvrez la page [analytics](https://app.mintlify.com/analytics), sélectionnez une période, puis consultez la section Recherche. L'analytique nécessite un [plan Pro ou Enterprise](https://mintlify.com/pricing?ref=analytics).
+
 <Frame>
   <img
     src="/images/analytics/search-light.png"
@@ -121,6 +158,20 @@ La section Impressions de la page d'analytique indique la fréquence à laquelle
 
 Cette section affiche un graphique des clics sur l'appel à l'action (CTA) au fil du temps ainsi qu'un tableau classé des pages, avec les vues de page, les clics et le taux de clic du CTA.
 
+<div id="interactions-overview">
+  ### Vue d'ensemble des interactions
+</div>
+
+En haut de la section consacrée aux engagements des utilisateurs, la carte **Vue d'ensemble** résume l'engagement pour la plage de temps sélectionnée. Elle affiche le nombre total d'interactions, le nombre moyen d'interactions par session et le taux de clic du CTA.
+
+- **Total des interactions** : Le nombre de clics sur les CTA et d'actions au niveau des pages combinés.
+- **Nombre moyen d'interactions par session** : Le nombre total d'interactions divisé par le nombre de sessions ayant enregistré une activité liée à un CTA, à une action ou à une vue de page.
+- **Taux de clic du CTA** : Le nombre de clics sur les CTA divisé par le nombre de pages vues par des humains. Le taux ne peut pas dépasser 100 %.
+
+Chaque indicateur comprend un badge de variation qui compare la période sélectionnée à la période précédente. Lorsque vous modifiez la plage de temps de l'analytique, les valeurs et les variations sont mises à jour. Le taux de clic du CTA est affiché en pourcentage.
+
+Utilisez ces indicateurs pour comprendre dans quelle mesure les visiteurs interagissent activement avec votre contenu et vos appels à l'action.
+
 Examinez vos analyses d'impressions pour :
 
 - **Identifier les pages à forte intention** : les pages présentant un taux de clic du CTA élevé indiquent souvent des visiteurs prêts à passer à l'étape suivante, comme s'inscrire à votre produit ou contacter votre équipe commerciale.

optimize/analytics.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Analytics"
+title: "Analytics dashboard for docs traffic and engagement"
 description: "Track traffic, search trends, assistant usage, and user feedback in the Mintlify analytics dashboard to improve content and report on effectiveness."
 keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
 boost: 3
@@ -61,6 +61,23 @@
 - **Find where users struggle**: Filter by negative feedback to see which conversations users rated poorly and prioritize improving the underlying content.
 - **Review chat history**: Get detailed high intent data about how your users think about your product by reviewing conversations with the assistant. See what terms they use, what they need help with, and what tasks they try to accomplish.
 
+### Assistant conversation funnel
+
+In the Impressions section, use the **User funnel** selector to switch between **Search-to-answer** and **Assistant conversation**. Search-to-answer is selected by default. Select **Assistant conversation** to view the assistant stages.
+
+The assistant conversation funnel shows how sessions progress from starting a conversation to engaging with an answer. Use it to identify where users stop interacting with the assistant.
+
+| Stage | Description |
+| --- | --- |
+| **Started** | The session had assistant activity that was not flagged as spam. |
+| **Answered** | The assistant completed at least one answer in the session. |
+| **Follow-up** | The assistant completed at least two answers in the session. |
+| **Engaged** | The session interacted with an answer by clicking a source, copying a response, clicking a web search result, or submitting feedback. |
+
+Review the drop-off between stages to understand whether users receive answers and continue engaging with them. The funnel counts sessions within the selected time range, excludes sessions flagged as spam, and requires engagement after an answer.
+
+You do not need to configure the funnel. Open the [analytics](https://app.mintlify.com/analytics) page, select a time range, and review the Impressions section.
+
 <Frame>
   <img
     src="/images/analytics/assistant-light.png"
@@ -85,6 +102,24 @@
 - **Identify frequent queries**: Use frequent queries to understand what topics are most important to your users. Identify gaps in coverage and prioritize content updates.
 - **Identify low click-through rates**: Click-through rates (CTR) show how many users click a search result after typing in a query. Low CTR can indicate that the search results are not relevant to users' queries. If you have frequent search terms with low CTR, consider improving the relevance of search results by adding keywords and updating your content.
 
+### Search funnel
+
+The search funnel shows how sessions progress from opening search to taking an action after visiting a result. Use it to find where users stop engaging and improve your search results or page content.
+
+The funnel includes these stages:
+
+| Stage | Description |
+| --- | --- |
+| **Opened** | The session opened the search interface. |
+| **Queried** | The session submitted a search query. |
+| **Clicked** | The session clicked a search result. |
+| **Landed** | The session viewed the page opened by a search result. |
+| **Taken an action** | The session performed an action after landing, such as clicking a CTA, using a contextual menu, copying a code block, calling an API playground, or submitting page feedback. |
+
+Review the drop-off between stages to identify whether users struggle to find a result, understand a page, or continue to an action. The funnel counts sessions within the selected time range and requires the action to occur after the landing view.
+
+You do not need to configure the funnel. Open the [analytics](https://app.mintlify.com/analytics) page, select a time range, and review the Search section. Analytics requires a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=analytics).
+
 <Frame>
   <img
     src="/images/analytics/search-light.png"
@@ -109,6 +144,18 @@
 
 The section displays a chart of call-to-action (CTA) clicks over time and a ranked table of pages with page views, clicks, and CTA click-through rate.
 
+### Interactions overview
+
+At the top of the User engagements section, the **Overview** card summarizes engagement for the selected time range. It shows total interactions, average interactions per session, and CTA click rate.
+
+- **Total interactions**: The number of CTA clicks and page-level actions combined.
+- **Average interactions per session**: Total interactions divided by sessions with CTA, action, or page-view activity.
+- **CTA click rate**: CTA clicks divided by human page views. The rate cannot exceed 100%.
+
+Each metric includes a delta badge that compares the selected period with the previous period. Changing the analytics time range updates the metric values and comparison deltas. The CTA click rate is shown as a percentage.
+
+Use these metrics to understand how actively visitors engage with your content and calls to action.
+
 Review your impressions analytics to:
 
 - **Identify high-intent pages**: Pages with a high CTA click-through rate often indicate visitors who are ready to take the next step. Examples include signing up for your product or talking to your sales team.