> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Outils Measure

> Analytics web hors IA issus des intégrations connectées : Google Search Console, Bing, revenus et référents analytics, et activité des crawlers IA.

<Note>
  Consultez [Compatibilité des filtres](/fr/mcp/tools/filters) pour le contrat de référence des filtres de dates de Measure et la couverture de chaque outil MCP.
</Note>

Les outils Measure présentent les analytics web connectés à côté des données de visibilité IA : performance de recherche, trafic référent IA classé, attribution de revenus prise en charge et occurrences observées de crawlers IA. Ils lisent les intégrations que vous connectez dans Qwairy, sous **Measure**.

<Note>
  **Connexion requise.** Chaque outil dépend de l’intégration correspondante : Google Search Console, Bing Webmaster Tools, un fournisseur d’analytics pris en charge ou Analytics des crawlers. Une fois les contrôles de scope OAuth, d’accès à la marque et d’offre ou de droits passés, une intégration absente est présentée comme non connectée, avec des données vides, pour que l’assistant puisse expliquer quoi connecter. Un scope manquant, un accès à la marque absent ou une inéligibilité au produit peuvent en revanche renvoyer une erreur.
</Note>

<Note>
  Tous les outils Measure exigent le scope `read:measure`. Les connexions OAuth créées avant l’existence de ce scope doivent se reconnecter pour les utiliser.
</Note>

<Note>
  Le MCP Qwairy renvoie le résultat de chaque outil sous forme de Markdown rendu dans `content[0].text` ; il n’inclut pas actuellement de `structuredContent` JSON. Les tableaux ci-dessous décrivent les valeurs affichées au lecteur, pas un schéma JSON stable. N’analysez pas ce Markdown comme un contrat de données applicatif.
</Note>

***

## get\_search\_console\_metrics

Performance Google Search Console du site de la marque : clics, impressions, CTR et position moyenne, ventilés par requête de recherche ou par page.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `dimension` | string | Non | `query` ou `page` (par défaut : `query`) |
| `period` | integer ou string | Non | Jours glissants (1 à 3650), `"all"` ou `"custom"` ; 30 jours par défaut |
| `startDate` / `endDate` | string | Non | Plage personnalisée incluse, au format `YYYY-MM-DD` |
| `days` | number | Non | Ancien alias de 1 à 365 jours ; à ne pas combiner avec `period` |
| `limit` | number | Non | Nombre maximal de lignes renvoyées (par défaut : 20, maximum : 100) |

### Résultat

| Champ | Description |
| - | - |
| `connected` | Indique si Google Search Console est connecté pour cette marque |
| `dimension` | La dimension utilisée (`query` ou `page`) |
| `dateRange` | `startDate`, `endDate` |
| `summary` | `totalClicks`, `totalImpressions`, `avgCtr` (%), `avgPosition` (pondérée par les impressions), `rowCount` |
| `rows[]` | Par requête ou par page : `key`, `clicks`, `impressions`, `ctr` (%), `position` |

### Exemples de prompts

```text theme={null}
Quelles sont mes principales requêtes Search Console ce mois-ci ?
```

```text theme={null}
Quelles pages ont le plus d’impressions de recherche mais un CTR faible ?
```

### Scope OAuth

Requis : `read:measure`

***

## get\_bing\_metrics

Performance de recherche Bing Webmaster Tools du site de la marque, par requête ou par page. Même structure que `get_search_console_metrics`, avec Bing comme source.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `dimension` | string | Non | `query` ou `page` (par défaut : `query`) |
| `period` | integer ou string | Non | Jours glissants (1 à 3650), `"all"` ou `"custom"` ; 30 jours par défaut |
| `startDate` / `endDate` | string | Non | Plage personnalisée incluse, au format `YYYY-MM-DD` |
| `days` | number | Non | Ancien alias de 1 à 365 jours ; à ne pas combiner avec `period` |
| `limit` | number | Non | Nombre maximal de lignes renvoyées (par défaut : 20, maximum : 100) |

### Résultat

| Champ | Description |
| - | - |
| `connected` | Indique si Bing Webmaster Tools est connecté pour cette marque |
| `dimension` | La dimension utilisée (`query` ou `page`) |
| `dateRange` | `startDate`, `endDate` |
| `summary` | `totalClicks`, `totalImpressions`, `avgCtr` (%), `avgPosition`, `rowCount` |
| `rows[]` | Par requête ou par page : `key`, `clicks`, `impressions`, `ctr` (%), `position` |

### Scope OAuth

Requis : `read:measure`

***

## get\_referrer\_analytics

Sessions Google Analytics classées à partir des référents IA reconnus, comparées au total des sessions du site sur le périmètre sélectionné.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Jours glissants (1 à 3650), `"all"` ou `"custom"` ; 30 jours par défaut |
| `startDate` / `endDate` | string | Non | Plage personnalisée incluse, au format `YYYY-MM-DD` |
| `days` | number | Non | Ancien alias de 1 à 365 jours ; à ne pas combiner avec `period` |
| `limit` | number | Non | Nombre maximal de sources et de pages d’atterrissage renvoyées (par défaut : 10, maximum : 50) |

