# Annotations

Ajoutez du contexte à vos données avec des annotations de chronologie pour une meilleure analyse IA.

Les annotations sont des notes attachées à des dates dans la chronologie de votre propriété. Elles aident l'IA à comprendre pourquoi les métriques ont changé et fournissent du contexte pour une meilleure analyse.

## Pourquoi les annotations sont importantes

Quand vous demandez "Pourquoi le trafic a-t-il chuté la semaine dernière ?", l'IA a deux options :

**Sans annotations :** Spéculer sur la base de modèles ("Peut-être qu'il y a eu un problème technique...")

**Avec annotations :** Fournir du contexte ("Selon votre annotation, le site était en maintenance le 15 mars, ce qui explique l'interruption de trafic de 4 heures...")

Les annotations transforment les suppositions en analyse informée.

---

## Types d'annotations

### Annotations manuelles

Annotations que vous créez pour votre propriété :

- **Événements marketing :** Lancements de campagnes, envois d'emails, promotions
- **Changements de site :** Refontes, nouvelles fonctionnalités, mises à jour de pages
- **Événements techniques :** Déploiements, pannes, migrations
- **Événements business :** Lancements de produits, changements de prix
- **Facteurs externes :** Jours fériés, événements du secteur, couverture presse

### Annotations globales

Annotations issues de flux qui affectent toutes les propriétés :

- **Mises à jour d'algorithme :** Google Core Updates, Spam Updates, etc.
- **Pannes de plateforme :** Incidents Google Search, problèmes GA4
- **Événements du secteur :** Annonces majeures affectant de nombreux sites

Les annotations globales sont fournies par AI Data Stream et automatiquement disponibles pour toutes les propriétés.

---

## Créer des annotations

### Ajouter une annotation manuelle

1. Allez dans l'onglet **Annotations** de votre propriété
2. Cliquez sur **Ajouter une annotation**
3. Sélectionnez la date (ou plage de dates pour les événements multi-jours)
4. Choisissez une catégorie
5. Entrez votre note
6. Optionnel : Sélectionnez les pages affectées (ou laissez vide pour tout le site)
7. Cliquez sur **Enregistrer**

### Champs d'annotation

| Champ | Description |
|-------|-------------|
| **Date** | Date unique ou plage de dates |
| **Catégorie** | Type d'annotation (pour le filtrage) |
| **Note** | Ce qui s'est passé (restez concis) |
| **Pages** | URLs spécifiques affectées (optionnel) |
| **Visibilité** | Privée (vous seul) ou partagée (équipe) |

### Rédiger de bonnes notes

**Trop vague :**

> Mise à jour du site

**Mieux :**

> Lancé nouveau flux de paiement - simplifié de 4 étapes à 2

**Idéal :**

> Refonte du paiement lancée : 4 étapes → 2, suppression de l'obligation de compte, ajout du paiement invité

Incluez ce qui a changé et pourquoi c'est important pour l'analyse.

---

## Catégories d'annotations

Les catégories vous aident à organiser et filtrer les annotations. Chaque catégorie a un nom, une couleur et une icône optionnelle.

### Catégories intégrées

- **Mise à jour d'algorithme** - Google Core Updates, Spam updates, changements de classement
- **Panne système** - Temps d'arrêt de plateforme, problèmes API, problèmes d'hébergement

### Catégories personnalisées

Créez des catégories pour les besoins de votre équipe :

1. Allez dans **Annotations → Gérer les catégories**
2. Cliquez sur **Créer une catégorie**
3. Entrez un nom
4. Choisissez une couleur et une icône
5. Enregistrez

**Catégories personnalisées courantes :**

- Campagne marketing
- Changement de site
- Lancement de produit
- Mise à jour de contenu
- Correction de bug

---

## Flux d'annotations globales

AI Data Stream maintient des flux globaux qui ajoutent automatiquement des annotations à vos propriétés.

### Flux disponibles

**Mises à jour d'algorithme Google**

- Source : Search Engine Land, annonces officielles Google
- Inclut : Core Updates, Spam Updates, Product Reviews, etc.
- Mises à jour : Automatiquement quand de nouvelles mises à jour sont confirmées

**Statut Google Search**

- Source : Google Search Status Dashboard
- Inclut : Problèmes de crawl, problèmes d'indexation, problèmes de classement
- Mises à jour : En temps réel quand des incidents surviennent

### Gérer les flux globaux

Chaque propriété peut activer ou désactiver les flux globaux :

1. Allez dans la page **Paramètres** de votre propriété
2. Trouvez la section **Annotations globales**
3. Basculez le commutateur principal pour afficher/masquer les annotations globales
4. Activez ou désactivez les flux individuels selon les besoins
5. Enregistrez

Vous pourriez désactiver les flux de mise à jour d'algorithme pour une propriété qui ne dépend pas de la recherche organique.

### Mises à jour d'algorithme historiques

Le flux d'algorithme inclut des mises à jour remontant à 2018 :

- Mise à jour Spam août 2025
- Core Update juin 2025
- Core Update mars 2025
- Core Update décembre 2024
- Et plus de 50 autres mises à jour historiques

Cela signifie que vous pouvez analyser des données historiques avec le contexte d'algorithme déjà en place.

---

## Utiliser les annotations dans l'analyse

