AquilApp

Cas client · Marketing digital

Réunir les campagnes Meta, Google Ads et LinkedIn dans un seul rapport pour l’annonceur

L’agence MADMADS voulait donner à ses annonceurs un espace où suivre leurs campagnes publicitaires, quelle que soit la régie. Nous avons conçu et développé Graads : une API Laravel qui collecte les statistiques des régies et une interface Next.js où chaque profil ne voit que ses campagnes. La plateforme a été mise en production le 16 novembre 2022, puis a évolué jusqu’en 2025.

Client
Graads
Secteur
Marketing digital
Projet
Plateforme SaaS de reporting publicitaire
Période
Février 2022 – avril 2025
Technologies
  • Laravel
  • PHP
  • Next.js
  • React

En bref

Le défi
Donner aux annonceurs d’une agence média un accès direct aux statistiques de leurs campagnes, réparties entre Meta, Google Ads et LinkedIn, sans jamais exposer les données d’un autre client.
Notre réponse
Une API Laravel qui collecte automatiquement les statistiques des trois régies et une interface Next.js bilingue, cloisonnée par profil : administrateur, agence, annonceur.
Les résultats
Graads a été mis en production le 16 novembre 2022 ; Google a accordé l’accès aux données Google Ads le 14 décembre 2022, après quatre semaines de revue.

Pas le temps de tout lire ?

Votre IA résume cette page en un clic, avec les bonnes questions à nous poser.

  • 3

    régies publicitaires connectées par API : Meta (Facebook et Instagram), Google Ads et LinkedIn

  • 15 min

    entre deux collectes automatiques des statistiques depuis janvier 2025 (collecte quotidienne auparavant)

  • 4 semaines

    de revue par Google avant l’accord d’accès aux données Google Ads (17 novembre – 14 décembre 2022)

É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.
Logo Graads et illustration d’un rapport de campagne sur téléphone
Visuel de présentation de Graads (illustration, sans données de campagne réelles).

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

Un projet comparable ?

Parlez-nous de votre contexte : nous cadrons ensemble la prochaine étape, sans engagement.

Autres réalisations

Tous nos cas clients