### Résultat

| Champ | Description |
| - | - |
| `connected` | Indique si Google Analytics est connecté pour cette marque |
| `dateRange` | `startDate`, `endDate` |
| `summary` | `totalAiSessions`, `totalTrafficSessions`, `aiSharePct`, `avgBounceRate`, `avgSessionDuration` |
| `sources[]` | Par source IA : `name`, `sessions`, `bounceRate`, `pagesPerSession`, `newUsers` |
| `topLandingPages[]` | `path`, `sessions`, `topSource` |

### Exemples de prompts

```text theme={null}
Quelle part de mon trafic provient des assistants IA ?
```

```text theme={null}
Quelle source IA envoie les visiteurs les plus engagés ?
```

### Scope OAuth

Requis : `read:measure`

***

## get\_ai\_revenue

Conversions métier configurées et attribuées au trafic référent IA d’un fournisseur d’analytics connecté. L’outil sépare les revenus mesurés nativement par le fournisseur de la valeur estimée calculée à partir de vos définitions de conversion à valeur fixe.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Jours glissants (1 à 3650), `"all"` ou `"custom"` ; 30 jours par défaut |
| `startDate` / `endDate` | string | Non | Plage personnalisée incluse, au format `YYYY-MM-DD` |
| `days` | number | Non | Ancien alias de 1 à 365 jours ; à ne pas combiner avec `period` |
| `provider` | string | Non | `ga4`, `piwik_pro`, `matomo`, `piano` ou `adobe` ; par défaut, le fournisseur connecté configuré le plus récemment, puis GA4, Piwik PRO, Matomo, Piano ou Adobe dans cet ordre |
| `limit` | number | Non | Nombre maximal de sources et de pages d’atterrissage affichées (par défaut : 10 ; valeurs ramenées entre 1 et 50) ; les définitions de conversion ne sont pas limitées |

### Résultat

| Section du résultat | Valeurs affichées |
| - | - |
| En-tête | Nom de la marque, période sélectionnée et fournisseur |
| Résultats métier attribués à l’IA | Conversions, sessions IA, taux de conversion IA, taux de conversion du site, revenus mesurés et valeur estimée |
| Définitions de conversion | Libellé, type de source, conversions IA et site, revenus mesurés, valeur estimée et prise en compte dans les totaux |
| Conversions par source IA | Source, conversions, sessions, taux de conversion, revenus mesurés et valeur estimée |
| Principales pages de conversion | Chemin, conversions, revenus mesurés, valeur estimée et principale source |
| Avertissements | Avertissements de qualité des données ou d’agrégation qui affectent l’interprétation |

<Note>
  Si aucun fournisseur pris en charge n’est connecté, le résultat invite le lecteur à en connecter un et omet les sections d’indicateurs. Si un fournisseur est connecté mais que la période sélectionnée ne contient ni conversion incluse, ni revenu mesuré, ni valeur estimée, le résultat affiche un avis de période vide et des indicateurs à zéro. Ces deux états ne sont pas équivalents.
</Note>

<Note>
  Pour GA4, cet outil MCP utilise actuellement l’attribution Direct par session. Le tableau de bord utilise par défaut l’attribution Combined, qui se rabat d’une source de session IA sur une source de premier utilisateur IA. Alignez le mode d’attribution avant de comparer les totaux du MCP et du tableau de bord.
</Note>

<Note>
  Les revenus mesurés nativement par le fournisseur et les estimations à valeur fixe configurées sont distincts. Une valeur fixe est multipliée par les conversions IA et utilise la devise d’estimation configurée. Les revenus mesurés restent dans la devise du fournisseur, actuellement affichée sans code de devise. N’additionnez pas ces deux valeurs sans avoir vérifié séparément que leurs devises sont identiques.
</Note>

### Exemples de prompts

```text theme={null}
Combien de conversions configurées sont venues des référents IA le mois dernier ?
```

```text theme={null}
Compare les taux de conversion IA et site, en gardant les revenus mesurés séparés de la valeur estimée.
```

### Scope OAuth

Requis : `read:measure`

***

## get\_crawler\_activity

Lit les agrégats de cycle de vie conservés, à l’échelle du site, pour les identités User-Agent propres à l’IA observables et prises en charge, comme GPTBot, ClaudeBot, PerplexityBot et OAI-SearchBot. Cet outil n’expose pas les journaux HTTP bruts et n’établit ni la raison d’une requête, ni l’indexation d’un contenu, ni le lien de cause entre une occurrence et une réponse ultérieure.

<Note>
  `Google-Extended` est un jeton de contrôle robots, pas un User-Agent de crawler observable séparément. Une règle robots.txt pour ce jeton ne crée aucune occurrence dans Analytics des crawlers.
</Note>

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |

### Résultat

