Étude de cas complète
Une agence média qui veut ouvrir ses chiffres de campagne à ses annonceurs
MADMADS est une agence d’audience planning et de branding, présente à Nantes et à Toulouse. Elle achète et pilote des campagnes publicitaires pour ses clients sur plusieurs régies : Meta (Facebook et Instagram), Google Ads (dont YouTube) et LinkedIn.
Chaque régie a sa console, ses indicateurs et ses exports. Les résultats étaient restitués aux annonceurs dans des rapports intermédiaires et des bilans de fin de campagne. En janvier 2022, les deux directeurs associés nous présentent leur projet : une interface web où leurs clients consultent eux-mêmes les statistiques de leurs campagnes, récupérées auprès des régies, avec la possibilité pour l’agence de compléter ou de corriger certaines données.
Le produit doit porter sa propre marque, Graads, et pouvoir servir à d’autres agences : l’outil ne doit donc pas être lié à l’identité de MADMADS.
Un cahier des charges MVP écrit avant le devis de développement
Après une première réunion dans nos locaux de Saint-Herblain fin janvier 2022, nous avons proposé de séparer le projet en deux temps : une phase de conception (cahier des charges fonctionnel, modèle de données, maquettes des écrans), puis le développement, chiffré sur cette base.
Le cahier des charges a connu quatre versions entre le 18 janvier et le 4 avril 2022. Il fixe un périmètre de MVP : uniquement les fonctions nécessaires pour utiliser le produit, sur un socle capable d’évoluer. Les questions posées par MADMADS pendant cette phase ont orienté trois décisions :
- Le cloisonnement des données : un annonceur n’accède qu’à ses campagnes, jamais à celles des autres clients de l’agence.
- Le bilinguisme : l’interface est livrée en français et en anglais dès la première version.
- La propriété du code : MADMADS reste propriétaire de la solution et libre d’en poursuivre le développement avec l’équipe de son choix.
La version finale du cahier des charges ajoute la connexion à LinkedIn, l’export Excel des rapports et la restriction des accès par établissement. Le développement de l’API commence le 19 avril 2022, celui de l’interface le 9 mai.
Une campagne Graads regroupe plusieurs régies, restituées par profil
Graads repose sur trois types de comptes. L’administrateur gère l’ensemble de la plateforme. Le gestionnaire (une agence) crée ses annonceurs, leurs établissements et leurs campagnes. L’annonceur consulte les campagnes des établissements auxquels le gestionnaire lui a donné accès. La connexion se fait par mot de passe ou par lien magique reçu par e-mail.
Pour créer une campagne, le gestionnaire connecte son compte Meta, Google ou LinkedIn, choisit le compte publicitaire puis la campagne à rattacher. Une campagne Graads peut ainsi réunir plusieurs régies ; une campagne « personnalisée » accepte des données saisies à la main quand aucune API n’existe.
Première version : le rapport de campagne (2022–2023)
- Rapport modulable : indicateurs, graphiques, répartition par âge et par genre, par appareil, image, commentaire. Les modules s’ajoutent, se déplacent et se modifient.
- Correction des performances : le gestionnaire ajuste un indicateur quand la donnée de la régie doit être complétée.
- Diffusion : publication du rapport à l’annonceur, export PDF puis Excel, e-mail récapitulatif de campagne.