### Vérification automatique

Tous les modèles de prompts indiquent à l'IA de vérifier les annotations avant d'analyser les données temporelles. Vous n'avez pas besoin de mentionner les annotations — l'IA le fait automatiquement.

**Vous demandez :**

> Pourquoi le trafic organique a-t-il chuté en mars ?

**L'IA vérifie :**

- Annotations pour mars
- Mises à jour d'algorithme globales en mars
- Données Search Console
- Données GA4

**L'IA répond :**

> Le trafic organique a chuté de 23 % en mars. En regardant vos annotations, je vois que le Core Update de mars 2025 s'est déployé du 5 au 12 mars. Votre baisse de trafic correspond à cette période de mise à jour...

### Référencer les annotations dans les questions

Vous pouvez aussi référencer explicitement les annotations :

- "Quelles annotations ai-je pour le dernier trimestre ?"
- "Vérifie si des mises à jour d'algorithme ont affecté mon trafic en décembre"
- "Prends en compte la migration du site lors de l'analyse de la performance du T1"

---

## Synchroniser les annotations vers GA4

Si vous avez Google Analytics 4 connecté, vous pouvez synchroniser des annotations individuelles vers GA4.

### Comment ça fonctionne

Lors de la création ou modification d'une annotation, vous verrez une option "Synchroniser vers GA4" si GA4 est connecté. Activez-la pour pousser cette annotation vers la fonctionnalité d'annotation de GA4. Cela garde votre propriété GA4 synchronisée si votre équipe travaille aussi directement dans Google Analytics.

### Limitations

- Les annotations GA4 ont une limite de 150 caractères
- Nécessite une connexion GA4 avec accès en écriture
- **Les suppressions ne se synchronisent pas :** Si vous supprimez une annotation dans AI Data Stream qui a été synchronisée vers GA4, vous devrez la supprimer manuellement dans Google Analytics (l'API ne supporte pas la suppression)

Vous pouvez aussi importer des annotations de GA4 vers AI Data Stream.

---

## Bonnes pratiques pour les annotations

### Annotez de manière cohérente

Créez une habitude :

- Enregistrez les campagnes marketing au lancement
- Notez les changements de site lors des déploiements
- Documentez les problèmes connus quand ils surviennent

Ne comptez pas sur la mémoire — annotez en temps réel.

### Soyez précis sur les dates

- Utilisez des dates exactes quand connues
- Utilisez des plages de dates pour les déploiements ("Lancé le 5 mars, terminé le 7 mars")
- Notez les fuseaux horaires si pertinent

### Incluez les pages affectées

Pour les changements spécifiques à des pages, notez quelles pages :

- "/blog/\*" pour tous les changements de blog
- "/produits/widget" pour les changements de produit spécifique
- Laissez vide pour les changements sur tout le site

### Gardez les notes scannables

L'IA et votre équipe liront ces notes. Rédigez clairement :

- Commencez par ce qui a changé
- Ajoutez un bref contexte si nécessaire
- Évitez les détails évidents

### Révisez régulièrement

Passez en revue les annotations périodiquement :

- Archivez les anciennes annotations qui ne sont plus pertinentes
- Mettez à jour les campagnes en cours
- Ajoutez les événements manqués

---

## Gérer les annotations

### Voir les annotations

Allez dans **Annotations** dans votre propriété pour voir :

- Vue chronologique de toutes les annotations
- Filtrage par catégorie
- Filtrage par plage de dates
- Recherche dans les notes

### Modifier les annotations

1. Trouvez l'annotation dans la liste
2. Cliquez sur l'icône de modification
3. Faites les changements dans la modale
4. Enregistrez

### Archiver les annotations

L'archivage supprime les annotations du contexte IA tout en préservant l'enregistrement :

1. Trouvez l'annotation dans la liste
2. Cliquez sur l'icône de suppression/archivage
3. Confirmez

Les annotations archivées sont exclues de l'analyse IA mais peuvent être restaurées plus tard.

### Restaurer les annotations archivées

1. Allez dans **Annotations**
2. Cliquez sur **Voir archivées** pour voir les annotations archivées
3. Trouvez l'annotation à restaurer
4. Cliquez sur **Restaurer**

L'annotation revient au statut actif et sera à nouveau incluse dans l'analyse IA.

---

## Dépannage

### L'IA ne mentionne pas mes annotations

- Vérifiez que la date de l'annotation correspond à votre plage de dates de requête
- Vérifiez que l'annotation est enregistrée (pas juste en brouillon)
- Assurez-vous que la visibilité de l'annotation inclut votre compte

### Les flux globaux n'apparaissent pas

- Vérifiez que les flux sont activés pour cette propriété
- Les flux globaux peuvent prendre jusqu'à 24 heures pour synchroniser les nouveaux événements
- Vérifiez la connectivité internet

### Trop d'annotations encombrent l'analyse

- Utilisez les catégories pour organiser
- Archivez les annotations qui ne sont plus pertinentes (elles peuvent être restaurées plus tard)
- Soyez sélectif sur ce que vous annotez

## Prochaines étapes

- [Découvrir les rapports](/fr/docs/reports/)
- [Explorer les modèles de prompts](/fr/docs/prompt-presets/)
- [Utiliser le chat IA](/fr/docs/using-ai-chat/)
