# Concepts fondamentaux

Comprenez les concepts clés d'AI Data Stream : propriétés, connexions, conversations, annotations, rapports et équipes.

Ce guide explique les concepts fondamentaux avec lesquels vous travaillerez dans AI Data Stream.

## Propriétés

Une **propriété** représente un site web ou une application que vous souhaitez analyser. C'est le conteneur de toutes vos connexions de données, conversations et annotations.

### Ce que font les propriétés

- Regrouper les sources de données liées (par exemple, le GA4 + Search Console de votre site)
- Organiser les conversations et rapports par projet
- Contrôler l'accès de l'équipe au niveau de la propriété
- Stocker les annotations spécifiques à ce site web/application

### Créer des propriétés

1. Allez sur votre tableau de bord
2. Cliquez sur **Créer une propriété**
3. Entrez un nom (par exemple, "Site principal", "Application mobile", "Client : Acme Corp")
4. Ajoutez optionnellement l'URL du site web
5. Cliquez sur **Créer**

---

## Connexions

Une **connexion** lie une source de données à votre propriété. Chaque propriété peut avoir plusieurs connexions pour extraire des données de différentes plateformes.

### Connexions disponibles

- **Google Analytics 4** - Trafic du site, comportement, conversions
- **Google Search Console** - Performance de recherche organique, mots-clés
- **Google Ads** - Campagnes publicitaires, dépenses, conversions
- **PageSpeed Insights** - Core Web Vitals, scores de performance
- **WordPress** - Contenu et articles via l'API REST
- **GitHub** - Dépôts, commits, déploiements, issues, PRs
- **HubSpot** - Transactions CRM, contacts, entreprises
- **Pipedrive** - Pipeline de ventes, activités

Certaines connexions ne sont disponibles que sur certains plans. Voir [Plans et facturation](/fr/docs/plans-and-billing/) pour plus de détails.

### Fonctionnalités des connexions

- **Accès en lecture seule :** Nous ne modifions jamais vos données
- **Requêtes en temps réel :** Les données sont récupérées en direct, non stockées
- **Authentification OAuth :** Accès sécurisé et révocable
- **Basculement actif/inactif :** Mettez en pause les connexions sans les supprimer

Voir [Connexion des sources de données](/fr/docs/connecting-data-sources/) pour les détails de configuration.

---

## Conversations

Une **conversation** est une session de chat IA liée à une propriété. Vous posez des questions en langage naturel, et l'IA analyse vos sources de données connectées pour fournir des insights.

### Démarrer une conversation

1. Cliquez sur **Nouvelle conversation** depuis votre tableau de bord ou page de propriété
2. Sélectionnez les sources de données à inclure
3. Choisissez votre modèle d'IA
4. Tapez votre question et appuyez sur Envoyer

### Fonctionnalités des conversations

- **Mémoire contextuelle :** L'IA se souvient des messages précédents de la conversation
- **Requêtes multi-sources :** Posez des questions sur les données GA4 et Search Console ensemble
- **Prise en compte des annotations :** L'IA vérifie les annotations lors de l'analyse des tendances
- **Options d'export :** Copiez ou téléchargez l'historique de conversation

### Conseils pour de meilleures conversations

- Soyez précis sur les dates : "les 7 derniers jours" vs "novembre 2024"
- Mentionnez les métriques qui vous intéressent : "trafic", "conversions", "taux de rebond"
- Posez des questions de suivi pour approfondir
- Utilisez les [modèles de prompts](/fr/docs/prompt-presets/) pour des styles d'analyse cohérents

Voir [Utiliser le chat IA](/fr/docs/using-ai-chat/) pour plus de conseils.

---

## Annotations

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é.

### Pourquoi les annotations sont importantes

Quand vous demandez "Pourquoi le trafic a-t-il chuté la semaine dernière ?", l'IA vérifie vos annotations. Si vous avez noté "Site hors service pour maintenance le 5 mars", l'IA peut intégrer cela dans son analyse au lieu de spéculer.

### Types d'annotations

**Annotations manuelles** que vous créez :

- Lancements de campagnes marketing
- Refonte de site web
- Lancements de produits
- Problèmes ou pannes connus

**Annotations globales** issues des flux :

- Mises à jour d'algorithme Google (Core Updates, Spam Updates, etc.)
- Incidents de statut Google Search
- Événements globaux créés par les administrateurs

### Créer des annotations

