# Connexion des sources de données

Apprenez à connecter Google Analytics 4, Search Console, Google Ads, GitHub et d'autres plateformes à AI Data Stream.

AI Data Stream se connecte à vos plateformes d'analyse et de marketing pour que l'IA puisse analyser vos données en temps réel. Ce guide couvre chaque type de connexion.

## Aperçu des connexions

| Source de données | Gratuit | Pro | Business | Authentification |
|-------------------|---------|-----|----------|------------------|
| Google Analytics 4 | Oui | Oui | Oui | OAuth |
| Google Search Console | Oui | Oui | Oui | OAuth |
| PageSpeed Insights | Oui | Oui | Oui | Aucune (public) |
| Google Ads | - | Oui | Oui | OAuth |
| WordPress | - | Oui | Oui | Mot de passe d'application |
| HubSpot | - | - | Oui | Token d'application privée |
| GitHub | - | Oui | Oui | OAuth / Token d'accès personnel |
| Pipedrive | - | - | Oui | Clé API |

Toutes les connexions sont **en lecture seule**. Nous ne modifions jamais vos données.

---

## Google Analytics 4

GA4 est la connexion la plus courante. Elle fournit le trafic du site web, le comportement utilisateur, les conversions et les données e-commerce.

### Connecter GA4

1. Allez dans votre propriété et cliquez sur **Ajouter une connexion**
2. Sélectionnez **Google Analytics 4**
3. Cliquez sur **Se connecter avec Google**
4. Connectez-vous avec votre compte Google (utilisez le compte qui a accès à GA4)
5. Examinez les permissions et cliquez sur **Autoriser**
6. Sélectionnez les propriétés GA4 à connecter
7. Cliquez sur **Confirmer**

### Ce que nous accédons

- **Métriques de trafic :** Sessions, utilisateurs, pages vues, taux de rebond
- **Données d'acquisition :** Sources de trafic, campagnes, références
- **Comportement :** Pages par session, durée moyenne de session
- **Conversions :** Objectifs, événements, transactions e-commerce
- **Démographie :** Pays, appareil, navigateur

### Permissions requises

Nous demandons :

- `analytics.readonly` - Accès en lecture seule à vos données Analytics

Nous NE demandons PAS l'accès en écriture.

### Dépannage

**"Aucune propriété trouvée"**

- Assurez-vous de vous connecter avec le bon compte Google
- Vérifiez que votre compte a au moins un accès Lecteur à la propriété GA4

**"Accès refusé"**

- Le propriétaire du compte peut avoir besoin de vous accorder l'accès dans Administration GA4 → Accès à la propriété

---

## Google Search Console

Search Console fournit les données de recherche organique : clics, impressions, mots-clés et classements de pages.

### Connecter Search Console

1. Allez dans votre propriété et cliquez sur **Ajouter une connexion**
2. Sélectionnez **Google Search Console**
3. Cliquez sur **Se connecter avec Google**
4. Autorisez l'accès
5. Sélectionnez les propriétés Search Console à connecter

### Types de propriétés

Search Console a deux types de propriétés :

- **Propriétés de domaine** (par exemple, `exemple.com`) - Inclut tous les sous-domaines
- **Propriétés de préfixe d'URL** (par exemple, `https://www.exemple.com/`) - URLs spécifiques uniquement

Les deux fonctionnent avec AI Data Stream. Choisissez celle que vous avez configurée.

### Ce que nous accédons

- **Performance de recherche :** Clics, impressions, CTR, position moyenne
- **Données de requêtes :** Mots-clés générant du trafic
- **Données de pages :** Quelles pages sont classées et obtiennent des clics
- **Répartition par appareil :** Performance mobile, desktop, tablette

---

## PageSpeed Insights

PageSpeed fournit les Core Web Vitals et les scores de performance. Aucune authentification requise — il utilise des données publiques.

### Connecter PageSpeed

1. Allez dans votre propriété et cliquez sur **Ajouter une connexion**
2. Sélectionnez **PageSpeed Insights**
3. Entrez l'URL de votre site web
4. Cliquez sur **Connecter**

### Ce que nous accédons

- **Scores Lighthouse :** Performance, Accessibilité, Bonnes pratiques, SEO
- **Core Web Vitals :** LCP, FID, CLS
- **Métriques de performance :** Speed Index, Time to Interactive
- **Opportunités :** Améliorations suggérées

---

## Google Ads

Disponible sur les **plans Pro et Business**. Connectez votre compte Google Ads pour analyser les performances des campagnes.

### Avant de vous connecter

L'accès à l'API Google Ads nécessite une approbation de Google. Si ce n'est pas déjà fait :

1. Votre compte Google Ads doit être en règle
2. L'accès API est généralement auto-approuvé pour les comptes standard
3. Les comptes MCC (Manager) peuvent connecter tous les sous-comptes

### Connecter Google Ads