Deuxième version : la vue d’ensemble des campagnes (2024–2025)
- Tableau des campagnes avec indicateurs agrégés, filtres par annonceur, par régie et par période, et détail par ensemble de publicités et par annonce.
- Modèles de vue enregistrables, pour retrouver d’un clic les indicateurs suivis.
- Lien de partage vers une campagne, consultable sans compte Graads.
- Coefficient de budget par annonceur et par campagne, appliqué aux montants affichés au client.
Côté serveur, une tâche planifiée interroge les régies et enregistre les indicateurs de chaque campagne : une fois par jour dans la première version, toutes les quinze minutes depuis janvier 2025. Les écrans s’affichent donc à partir de la base de Graads, sans attendre la réponse d’une API tierce.
Les points durs sont venus des plateformes publicitaires, pas des écrans
Obtenir de Google l’accès aux données Google Ads
- Le risque
- Lire les campagnes Google Ads d’un utilisateur demande une autorisation classée sensible par Google. Tant que l’application n’est pas vérifiée, seuls des comptes de test peuvent se connecter. La revue a commencé le 17 novembre 2022, au lendemain de la mise en production.
- Notre réponse
- Google a demandé successivement la preuve de propriété des domaines, la justification d’un usage ouvert à d’autres entreprises, une page d’accueil publique décrivant le produit (l’adresse déclarée menait à un écran de connexion), une politique de confidentialité accessible et une vidéo montrant l’écran de consentement et l’usage des données. Nous avons répondu à chaque étape ; MADMADS a mis en ligne le site de présentation, et nous avons enregistré une seconde vidéo de démonstration.
- Résultat
- Google a accordé l’accès le 14 décembre 2022. Pendant ces quatre semaines, nous avons poursuivi la recette et ajouté l’export PDF et les e-mails transactionnels.
Faire vérifier l’application auprès de Meta
- Le risque
- Pour sortir l’application Facebook du mode développement, Meta exige la vérification de l’entreprise éditrice, les coordonnées d’un délégué à la protection des données et des conditions de service. Ces démarches ne peuvent être faites que par le client.
- Notre réponse
- Nous avons préparé la liste des éléments attendus et accompagné MADMADS dans la procédure, en novembre 2022, en parallèle de la recette.
- Résultat
- L’état des lieux du 6 janvier 2023 valide en production la connexion aux trois régies et la récupération de leurs comptes publicitaires et de leurs campagnes.
Cloisonner les données entre agences, annonceurs et établissements
- Le risque
- Une agence gère plusieurs annonceurs, souvent concurrents, et un annonceur peut avoir plusieurs établissements. Un filtre oublié dans un seul écran suffirait à montrer les budgets d’un client à un autre.
- Notre réponse
- Le filtrage est appliqué dans l’API, au niveau des modèles de données : selon le profil connecté, chaque requête sur les campagnes, les annonceurs ou les établissements est restreinte d’office à ce que l’utilisateur a le droit de voir.
- Résultat
- La règle d’accès est écrite une fois et s’applique à tous les écrans, y compris ceux ajoutés par la suite.
Produire un PDF fidèle au rapport affiché à l’écran
- Le risque
- Les graphiques du rapport sont dessinés par le navigateur. Les premiers exports capturaient la page avant leur affichage et coupaient certains modules entre deux pages.
- Notre réponse
- Le PDF est généré côté serveur par un navigateur sans interface : il ouvre une version du rapport mise en page pour l’impression et attend la fin du chargement avant de produire le document.
- Résultat
- Fin janvier 2023, l’export PDF était en ligne et le même document accompagnait l’e-mail récapitulatif de campagne.
Suivre trois API qui changent de version
- Le risque
- Meta et Google retirent régulièrement les anciennes versions de leurs API. À l’automne 2023, des versions devenues obsolètes bloquaient la mise à jour des campagnes.
- Notre réponse
- Nous avons fait passer l’API Google Ads de la version 12 à la version 15 et celle de Meta de la version 15 à la version 18, puis géré le cas des comptes publicitaires inactifs. Les mises à niveau suivantes ont eu lieu en 2024 et début 2025. En 2025, un accès expiré propose à l’utilisateur de le renouveler au lieu d’afficher une erreur.
- Résultat
- La collecte a repris sur les deux régies après l’intervention d’octobre 2023. Ce point est devenu notre premier enseignement du projet.
Pourquoi une API Laravel séparée de l’interface Next.js
Le produit devait interroger des services tiers en continu, servir plusieurs profils et rester reprenable par une autre équipe. Deux options étaient possibles : une application unique, ou une API et une interface distinctes.
Nous avons retenu la séparation. L’API est écrite avec Laravel : authentification par jeton, connexion OAuth aux régies, tâches planifiées pour la collecte, génération des PDF. L’interface est une application Next.js en React et TypeScript, avec des graphiques interactifs et des traductions en français et en anglais.
Conséquence : la collecte tourne indépendamment des écrans, les deux briques se déploient séparément et chacune vit dans son propre dépôt. C’est une architecture que nous utilisons régulièrement pour nos applications SaaS.
Second choix : enregistrer les statistiques dans la base de Graads plutôt que d’interroger les régies à chaque affichage. Les écrans restent rapides, l’agence peut corriger un indicateur ou appliquer un coefficient de budget, et les données sont agrégées du niveau de l’annonce à celui de la campagne. En contrepartie, la fraîcheur des chiffres dépend de la tâche de collecte et de la validité des accès aux régies.
Résultats : une mise en production fin 2022, puis trois ans d’évolutions
Nous n’avons pas de chiffres d’usage à publier pour Graads : les faits ci-dessous sont des faits de livraison, vérifiables dans les dépôts et les comptes rendus.
- 16 novembre 2022 : mise en production de l’API et de l’interface.
- 14 décembre 2022 : accord de Google pour l’accès aux données Google Ads.
- 6 janvier 2023 : état des lieux de production validant les connexions aux trois régies, la campagne personnalisée, la correction des performances et les e-mails récapitulatifs.
- 2023 : export PDF puis Excel, nouveaux modules de rapport (image, indicateur seul, répartition par appareil), publication et dépublication des rapports.
- Avril 2024 : nouvelle navigation, vue d’ensemble des campagnes avec indicateurs agrégés, affichage en tableau, détail par ensemble de publicités et par annonce, lien de partage, comptes hybrides gestionnaire-annonceur.
- Début 2025 : filtres de dates, modèles de vue enregistrables, courbes en variation journalière, mise à niveau des API des régies.
Sur la période, le projet représente plus de 700 commits répartis entre les deux dépôts. En mars 2026, nous avons transmis à MADMADS le code source des deux briques, conformément à l’engagement pris au cadrage : l’éditeur reste propriétaire de sa solution.
Ce que nous en retenons
- Chiffrer la maintenance des API dès le premier devis : un produit qui dépend de trois régies doit suivre leurs changements de version. Sans budget de veille, la collecte finit par s’interrompre.
- Inscrire la revue des plateformes au planning : compter plusieurs semaines, et préparer avant la mise en production le site public, la politique de confidentialité et la vidéo de démonstration demandés par Google et Meta.
- Tester tôt avec de vrais comptes publicitaires : certaines situations (compte sans compte publicitaire rattaché, accès expiré, campagnes homonymes) n’apparaissent qu’avec des données réelles. Les accès de test se demandent dès le cadrage.
Réponse sous 24 h ouvrées

