# Extension Chrome DURUM.ai

L'extension Chrome DURUM.ai affiche vos données CRM réelles directement dans le tableau de Meta Ads Manager, sans changer d'onglet ni exporter de rapports.

---

## Ce que ça fait

À côté de chaque campagne, adset et ad dans Meta Ads Manager, vous voyez vos colonnes DURUM.ai, calculées sur vos événements CRM et non sur les conversions estimées de Meta :

| Famille | Colonnes disponibles |
|---------|----------------------|
| Dépense et trafic | `Spend`, `Impressions`, `Clics`, `CTR`, `CPC` |
| Leads | `Leads`, `Applications`, `CPL` (coût par lead), `Coût par application` |
| Rendez-vous | `Bookings`, `Coût par booking`, `Meetings`, `No-shows`, `Annulations`, `Taux de no-show`, `Taux de show`, `Taux d'annulation` |
| Ventes | `Ventes`, `Revenu`, `Ticket moyen`, `ROAS`, `CPA`, `Taux de closing`, `Lead vers vente`, `Booking vers vente` |
| Appels et qualité | `Appels`, `Score ICP` |

Chaque ligne reçoit aussi un **score de santé** (0 à 100) et, quand une recommandation d'Insight DURUM concerne cette entité, un **badge de recommandation** (fatigue créative, scaling, pause).

**Drill-down par contact** : un clic sur un chiffre (leads, bookings, ventes) ouvre le panneau latéral avec la liste des contacts qui composent ce chiffre. Un clic sur un contact affiche son identité, sa timeline d'événements, son attribution Meta (`ad_id`, campagne, UTM), ses appels analysés et les objections détectées.

La barre supérieure de l'extension ajoute :

- Le sélecteur de **modèle d'attribution** : Hybride DURUM (défaut), Linéaire, First Touch, Last Touch, Position (40-20-40)
- Le sélecteur de **client actif** (agences qui gèrent plusieurs comptes)
- La **période de comparaison** : aucune, ou les 7, 14, 30 ou 90 jours précédents
- Le bouton **Actualiser** pour forcer une resynchronisation
- Le **sélecteur de colonnes** : choisissez quelles métriques DURUM.ai apparaissent dans le tableau

---

## Installation

L'extension vous est fournie par votre gestionnaire de compte, soit par le Chrome Web Store (fiche DURUM.ai) lorsque la version y est disponible, soit sous forme de fichier ZIP à charger vous-même.

**Depuis le Chrome Web Store**