1. Allez dans l'onglet **Annotations** de votre propriété
2. Cliquez sur **Ajouter une annotation**
3. Sélectionnez une date ou une plage de dates
4. Choisissez une catégorie
5. Rédigez votre note
6. Enregistrez

### Catégories d'annotations

Catégories intégrées :

- **Mise à jour d'algorithme** (violet) - Changements d'algorithme de recherche
- **Panne système** (rouge) - Interruptions de service

Vous pouvez créer des catégories personnalisées pour votre équipe.

Voir [Annotations](/fr/docs/annotations/) pour le guide complet.

---

## Rapports

Les **rapports** sont des modèles d'analyse structurés que vous pouvez exécuter à la demande. Ce sont comme des requêtes enregistrées qui produisent une sortie cohérente et formatée.

### Modèles de rapports intégrés

AI Data Stream inclut 12 modèles prêts à l'emploi :

**Exécution instantanée (aucune saisie requise) :**

- Performance mensuelle vs mois précédent
- Aperçu hebdomadaire du trafic
- Vérification rapide de santé
- Aperçu des performances SEO

**Avec champs de saisie :**

- Audit de page d'entrée
- Comparaison de dates personnalisées
- Rapport de performance du contenu
- Analyse approfondie des sources de trafic
- Analyse de performance des mots-clés

**E-commerce :**

- Revue hebdomadaire e-commerce
- Vérification de santé du tunnel d'achat
- Analyse de performance des promotions

### Exécuter un rapport

1. Allez dans **Rapports** dans votre propriété
2. Parcourez la bibliothèque de modèles
3. Sélectionnez un modèle
4. Remplissez les champs requis
5. Cliquez sur **Exécuter le rapport**

### Créer des rapports personnalisés

Vous pouvez créer vos propres modèles de rapports :

1. Cliquez sur **Créer un modèle**
2. Définissez les champs de saisie (optionnel)
3. Rédigez le modèle de prompt
4. Enregistrez dans votre bibliothèque

Voir [Rapports](/fr/docs/reports/) pour des informations détaillées.

---

## Équipes

Une **équipe** est un groupe d'utilisateurs qui partagent l'accès aux propriétés et aux données. Chaque compte commence avec une équipe personnelle.

### Rôles d'équipe

- **Propriétaire :** Le créateur du compte avec contrôle total
- **Administrateur :** Peut gérer les paramètres de l'équipe et inviter des membres
- **Membre :** Peut accéder aux propriétés assignées
- **Observateur :** Accès en lecture seule

Les rôles disponibles et la taille de l'équipe dépendent de votre plan. Voir [Plans et facturation](/fr/docs/plans-and-billing/) pour plus de détails.

### Permissions de propriété

Sur les plans supérieurs, vous pouvez définir des permissions par propriété :

- **Lecture :** Voir les données, conversations, annotations
- **Écriture :** Créer des annotations, exécuter des rapports, démarrer des conversations
- **Admin :** Gérer les connexions, modifier les paramètres de propriété

Voir [Gestion d'équipe](/fr/docs/team-management/) pour les instructions de configuration.

---

## Comment les concepts sont liés

```
Équipe (votre compte)
└── Fournisseurs d'IA (vos clés API)
└── Propriétés (sites web/applications)
    ├── Connexions (GA4, Search Console, etc.)
    ├── Conversations (sessions de chat IA)
    ├── Annotations (notes de chronologie)
    └── Rapports (modèles enregistrés)
```

### Exemple de configuration

Une agence marketing pourrait s'organiser ainsi :

```
Équipe : Agence Marketing Pro
├── Fournisseurs d'IA : Anthropic, Google
├── Propriété : Client A - Site principal
│   ├── GA4 + Search Console + Google Ads
│   └── Annotations : Lancements de campagnes, mises à jour du site
├── Propriété : Client A - Blog
│   ├── GA4 + Search Console
│   └── Annotations : Calendrier de contenu
└── Propriété : Client B - E-commerce
    ├── GA4 + Search Console + Google Ads
    └── Rapports : Revue e-commerce hebdomadaire
```

## Prochaines étapes

- [Connecter vos sources de données](/fr/docs/connecting-data-sources/)
- [Commencer à utiliser le chat IA](/fr/docs/using-ai-chat/)
- [Configurer votre équipe](/fr/docs/team-management/)
- [Créer des annotations](/fr/docs/annotations/)
