From 61e7e2eae68622ccb2458cb7dbbfc3efc9710c83 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 1 Sep 2026 22:05:56 +0000 Subject: [PATCH 1/6] docs: document crawler-filtered visitor counts and agent breakdown buckets --- analytics/traffic.mdx | 16 ++++++++++++++ docs.json | 3 ++- es/analytics/traffic.mdx | 18 +++++++++++++++ ...-count-dropped-after-crawler-filtering.mdx | 22 +++++++++++++++++++ fr/analytics/traffic.mdx | 18 +++++++++++++++ ...-count-dropped-after-crawler-filtering.mdx | 22 +++++++++++++++++++ ...-count-dropped-after-crawler-filtering.mdx | 22 +++++++++++++++++++ zh/analytics/traffic.mdx | 18 +++++++++++++++ ...-count-dropped-after-crawler-filtering.mdx | 22 +++++++++++++++++++ 9 files changed, 160 insertions(+), 1 deletion(-) create mode 100644 es/help-center/visitor-count-dropped-after-crawler-filtering.mdx create mode 100644 fr/help-center/visitor-count-dropped-after-crawler-filtering.mdx create mode 100644 help-center/visitor-count-dropped-after-crawler-filtering.mdx create mode 100644 zh/help-center/visitor-count-dropped-after-crawler-filtering.mdx diff --git a/analytics/traffic.mdx b/analytics/traffic.mdx index 57cdebdb1b..a2d9ade533 100644 --- a/analytics/traffic.mdx +++ b/analytics/traffic.mdx @@ -31,6 +31,14 @@ Review traffic analytics to: /> +## How Mintlify counts traffic + +Mintlify classifies every request by user agent and counts only human and agent traffic toward visitor and page view totals. Traffic from search indexing crawlers, AI training crawlers, and other bots is excluded from both metrics. For a breakdown of each traffic category, see [Interpret traffic exports](/analytics/export#interpret-traffic-exports). + + + In September 2026, Mintlify updated visitor counts to use the same crawler filtering as page views. Visitor totals dropped on most sites, and the change applies to all date ranges. See [Why your visitor count dropped after crawler filtering](/help-center/visitor-count-dropped-after-crawler-filtering). + + ## Interpret agent views Mintlify identifies agent visitors by IP address and user agent. The agent visitor count approximates distinct sources of AI traffic rather than individual agent sessions or conversations. Multiple requests from the same IP address count as one visitor. @@ -46,3 +54,11 @@ Use agent views to understand: - **AI agent distribution**: See which AI platforms access your docs to learn which tools your users prefer. - **Integration opportunities**: Identify which AI platforms to prioritize for optimization and testing. - **AI traffic patterns**: Monitor which agents are most active and how their usage changes over time. + +The agent breakdown groups traffic by provider, such as ChatGPT, Claude, and Cursor. Three buckets capture the remaining agent traffic: + +- **HTTP clients**: Requests from tools and libraries such as curl, wget, and Python HTTP clients. +- **Browser**: Markdown requests made from a web browser. +- **Other**: Agent traffic that does not match a known provider or client. + +Mintlify excludes its own internal traffic, such as link checking and page revalidation, from the agent breakdown. diff --git a/docs.json b/docs.json index c39c56eed8..01cdddaa7e 100644 --- a/docs.json +++ b/docs.json @@ -488,7 +488,8 @@ "help-center/preview-deployment-not-created-for-fork-branch", "help-center/branch-missing-from-editor-branch-list", "help-center/style-card-icons-with-custom-css", - "help-center/can-i-rename-my-deployment-or-organization" + "help-center/can-i-rename-my-deployment-or-organization", + "help-center/visitor-count-dropped-after-crawler-filtering" ] } ] diff --git a/es/analytics/traffic.mdx b/es/analytics/traffic.mdx index f056b09920..e784590780 100644 --- a/es/analytics/traffic.mdx +++ b/es/analytics/traffic.mdx @@ -31,6 +31,16 @@ Revisa las analíticas de tráfico para: /> +
+ ## Cómo cuenta Mintlify el tráfico +
+ +Mintlify clasifica cada solicitud según el user agent y solo cuenta el tráfico humano y de agentes en los totales de visitantes y de vistas de página. El tráfico de rastreadores de indexación de búsqueda, rastreadores de entrenamiento de IA y otros bots se excluye de ambas métricas. Para ver el desglose de cada categoría de tráfico, consulta [Interpretar las exportaciones de tráfico](/es/analytics/export#interpret-traffic-exports). + + + En septiembre de 2026, Mintlify actualizó los conteos de visitantes para usar el mismo filtrado de rastreadores que las vistas de página. Los totales de visitantes bajaron en la mayoría de los sitios, y el cambio se aplica a todos los rangos de fechas. Consulta [Por qué bajó tu conteo de visitantes tras el filtrado de rastreadores](/es/help-center/visitor-count-dropped-after-crawler-filtering). + +
## Interpretar las vistas de agentes
@@ -48,3 +58,11 @@ Usa las vistas de agentes para comprender: - **Distribución de agentes de IA**: Observa qué plataformas de IA acceden a tus docs para saber qué herramientas prefieren tus usuarios. - **Oportunidades de integración**: Identifica qué plataformas de IA priorizar para la optimización y las pruebas. - **Patrones de tráfico de IA**: Monitorea qué agentes son más activos y cómo cambia su uso a lo largo del tiempo. + +El desglose de agentes agrupa el tráfico por proveedor, como ChatGPT, Claude y Cursor. Tres categorías capturan el resto del tráfico de agentes: + +- **HTTP clients**: Solicitudes de herramientas y bibliotecas como curl, wget y clientes HTTP de Python. +- **Browser**: Solicitudes de Markdown realizadas desde un navegador web. +- **Other**: Tráfico de agentes que no coincide con un proveedor o cliente conocido. + +Mintlify excluye su propio tráfico interno, como la verificación de enlaces y la revalidación de páginas, del desglose de agentes. diff --git a/es/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/es/help-center/visitor-count-dropped-after-crawler-filtering.mdx new file mode 100644 index 0000000000..66aff94ddf --- /dev/null +++ b/es/help-center/visitor-count-dropped-after-crawler-filtering.mdx @@ -0,0 +1,22 @@ +--- +title: "Por qué bajó tu conteo de visitantes tras el filtrado de rastreadores" +description: "Comprende por qué los totales de visitantes en las analíticas de Mintlify bajaron en septiembre de 2026, cuando el tráfico de rastreadores se excluyó de los conteos de visitantes." +keywords: ["visitor count dropped", "visitors lower than views", "more visitors than views", "crawler traffic", "bot filtering", "analytics visitors"] +--- + +En septiembre de 2026, Mintlify cambió la forma en que el panel de analíticas cuenta los visitantes únicos. Los totales de visitantes ahora excluyen el tráfico de rastreadores de indexación de búsqueda, rastreadores de entrenamiento de IA y otros bots, igualando el filtrado que ya se aplicaba a las vistas de página. Si tu conteo de visitantes bajó bruscamente, o los números históricos se ven más bajos que antes, este cambio es la causa más probable. + +## Qué cambió + +Antes de esta actualización, el tráfico de rastreadores se excluía de los conteos de vistas de página, pero no de los conteos de visitantes. Los rastreadores inflan los totales de visitantes mucho más que los de vistas porque no conservan cookies, por lo que Mintlify no puede reconocer solicitudes repetidas del mismo rastreador como un solo visitante. En sitios con mucho tráfico de rastreadores, esta inflación podía llevar el conteo de visitantes por encima del conteo de vistas de página, algo imposible con tráfico real de lectores. + +Los conteos de visitantes ahora usan la misma clasificación de rastreadores que las vistas de página. Solo los lectores humanos y los agentes de IA cuentan en los totales de visitantes. + +## Qué esperar + +- Los totales de visitantes son más bajos en la mayoría de los sitios. Los sitios que reciben mucho tráfico de rastreadores muestran la mayor caída. +- El cambio se aplica a todos los rangos de fechas, incluidos los históricos, porque Mintlify clasifica el tráfico al calcular el informe y no al almacenar los eventos. +- Las vistas por visitante vuelven a una proporción plausible, con más vistas de página que visitantes. +- Los totales de visitantes agentes también pueden cambiar, porque la misma actualización refinó cómo se identifica el tráfico de agentes. + +Para saber cómo clasifica Mintlify el tráfico y cómo interpretar las vistas de agentes, consulta [Analizar el tráfico de la documentación](/es/analytics/traffic). diff --git a/fr/analytics/traffic.mdx b/fr/analytics/traffic.mdx index db5d568df4..409db67a56 100644 --- a/fr/analytics/traffic.mdx +++ b/fr/analytics/traffic.mdx @@ -31,6 +31,16 @@ Consultez les analytics de trafic pour : /> +
+ ## Comment Mintlify comptabilise le trafic +
+ +Mintlify classe chaque requête selon son user agent et ne comptabilise que le trafic humain et le trafic des agents dans les totaux de visiteurs et de pages vues. Le trafic des robots d'indexation de recherche, des robots d'entraînement d'IA et des autres bots est exclu des deux métriques. Pour le détail de chaque catégorie de trafic, consultez [Interpréter les exports de trafic](/fr/analytics/export#interpret-traffic-exports). + + + En septembre 2026, Mintlify a mis à jour le comptage des visiteurs pour utiliser le même filtrage des robots que les pages vues. Les totaux de visiteurs ont baissé sur la plupart des sites, et le changement s'applique à toutes les plages de dates. Consultez [Pourquoi votre nombre de visiteurs a baissé après le filtrage des robots](/fr/help-center/visitor-count-dropped-after-crawler-filtering). + +
## Interpréter les vues des agents
@@ -48,3 +58,11 @@ Utilisez les vues des agents pour comprendre : - **La distribution des agents IA** : Voyez quelles plateformes IA accèdent à vos docs pour savoir quels outils vos utilisateurs préfèrent. - **Les opportunités d'intégration** : Identifiez les plateformes IA à prioriser pour l'optimisation et les tests. - **Les schémas du trafic IA** : Surveillez quels agents sont les plus actifs et comment leur utilisation évolue dans le temps. + +La répartition des agents regroupe le trafic par fournisseur, comme ChatGPT, Claude et Cursor. Trois catégories regroupent le reste du trafic des agents : + +- **HTTP clients** : Requêtes provenant d'outils et de bibliothèques comme curl, wget et les clients HTTP Python. +- **Browser** : Requêtes Markdown effectuées depuis un navigateur web. +- **Other** : Trafic d'agents qui ne correspond à aucun fournisseur ou client connu. + +Mintlify exclut son propre trafic interne, comme la vérification des liens et la revalidation des pages, de la répartition des agents. diff --git a/fr/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/fr/help-center/visitor-count-dropped-after-crawler-filtering.mdx new file mode 100644 index 0000000000..ce0f174afb --- /dev/null +++ b/fr/help-center/visitor-count-dropped-after-crawler-filtering.mdx @@ -0,0 +1,22 @@ +--- +title: "Pourquoi votre nombre de visiteurs a baissé après le filtrage des robots" +description: "Comprenez pourquoi les totaux de visiteurs dans les analytics Mintlify ont baissé en septembre 2026, lorsque le trafic des robots a été exclu du comptage des visiteurs." +keywords: ["visitor count dropped", "visitors lower than views", "more visitors than views", "crawler traffic", "bot filtering", "analytics visitors"] +--- + +En septembre 2026, Mintlify a changé la façon dont le tableau de bord analytics compte les visiteurs uniques. Les totaux de visiteurs excluent désormais le trafic des robots d'indexation de recherche, des robots d'entraînement d'IA et des autres bots, en appliquant le même filtrage que celui déjà utilisé pour les pages vues. Si votre nombre de visiteurs a chuté brusquement, ou si les chiffres historiques semblent plus bas qu'avant, ce changement en est la cause la plus probable. + +## Ce qui a changé + +Avant cette mise à jour, le trafic des robots était exclu du comptage des pages vues, mais pas du comptage des visiteurs. Les robots gonflent les totaux de visiteurs bien plus que ceux des vues, car ils ne conservent pas les cookies. Mintlify ne peut donc pas reconnaître les requêtes répétées d'un même robot comme un seul visiteur. Sur les sites avec un trafic de robots important, cette inflation pouvait faire passer le nombre de visiteurs au-dessus du nombre de pages vues, ce qui est impossible avec du trafic de lecteurs réels. + +Le comptage des visiteurs utilise désormais la même classification des robots que les pages vues. Seuls les lecteurs humains et les agents IA comptent dans les totaux de visiteurs. + +## À quoi s'attendre + +- Les totaux de visiteurs sont plus bas sur la plupart des sites. Les sites recevant un trafic de robots important affichent la plus forte baisse. +- Le changement s'applique à toutes les plages de dates, y compris historiques, car Mintlify classe le trafic au moment de calculer le rapport et non au moment de stocker les événements. +- Le ratio de vues par visiteur redevient plausible, avec plus de pages vues que de visiteurs. +- Les totaux de visiteurs agents peuvent aussi évoluer, car la même mise à jour a affiné l'identification du trafic des agents. + +Pour comprendre comment Mintlify classe le trafic et comment interpréter les vues des agents, consultez [Analyser le trafic de la documentation](/fr/analytics/traffic). diff --git a/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/help-center/visitor-count-dropped-after-crawler-filtering.mdx new file mode 100644 index 0000000000..9bc9fb48e3 --- /dev/null +++ b/help-center/visitor-count-dropped-after-crawler-filtering.mdx @@ -0,0 +1,22 @@ +--- +title: "Why your visitor count dropped after crawler filtering" +description: "Understand why visitor totals in Mintlify analytics dropped in September 2026 after crawler traffic was excluded from visitor counts." +keywords: ["visitor count dropped", "visitors lower than views", "more visitors than views", "crawler traffic", "bot filtering", "analytics visitors"] +--- + +In September 2026, Mintlify changed how the analytics dashboard counts unique visitors. Visitor totals now exclude traffic from search indexing crawlers, AI training crawlers, and other bots, matching the filtering that already applied to page views. If your visitor count dropped sharply, or historical numbers look lower than they did before, this change is the most likely cause. + +## What changed + +Before this update, crawler traffic was excluded from page view counts but not from visitor counts. Crawlers inflate visitor totals far more than view totals because they do not persist cookies, so Mintlify cannot recognize repeat requests from the same crawler as one visitor. On sites with heavy crawler traffic, this inflation could push the visitor count above the page view count, which is impossible for real reader traffic. + +Visitor counts now use the same crawler classification as page views. Only human readers and AI agents count toward visitor totals. + +## What to expect + +- Visitor totals are lower on most sites. Sites that receive heavy crawler traffic see the largest drop. +- The change applies to every date range, including historical ones, because Mintlify classifies traffic when it computes the report rather than when it stores events. +- Views per visitor returns to a plausible ratio, with more page views than visitors. +- Agent visitor totals can also shift, because the same update refined how agent traffic is identified. + +For how Mintlify classifies traffic and how to interpret agent views, see [Analyze documentation traffic](/analytics/traffic). diff --git a/zh/analytics/traffic.mdx b/zh/analytics/traffic.mdx index 49b7178086..c04946b006 100644 --- a/zh/analytics/traffic.mdx +++ b/zh/analytics/traffic.mdx @@ -31,6 +31,16 @@ keywords: ["analytics", "traffic", "page views", "visitors", "referrals", "agent /> +
+ ## Mintlify 如何统计流量 +
+ +Mintlify 根据 user agent 对每个请求进行分类,只有人类流量和 agent 流量会计入访客数和页面浏览量总数。搜索索引爬虫、AI 训练爬虫和其他 bot 的流量不计入这两项指标。有关各流量类别的详细说明,请参阅[解读流量导出](/zh/analytics/export#interpret-traffic-exports)。 + + + 2026 年 9 月,Mintlify 更新了访客统计方式,使其采用与页面浏览量相同的爬虫过滤规则。大多数站点的访客总数因此下降,且该变更适用于所有日期范围。请参阅[为什么爬虫过滤后访客数下降了](/zh/help-center/visitor-count-dropped-after-crawler-filtering)。 + +
## 解读 agent 浏览量
@@ -48,3 +58,11 @@ Mintlify 通过 IP 地址和 user agent 识别 agent 访客。agent 访客数近 - **AI agent 分布**:查看哪些 AI 平台访问您的 docs,了解用户偏好哪些工具。 - **集成机会**:识别哪些 AI 平台应优先进行优化和测试。 - **AI 流量模式**:监控哪些 agent 最活跃,以及它们的使用情况如何随时间变化。 + +agent 明细按提供商对流量进行分组,例如 ChatGPT、Claude 和 Cursor。其余的 agent 流量归入三个类别: + +- **HTTP clients**:来自 curl、wget 和 Python HTTP 客户端等工具和库的请求。 +- **Browser**:从 Web 浏览器发出的 Markdown 请求。 +- **Other**:与已知提供商或客户端不匹配的 agent 流量。 + +Mintlify 会从 agent 明细中排除自身的内部流量,例如链接检查和页面重新验证。 diff --git a/zh/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/zh/help-center/visitor-count-dropped-after-crawler-filtering.mdx new file mode 100644 index 0000000000..eb7ec62f63 --- /dev/null +++ b/zh/help-center/visitor-count-dropped-after-crawler-filtering.mdx @@ -0,0 +1,22 @@ +--- +title: "为什么爬虫过滤后访客数下降了" +description: "了解为什么 Mintlify 分析中的访客总数在 2026 年 9 月下降:爬虫流量已从访客统计中排除,与页面浏览量的过滤规则保持一致。" +keywords: ["visitor count dropped", "visitors lower than views", "more visitors than views", "crawler traffic", "bot filtering", "analytics visitors"] +--- + +2026 年 9 月,Mintlify 更改了分析仪表板统计独立访客的方式。访客总数现在会排除搜索索引爬虫、AI 训练爬虫和其他 bot 的流量,与页面浏览量已有的过滤规则保持一致。如果您的访客数骤降,或历史数据看起来比以前低,此变更是最可能的原因。 + +## 变更内容 + +在此更新之前,爬虫流量已从页面浏览量统计中排除,但未从访客统计中排除。爬虫对访客总数的夸大程度远高于浏览量,因为爬虫不保留 cookie,Mintlify 无法将同一爬虫的重复请求识别为同一个访客。在爬虫流量较大的站点上,这种夸大可能使访客数超过页面浏览量,而真实读者流量不可能出现这种情况。 + +访客统计现在使用与页面浏览量相同的爬虫分类。只有人类读者和 AI agent 会计入访客总数。 + +## 预期变化 + +- 大多数站点的访客总数会降低。爬虫流量较大的站点降幅最大。 +- 该变更适用于所有日期范围,包括历史范围,因为 Mintlify 在生成报表时对流量进行分类,而不是在存储事件时分类。 +- 每位访客的浏览量恢复到合理比例,页面浏览量多于访客数。 +- agent 访客总数也可能变化,因为同一更新优化了 agent 流量的识别方式。 + +要了解 Mintlify 如何对流量分类以及如何解读 agent 浏览量,请参阅[分析文档流量](/zh/analytics/traffic)。 From 92b6758359363296d7d70328ea4375d5b782fb51 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 1 Sep 2026 22:07:59 +0000 Subject: [PATCH 2/6] docs: mirror help center nav entry in localized configs and add heading anchors --- es.json | 3 ++- .../visitor-count-dropped-after-crawler-filtering.mdx | 8 ++++++-- fr.json | 3 ++- .../visitor-count-dropped-after-crawler-filtering.mdx | 8 ++++++-- zh.json | 3 ++- .../visitor-count-dropped-after-crawler-filtering.mdx | 8 ++++++-- 6 files changed, 24 insertions(+), 9 deletions(-) diff --git a/es.json b/es.json index 80c5decdbc..6f1a77fc49 100644 --- a/es.json +++ b/es.json @@ -465,7 +465,8 @@ "es/help-center/static-file-not-served", "es/help-center/preview-deployment-not-created-for-fork-branch", "es/help-center/style-card-icons-with-custom-css", - "es/help-center/can-i-rename-my-deployment-or-organization" + "es/help-center/can-i-rename-my-deployment-or-organization", + "es/help-center/visitor-count-dropped-after-crawler-filtering" ] } ] diff --git a/es/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/es/help-center/visitor-count-dropped-after-crawler-filtering.mdx index 66aff94ddf..aa522b6dd5 100644 --- a/es/help-center/visitor-count-dropped-after-crawler-filtering.mdx +++ b/es/help-center/visitor-count-dropped-after-crawler-filtering.mdx @@ -6,13 +6,17 @@ keywords: ["visitor count dropped", "visitors lower than views", "more visitors En septiembre de 2026, Mintlify cambió la forma en que el panel de analíticas cuenta los visitantes únicos. Los totales de visitantes ahora excluyen el tráfico de rastreadores de indexación de búsqueda, rastreadores de entrenamiento de IA y otros bots, igualando el filtrado que ya se aplicaba a las vistas de página. Si tu conteo de visitantes bajó bruscamente, o los números históricos se ven más bajos que antes, este cambio es la causa más probable. -## Qué cambió +
+ ## Qué cambió +
Antes de esta actualización, el tráfico de rastreadores se excluía de los conteos de vistas de página, pero no de los conteos de visitantes. Los rastreadores inflan los totales de visitantes mucho más que los de vistas porque no conservan cookies, por lo que Mintlify no puede reconocer solicitudes repetidas del mismo rastreador como un solo visitante. En sitios con mucho tráfico de rastreadores, esta inflación podía llevar el conteo de visitantes por encima del conteo de vistas de página, algo imposible con tráfico real de lectores. Los conteos de visitantes ahora usan la misma clasificación de rastreadores que las vistas de página. Solo los lectores humanos y los agentes de IA cuentan en los totales de visitantes. -## Qué esperar +
+ ## Qué esperar +
- Los totales de visitantes son más bajos en la mayoría de los sitios. Los sitios que reciben mucho tráfico de rastreadores muestran la mayor caída. - El cambio se aplica a todos los rangos de fechas, incluidos los históricos, porque Mintlify clasifica el tráfico al calcular el informe y no al almacenar los eventos. diff --git a/fr.json b/fr.json index 68fe489118..e61af1b1cc 100644 --- a/fr.json +++ b/fr.json @@ -465,7 +465,8 @@ "fr/help-center/static-file-not-served", "fr/help-center/preview-deployment-not-created-for-fork-branch", "fr/help-center/style-card-icons-with-custom-css", - "fr/help-center/can-i-rename-my-deployment-or-organization" + "fr/help-center/can-i-rename-my-deployment-or-organization", + "fr/help-center/visitor-count-dropped-after-crawler-filtering" ] } ] diff --git a/fr/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/fr/help-center/visitor-count-dropped-after-crawler-filtering.mdx index ce0f174afb..35272e8cea 100644 --- a/fr/help-center/visitor-count-dropped-after-crawler-filtering.mdx +++ b/fr/help-center/visitor-count-dropped-after-crawler-filtering.mdx @@ -6,13 +6,17 @@ keywords: ["visitor count dropped", "visitors lower than views", "more visitors En septembre 2026, Mintlify a changé la façon dont le tableau de bord analytics compte les visiteurs uniques. Les totaux de visiteurs excluent désormais le trafic des robots d'indexation de recherche, des robots d'entraînement d'IA et des autres bots, en appliquant le même filtrage que celui déjà utilisé pour les pages vues. Si votre nombre de visiteurs a chuté brusquement, ou si les chiffres historiques semblent plus bas qu'avant, ce changement en est la cause la plus probable. -## Ce qui a changé +
+ ## Ce qui a changé +
Avant cette mise à jour, le trafic des robots était exclu du comptage des pages vues, mais pas du comptage des visiteurs. Les robots gonflent les totaux de visiteurs bien plus que ceux des vues, car ils ne conservent pas les cookies. Mintlify ne peut donc pas reconnaître les requêtes répétées d'un même robot comme un seul visiteur. Sur les sites avec un trafic de robots important, cette inflation pouvait faire passer le nombre de visiteurs au-dessus du nombre de pages vues, ce qui est impossible avec du trafic de lecteurs réels. Le comptage des visiteurs utilise désormais la même classification des robots que les pages vues. Seuls les lecteurs humains et les agents IA comptent dans les totaux de visiteurs. -## À quoi s'attendre +
+ ## À quoi s'attendre +
- Les totaux de visiteurs sont plus bas sur la plupart des sites. Les sites recevant un trafic de robots important affichent la plus forte baisse. - Le changement s'applique à toutes les plages de dates, y compris historiques, car Mintlify classe le trafic au moment de calculer le rapport et non au moment de stocker les événements. diff --git a/zh.json b/zh.json index 13705e2def..c4a4259a01 100644 --- a/zh.json +++ b/zh.json @@ -465,7 +465,8 @@ "zh/help-center/static-file-not-served", "zh/help-center/preview-deployment-not-created-for-fork-branch", "zh/help-center/style-card-icons-with-custom-css", - "zh/help-center/can-i-rename-my-deployment-or-organization" + "zh/help-center/can-i-rename-my-deployment-or-organization", + "zh/help-center/visitor-count-dropped-after-crawler-filtering" ] } ] diff --git a/zh/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/zh/help-center/visitor-count-dropped-after-crawler-filtering.mdx index eb7ec62f63..c8de741e22 100644 --- a/zh/help-center/visitor-count-dropped-after-crawler-filtering.mdx +++ b/zh/help-center/visitor-count-dropped-after-crawler-filtering.mdx @@ -6,13 +6,17 @@ keywords: ["visitor count dropped", "visitors lower than views", "more visitors 2026 年 9 月,Mintlify 更改了分析仪表板统计独立访客的方式。访客总数现在会排除搜索索引爬虫、AI 训练爬虫和其他 bot 的流量,与页面浏览量已有的过滤规则保持一致。如果您的访客数骤降,或历史数据看起来比以前低,此变更是最可能的原因。 -## 变更内容 +
+ ## 变更内容 +
在此更新之前,爬虫流量已从页面浏览量统计中排除,但未从访客统计中排除。爬虫对访客总数的夸大程度远高于浏览量,因为爬虫不保留 cookie,Mintlify 无法将同一爬虫的重复请求识别为同一个访客。在爬虫流量较大的站点上,这种夸大可能使访客数超过页面浏览量,而真实读者流量不可能出现这种情况。 访客统计现在使用与页面浏览量相同的爬虫分类。只有人类读者和 AI agent 会计入访客总数。 -## 预期变化 +
+ ## 预期变化 +
- 大多数站点的访客总数会降低。爬虫流量较大的站点降幅最大。 - 该变更适用于所有日期范围,包括历史范围,因为 Mintlify 在生成报表时对流量进行分类,而不是在存储事件时分类。 From bd39192d0a6ab6f2d917ddf3e87c8ac9ec8549c5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 2 Sep 2026 00:14:01 +0000 Subject: [PATCH 3/6] Updated mintlify pages - Updated analytics/traffic.mdx Mintlify-Source: dashboard-editor --- analytics/traffic.mdx | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/analytics/traffic.mdx b/analytics/traffic.mdx index a2d9ade533..ab4f5f55b0 100644 --- a/analytics/traffic.mdx +++ b/analytics/traffic.mdx @@ -2,9 +2,17 @@ title: "Analyze documentation traffic" sidebarTitle: "Traffic" description: "Review traffic analytics to track visitors, page views, referrals, popular pages, and traffic from both human readers and AI agents." -keywords: ["analytics", "traffic", "page views", "visitors", "referrals", "agent views"] +keywords: + - "analytics" + - "traffic" + - "page views" + - "visitors" + - "referrals" + - "agent views" --- +/ + Analytics require a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=analytics). @@ -19,15 +27,14 @@ Review traffic analytics to: The Traffic view of the analytics page. - The Traffic view of the analytics page. From 9d7db49e82d528ae6d892c1a844ba09432880ce3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 2 Sep 2026 03:41:31 +0000 Subject: [PATCH 4/6] Updated mintlify pages - Updated analytics/traffic.mdx Mintlify-Source: dashboard-editor --- analytics/traffic.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/analytics/traffic.mdx b/analytics/traffic.mdx index ab4f5f55b0..b1e4a61b8f 100644 --- a/analytics/traffic.mdx +++ b/analytics/traffic.mdx @@ -11,8 +11,6 @@ keywords: - "agent views" --- -/ - Analytics require a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=analytics). From 614779a2003805199a87e418d7bfefe28b3f9827 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 3 Sep 2026 13:58:58 +0000 Subject: [PATCH 5/6] Updated mintlify pages - Updated analytics/traffic.mdx Mintlify-Source: dashboard-editor --- analytics/traffic.mdx | 36 +++++++++++------------------------- 1 file changed, 11 insertions(+), 25 deletions(-) diff --git a/analytics/traffic.mdx b/analytics/traffic.mdx index b1e4a61b8f..5760913860 100644 --- a/analytics/traffic.mdx +++ b/analytics/traffic.mdx @@ -15,13 +15,7 @@ keywords: Analytics require a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=analytics). -The **Traffic** view of the [analytics](https://app.mintlify.com/analytics) page displays total visitors, page views, assistant conversations, searches, and user feedback messages. - -Review traffic analytics to: - -- **Monitor traffic trends**: Observe changes in human and agent traffic after updates or new content to understand the impact of your changes. -- **Identify popular pages**: Use highly ranked pages to understand what content is most important to your users. Keep those pages up to date and comprehensive. -- **Track referral sources**: Understand where your users come from so you can optimize content for the right audience. +The **Traffic** view of the [analytics](https://app.mintlify.com/analytics) page shows visitors, page views, assistant conversations, searches, and feedback. Use it to monitor trends, identify popular pages, and track referral sources. - In September 2026, Mintlify updated visitor counts to use the same crawler filtering as page views. Visitor totals dropped on most sites, and the change applies to all date ranges. See [Why your visitor count dropped after crawler filtering](/help-center/visitor-count-dropped-after-crawler-filtering). + In September 2026, visitor counts adopted the same crawler filtering as page views, lowering visitor totals across all date ranges. See [Why your visitor count dropped](/help-center/visitor-count-dropped-after-crawler-filtering). ## Interpret agent views -Mintlify identifies agent visitors by IP address and user agent. The agent visitor count approximates distinct sources of AI traffic rather than individual agent sessions or conversations. Multiple requests from the same IP address count as one visitor. - - - Agent traffic measurement expanded in June 2026. Before then, the analytics dashboard only captured a subset of agent traffic. Starting June 8, 2026, Mintlify recognizes a broader set of agent user agents, counts agent HTML page views alongside Markdown requests, and serves Markdown to more agents. As a result, agent views increased across most sites around that date. This reflects improved measurement and agent access, not a sudden change in traffic. When comparing agent views over time, account for this shift. - - The size of the increase varies by site, since it depends on how much agent traffic each site receives. Sites that AI tools reference frequently show a larger increase than sites with less agent traffic. - +Mintlify identifies agent visitors by IP address and user agent, approximating distinct sources of AI traffic rather than individual sessions. Use agent views to see which AI platforms access your docs and how usage changes over time. -Use agent views to understand: +The agent breakdown groups traffic by provider (ChatGPT, Claude, Cursor, and others), with three catch-all buckets: -- **AI agent distribution**: See which AI platforms access your docs to learn which tools your users prefer. -- **Integration opportunities**: Identify which AI platforms to prioritize for optimization and testing. -- **AI traffic patterns**: Monitor which agents are most active and how their usage changes over time. - -The agent breakdown groups traffic by provider, such as ChatGPT, Claude, and Cursor. Three buckets capture the remaining agent traffic: - -- **HTTP clients**: Requests from tools and libraries such as curl, wget, and Python HTTP clients. +- **HTTP clients**: Tools and libraries such as curl, wget, and Python HTTP clients. - **Browser**: Markdown requests made from a web browser. - **Other**: Agent traffic that does not match a known provider or client. -Mintlify excludes its own internal traffic, such as link checking and page revalidation, from the agent breakdown. +Mintlify's own internal traffic (link checking, page revalidation) is excluded. + + + Agent traffic measurement expanded on June 8, 2026 to recognize more agent user agents and count agent HTML page views alongside Markdown requests. Agent views increased across most sites around that date, reflecting improved measurement rather than a traffic change. Account for this shift when comparing over time. + From 3eacd49cba69aab48d2fbdd65570443733577420 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 3 Sep 2026 18:09:01 +0000 Subject: [PATCH 6/6] Updated mintlify pages - Updated analytics/traffic.mdx Mintlify-Source: dashboard-editor --- analytics/traffic.mdx | 3 +++ 1 file changed, 3 insertions(+) diff --git a/analytics/traffic.mdx b/analytics/traffic.mdx index 5760913860..e22e31815f 100644 --- a/analytics/traffic.mdx +++ b/analytics/traffic.mdx @@ -11,6 +11,9 @@ keywords: - "agent views" --- + + + Analytics require a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=analytics).