1. Ouvrez la fiche DURUM.ai transmise par votre gestionnaire de compte.
2. Cliquez sur **Ajouter à Chrome**.
3. Confirmez les permissions demandées (voir [Permissions](#permissions)).
4. L'icône DURUM.ai apparaît dans la barre d'extensions de Chrome.

**Depuis un fichier ZIP**

1. Décompressez le fichier reçu.
2. Ouvrez `chrome://extensions/` et activez le **Mode développeur** (en haut à droite).
3. Cliquez sur **Charger l'extension non empaquetée** et choisissez le dossier décompressé.

---

## Première utilisation

### 1. Se connecter

Cliquez sur l'icône DURUM.ai dans la barre Chrome. Le popup s'ouvre sur un écran de connexion.

- Entrez le **courriel** et le **mot de passe** de votre compte DURUM.ai (les mêmes que pour [app.durum.ai](https://app.durum.ai))
- Ou cliquez sur **Se connecter avec Google** si votre compte DURUM.ai est lié à Google

### 2. Choisir le client actif (agences seulement)

Si vous gérez plusieurs comptes, un menu **Client actif** apparaît après la connexion. Choisissez le client dont vous voulez voir les données.

Vous pouvez aussi changer de client sans ouvrir le popup : le menu **Client** est dans la barre supérieure, directement sur Meta Ads Manager.

### 3. Ouvrir Meta Ads Manager

Allez sur [business.facebook.com/adsmanager](https://business.facebook.com/adsmanager). Les colonnes DURUM.ai apparaissent automatiquement à droite des colonnes natives de Meta.

---

## Personnaliser les colonnes

Dans la barre supérieure de l'extension :

1. Cliquez sur **Colonnes**.
2. Activez ou désactivez les métriques que vous voulez voir.
3. Vos choix sont sauvegardés par client.

Cinq presets par vertical sont inclus comme point de départ, puis vous ajustez colonne par colonne :

| Preset | Pour qui |
|--------|----------|
| `lead_gen` | Acquisition de leads |
| `ecommerce` | Boutique en ligne |
| `agency_close` | Agence qui close au téléphone |
| `real_estate` | Immobilier |
| `p_vertical` | Vertical professionnel |

---

## Permissions {#permissions}

L'extension demande les permissions suivantes :

| Permission | Justification |
|------------|---------------|
| `storage` | Cache des métriques (5 minutes) et préférences (client actif, colonnes, modèle d'attribution) |
| `alarms` | Renouvellement automatique du jeton de connexion toutes les 55 minutes |
| `identity` | Connexion avec Google (optionnelle) |
| `scripting` | Injection du script dans les onglets Meta déjà ouverts après une mise à jour |
| `tabs` | Détecter si l'onglet actif est sur Meta Ads Manager |
| `https://*.facebook.com/*` | Lire le tableau de Meta Ads Manager pour identifier les entités à enrichir |
| `https://*.supabase.co/*` | Appeler les services DURUM.ai qui renvoient vos métriques CRM |

L'extension est **en lecture seule sur Meta** : aucune modification des ads, aucune injection de code, aucun changement de budget.

---

## Sécurité et confidentialité

- **Authentification** par le même système que l'app DURUM.ai
- **Cloisonnement** : vous ne voyez que les données de votre propre compte
- **Aucune donnée Meta** n'est partagée à un tiers
- **Aucun suivi** : pas d'analytique, pas de publicité, pas de pixel
- Le jeton est stocké localement dans `chrome.storage.local` et renouvelé toutes les 55 minutes
- Le cache des métriques (5 minutes) est vidé à la déconnexion ou au changement de client

Politique complète : [Politique de confidentialité](https://docs.durum.ai/extension/privacy).

---

## Multi-compte (agences)

Le sélecteur de client intégré à la barre supérieure permet de changer de compte sans quitter Meta Ads Manager :

1. Ouvrez Meta Ads Manager pour n'importe quel compte.
2. Dans la barre DURUM.ai, choisissez le client dans le menu **Client**.
3. Les données se rafraîchissent automatiquement.

> **Warning**
>
> Assurez-vous que le client choisi dans la barre correspond au compte Meta affiché. Sinon, les métriques affichées ne correspondront pas aux ads visibles.

---

## Dépannage

### « Service worker indisponible »

Chrome a suspendu le service worker de l'extension :

1. Allez sur `chrome://extensions/`.
2. Trouvez la carte DURUM.ai.
3. Cliquez sur l'icône de rechargement.
4. Rouvrez le popup.

### Des zéros partout dans les colonnes

Causes possibles :

- **Non connecté** : ouvrez le popup et connectez-vous
- **Mauvais client actif** : vérifiez le menu Client dans la barre supérieure
- **Période sans données** : la période choisie dans Meta n'a pas d'événements CRM pour ce client
- **Compte Meta non lié** : vérifiez avec votre gestionnaire de compte que ce compte publicitaire est bien connecté à DURUM.ai

### Le panneau latéral n'apparaît pas

- Vérifiez que vous êtes sur [business.facebook.com/adsmanager](https://business.facebook.com/adsmanager) et non sur une autre page Meta
- Rechargez la page (`Ctrl + Shift + R`, ou `Cmd + Shift + R` sur Mac)
- Si rien ne change, rechargez l'extension dans `chrome://extensions/`

### Les chiffres ne correspondent pas à l'app

L'extension interroge les mêmes services que l'app DURUM.ai. Si les chiffres diffèrent :

1. Vérifiez que la **période** est la même (sélecteur de dates Meta contre filtres de l'app).
2. Vérifiez que le **modèle d'attribution** est le même (barre de l'extension contre réglages de l'app).
3. Vérifiez que le **client actif** correspond au compte Meta affiché.
4. Si l'écart persiste, contactez le support avec une capture d'écran.

---

## Support

- Courriel : [info@durum.ai](mailto:info@durum.ai)
- Documentation : [docs.durum.ai](https://docs.durum.ai)
- App DURUM.ai : [app.durum.ai](https://app.durum.ai)

---

## Versions

Une extension installée depuis le Chrome Web Store est mise à jour automatiquement par Chrome. Pour connaître votre version :

1. Ouvrez le popup DURUM.ai.
2. La version est affichée en bas de l'écran une fois connecté (par exemple `v0.6.4`).

Pour forcer une mise à jour, allez sur `chrome://extensions/` et cliquez sur **Mettre à jour** en haut à droite.

---

Source: https://docs.durum.ai/extension/