1. Allez dans votre propriété et cliquez sur **Ajouter une connexion**
2. Sélectionnez **Google Ads**
3. Cliquez sur **Se connecter avec Google**
4. Connectez-vous avec votre compte Google Ads
5. Sélectionnez les comptes à connecter (si vous en avez plusieurs)
6. Cliquez sur **Confirmer**

### Ce que nous accédons

- **Performance des campagnes :** Impressions, clics, conversions, coût
- **Données des groupes d'annonces :** Performance par groupe d'annonces
- **Données des mots-clés :** Termes de recherche, Quality Score
- **Suivi des conversions :** Objectifs et valeurs
- **Budget et dépenses :** Dépenses actuelles vs budget

---

## WordPress

Disponible sur les **plans Pro et Business**. Connectez WordPress pour inclure les données de contenu dans votre analyse.

### Connecter WordPress

Fonctionne avec tout site WordPress exécutant la version 5.6 ou ultérieure (les mots de passe d'application sont intégrés).

1. Allez dans votre propriété et cliquez sur **Ajouter une connexion**
2. Sélectionnez **WordPress**
3. Entrez l'URL de votre site WordPress
4. Générez un mot de passe d'application dans WordPress :
   - Allez dans Administration WordPress → Utilisateurs → Votre profil
   - Faites défiler jusqu'à "Mots de passe d'application"
   - Entrez "AI Data Stream" comme nom d'application
   - Cliquez sur "Ajouter un nouveau mot de passe d'application"
   - Copiez le mot de passe (vous ne le reverrez plus)
5. Entrez votre nom d'utilisateur WordPress et collez le mot de passe d'application
6. Cliquez sur **Connecter**

### Ce que nous accédons

- **Contenu :** Articles, pages, types de publication personnalisés
- **Catégories et tags :** Organisation du contenu
- **Auteurs :** Qui a publié quoi
- **Dates :** Dates de publication et de modification

---

## GitHub

Disponible sur les **plans Pro et Business**. Connectez un dépôt GitHub pour corréler les changements de code, déploiements et releases avec vos données analytiques.

### Options d'authentification

GitHub supporte deux méthodes d'authentification :

**Option A : OAuth (recommandé)**

1. Allez dans votre propriété et cliquez sur **Ajouter une connexion**
2. Sélectionnez **GitHub**
3. Cliquez sur **Se connecter avec GitHub**
4. Autorisez AI Data Stream à accéder à vos dépôts
5. Entrez le propriétaire et le nom du dépôt
6. Cliquez sur **Confirmer**

**Option B : Token d'accès personnel**

1. Allez sur [github.com/settings/tokens](https://github.com/settings/tokens)
2. Cliquez sur **Generate new token (classic)**
3. Nommez-le "AI Data Stream"
4. Sélectionnez le scope `repo`
5. Cliquez sur **Generate token** et copiez-le
6. Dans AI Data Stream, sélectionnez **GitHub** et choisissez **Token d'accès personnel**
7. Collez le token, entrez le propriétaire et le nom du dépôt
8. Cliquez sur **Connecter**

### Ce que nous accédons

- **Aperçu du dépôt :** Langage, étoiles, forks, visibilité, licence, sujets
- **Releases :** Noms de tags, dates de publication, notes de release
- **Commits récents :** Messages de commit, auteurs, dates (filtrable par branche, plage de dates ou auteur)
- **Activité des commits :** Fréquence hebdomadaire des commits sur les 52 dernières semaines
- **Déploiements :** Déploiements production/staging avec statut et environnement
- **Issues :** Issues ouvertes/fermées avec labels, assignés, horodatages
- **Pull requests :** PRs fusionnées/ouvertes/fermées avec infos de branche, dates de fusion et labels

### Configuration des outils

Chaque outil GitHub peut être activé ou désactivé individuellement dans les paramètres de connexion. L'aperçu du dépôt est toujours disponible ; les six autres outils (releases, commits, activité des commits, déploiements, issues, pull requests) peuvent être basculés selon vos besoins.

### Cas d'utilisation

GitHub est particulièrement puissant combiné avec les données analytiques :

- **Corrélation de déploiement :** "La baisse de trafic coïncide-t-elle avec un déploiement ?"
- **Impact des releases :** "Comment le trafic a-t-il évolué après la release v2.0 ?"
- **Suivi des bugs :** "Y a-t-il des issues ouvertes qui pourraient expliquer la baisse de conversion ?"
- **Vélocité de développement :** "Comment la fréquence de nos commits se compare-t-elle à la croissance du trafic ?"

---

## HubSpot

Disponible sur les **plans Business**. Connectez HubSpot CRM pour analyser les transactions, contacts et la santé du pipeline.

### Créer un token d'application privée

1. Connectez-vous à votre compte HubSpot
2. Allez dans **Paramètres → Intégrations → Applications privées**
3. Cliquez sur **Créer une application privée**
4. Nommez-la "AI Data Stream"
5. Sous **Scopes**, accordez l'accès en lecture à : CRM (contacts, entreprises, transactions), Ventes (activités, pipelines)
6. Cliquez sur **Créer l'application**
7. Copiez le token d'accès

### Connecter HubSpot

1. Allez dans votre propriété et cliquez sur **Ajouter une connexion**
2. Sélectionnez **HubSpot**
3. Collez votre token d'accès d'application privée
4. Cliquez sur **Connecter**

### Ce que nous accédons

- **Transactions :** Pipeline, étapes, valeurs, dates de clôture
- **Contacts :** Sources de leads, étapes du cycle de vie
- **Entreprises :** Transactions et contacts associés
- **Activités :** Tâches, appels, emails enregistrés
- **Métriques du pipeline :** Taux de gain, vélocité des transactions

---

## Pipedrive

Disponible sur les **plans Business**. Connectez Pipedrive pour analyser votre pipeline de ventes et vos activités.

### Connecter Pipedrive

1. Allez dans votre propriété et cliquez sur **Ajouter une connexion**
2. Sélectionnez **Pipedrive**
3. Entrez votre token API Pipedrive :
   - Dans Pipedrive : Paramètres → Préférences personnelles → API
   - Copiez votre token API personnel
4. Collez le token dans AI Data Stream
5. Cliquez sur **Connecter**

### Ce que nous accédons

- **Transactions :** Étapes du pipeline, valeurs, probabilités
- **Activités :** Appels, réunions, tâches
- **Personnes et organisations :** Données de contact
- **Santé du pipeline :** Taux de conversion, vieillissement des transactions
- **Produits :** Si vous utilisez les produits Pipedrive

---

## Gérer les connexions

### Voir le statut des connexions

Chaque connexion affiche :

- Basculement **Actif/Inactif**
- Horodatage **Dernière synchronisation**
- **Statut d'erreur** en cas de problèmes

### Rafraîchir les connexions

Les données sont interrogées en temps réel, mais si vous devez rafraîchir les tokens OAuth :

1. Allez dans l'onglet **Connexions** de votre propriété
2. Cliquez sur la connexion à rafraîchir
3. Cliquez sur **Reconnecter** pour vous ré-authentifier

### Supprimer des connexions

1. Allez dans **Connexions**
2. Cliquez sur la connexion à supprimer
3. Cliquez sur **Supprimer la connexion**
4. Confirmez la suppression

Cela n'affecte pas vos données dans la plateforme d'origine.

### Paramètres de connexion

Chaque connexion dispose de paramètres qui contrôlent comment elle apparaît dans l'application :

**Afficher sur le tableau de bord**

- Basculez si les widgets de cette connexion apparaissent sur le tableau de bord de votre propriété
- Utile pour masquer les connexions que vous n'avez pas besoin de surveiller quotidiennement

**Afficher dans le chat**

- Basculez si cette connexion est activée par défaut dans le Chat IA
- Lorsqu'elle est désactivée, l'IA n'interrogera pas cette source de données sauf si vous l'activez manuellement dans une conversation
- Aide à réduire le contexte et à se concentrer sur des sources de données spécifiques
- Vous pouvez toujours remplacer ces paramètres par défaut dans les conversations individuelles

Pour modifier ces paramètres :

1. Allez dans l'onglet **Connexions** de votre propriété
2. Trouvez la connexion que vous souhaitez configurer
3. Cliquez sur l'icône du tableau de bord (📊) pour basculer la visibilité du tableau de bord
4. Cliquez sur l'icône du chat (💬) pour basculer la visibilité du chat
5. Ou cliquez sur **Modifier** pour plus d'options

---

## Dépannage

### Erreurs OAuth

**"Token d'accès expiré"**

- Cliquez sur **Reconnecter** pour vous ré-authentifier

**"Permissions insuffisantes"**

- Assurez-vous que votre compte a le niveau d'accès requis
- Pour GA4/GSC : Au moins le rôle Lecteur
- Pour Google Ads : Accès Standard ou Admin

### Délais d'expiration de connexion

**"Connexion expirée"**

- Les grands ensembles de données peuvent prendre plus de temps
- Essayez de demander une plage de dates plus courte

### Données non affichées

**"Aucune donnée trouvée"**

- Vérifiez que la plage de dates contient des données
- Vérifiez que la bonne propriété est connectée
- Pour les nouvelles connexions, attendez quelques minutes pour la synchronisation initiale

### Limites de taux

**"Limite de taux dépassée"**

- Trop de requêtes vers la plateforme
- Attendez quelques minutes et réessayez
- Envisagez de combiner les requêtes

## Prochaines étapes

- [Démarrer une conversation avec vos données](/fr/docs/using-ai-chat/)
- [Ajouter des annotations pour le contexte](/fr/docs/annotations/)
- [Exécuter des rapports sur vos données](/fr/docs/reports/)