| Champ | Description |
| - | - |
| `connected` | Indique si l’intégration est active, non désactivée, et dispose d’au moins une clé d’API active |
| `lifecycle` | État de l’intégration : `PENDING`, `ACTIVE`, `PAUSED`, `DISABLED` ou `null` |
| `health` | Valeur de santé actuelle de l’intégration, ou `null` si elle n’est pas disponible |
| `crawlers[]` | Agrégat conservé par robot : `bot`, `firstSeen`, `lastSeen` et `occurrences` sur toute la durée |
| `totalBotsSeen` | Nombre de crawlers IA reconnus distincts dans l’agrégat conservé |
| `hasObservations` | Indique si au moins une observation de crawler reconnu est conservée |
| `dataStatus` | `observed` lorsque des observations de crawlers existent ; sinon `not_measured` |
| `rawEventsAvailable` | Toujours `false` ; les événements de requête bruts ne sont ni renvoyés ni conservés pour cet outil |

<Note>
  `firstSeen`, `lastSeen` et `occurrences` décrivent des agrégats conservés, pas un historique de journaux bruts interrogeable. Considérez-les uniquement comme des observations, sans en déduire d’indexation, d’entraînement de modèle, de citation ni de causalité.
</Note>

### Exemples de prompts

```text theme={null}
Quelles identités de crawlers figurent dans mon agrégat d’activité conservé ?
```

```text theme={null}
Quels sont les horodatages de première et de dernière observation de ClaudeBot ?
```

### Scope OAuth

Requis : `read:measure`

***

## get\_page\_performance

Occurrences de crawlers IA observées par page, avec l’état de cycle de vie et les principales identités de crawlers prises en charge pour chaque page affichée. Complète `get_crawler_activity` par une vue des synthèses conservées au niveau de la page.

<Info>
  Cet outil exige une offre Business, Enterprise ou Agency Business active, ou une activation explicite de la fonctionnalité Analytics des crawlers, en plus de `read:measure` et de l’accès à une marque active.
</Info>

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Nombre de 1 à 30, `"all"` ou `"custom"` ; 30 jours par défaut ; les périodes numériques et `"all"` se terminent la veille (jour UTC), et `"all"` correspond exactement à 30 jours |
| `startDate` / `endDate` | string | Non | Plage personnalisée incluse au format `YYYY-MM-DD`, 30 jours au maximum ; une plage valide plus ancienne peut ne contenir aucune synthèse de page conservée |
| `days` | number | Non | Ancien alias de 1 à 30 jours ; à ne pas combiner avec `period` |
| `limit` | number | Non | Nombre maximal de pages non délaissées renvoyées (1 à 100, 20 par défaut) |

### Résultat

| Section du résultat | Valeurs affichées |
| - | - |
| En-tête | Nom de la marque, période sélectionnée et périmètre des synthèses quotidiennes |
| Synthèse | Occurrences observées, inventaire durable des identités de pages et identités de crawlers prises en charge observées |
| Réserves de couverture | Avertissements d’ingestion incomplète, de continuité non vérifiée ou de livraison au moins une fois, le cas échéant |
| Pages actuelles | Libellé de la page, état de cycle de vie, occurrences sur la période, date de dernière observation et jusqu’à 5 principales identités de crawlers |
| Pages délaissées | Jusqu’à 10 identités de pages, date de dernière observation et nombre d’occurrences sur toute la durée |

<Note>
  Le nombre de pages de la synthèse correspond à l’inventaire durable des identités de pages avant `limit`, y compris les identités délaissées et celles sans occurrence sur la période sélectionnée. Ce n’est ni `pages.length` ni le nombre de pages qui portent les occurrences affichées.
</Note>

<Note>
  La requête des pages actuelles sélectionne d’abord jusqu’à `limit` identités selon leurs occurrences sur la période, puis retire les identités délaissées : le tableau affiché peut donc contenir moins de `limit` lignes. Le tableau des pages délaissées provient d’une requête distincte triée par `lastSeenAt` le plus ancien, et peut être non vide même si la période sélectionnée n’a aucune synthèse.
</Note>

<Note>
  Pour être connecté, Analytics des crawlers doit être actif, non désactivé, et disposer d’une clé active non révoquée. Aucun événement HTTP n’est conservé ni renvoyé. Les chemins d’apparence sensible ou trop longs peuvent être pseudonymisés : ne les reconstituez pas, ne les reliez pas, et attendez-vous à ce que ces lignes n’aient pas de titre.
</Note>

### Exemples de prompts

```text theme={null}
Quelles pages ont le plus d’occurrences de crawlers IA observées sur la période conservée ?
```

### Scope OAuth

Requis : `read:measure`

***

## Pages associées

Chaque outil ci-dessus correspond à une page du tableau de bord dans la section **Measure** :

* [Google Search Console](/fr/documentation/measure/google-search-console) : `get_search_console_metrics`
* [Bing Webmaster Tools](/fr/documentation/measure/bing-webmaster) : `get_bing_metrics`
* [Analytics des référents](/fr/documentation/measure/referrer-analytics) : `get_referrer_analytics`
* [Revenus IA](/fr/documentation/measure/ai-revenue) : `get_ai_revenue`
* [Analytics des crawlers](/fr/documentation/measure/crawler-analytics) : `get_crawler_activity`
* [Performance des pages](/fr/documentation/measure/page-performance) : `get_page_performance`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.