Ce hub couvre les concepts nécessaires pour construire et maintenir un pipeline Meta Ads vers BigQuery : le tableau actions imbriqué, les données d’attribution qui se mettent à jour rétroactivement, l’expiration des tokens qui brise silencieusement les pipelines, et les changements de méthodologie de mesure en 2021 et 2025.
L’API
Meta Ads Insights API Structure — Comment l’API Marketing est organisée : la hiérarchie d’objets à cinq niveaux, le « edge » Insights, la cadence de versioning, l’authentification par System User, et les limites de débit.
L’API expose plus de 70 champs. La complexité réside principalement dans l’un d’eux : actions. Les données de conversion sont retournées sous forme de tableau JSON imbriqué, pas de colonnes plates ; l’aplatissement est là où se concentre l’essentiel de l’effort de transformation.
Gestion du tableau actions
Meta Ads Actions Array in BigQuery — Patterns UNNEST dans BigQuery, association de actions avec action_values pour les données de revenus, rendre les types d’action configurables via des variables dbt, normalisation pour le reporting cross-plateforme, et détection des types d’action non mappés. Couvre à la fois le pattern SQL brut et l’approche intégrée dans dbt.
Fenêtres d’attribution
Meta Ads Attribution Windows — Fonctionnement des fenêtres d’attribution de Meta, quelles fenêtres ont survécu à la dépréciation de janvier 2026 (1d_click, 7d_click, 28d_click, 1d_engaged_view, 1d_view), et ce que la séparation d’attribution on-Meta/off-Meta de juin 2025 signifie pour les données en entrepôt. Les événements on-Meta (formulaires lead) s’attribuent désormais à l’heure d’impression ; les événements off-Meta (achats sur le site) s’attribuent à l’heure de conversion.
Perte de signal iOS
iOS 14.5 Signal Loss and Meta Measurement — Le déploiement d’ATT par Apple en 2021 a changé définitivement ce que Meta peut mesurer. La disponibilité de l’IDFA s’est effondrée à ~6 %. Les fenêtres d’attribution par défaut se sont réduites. Meta rapporte de plus en plus des conversions modélisées (estimées) plutôt que déterministes. L’Aggregated Event Measurement a introduit un délai de 72 heures pour les données de conversion iOS.
Comprendre ce contexte explique pourquoi les données récentes changent toujours, pourquoi le reach ne peut pas être sommé sur les ventilations, et pourquoi l’implémentation de l’API Conversions récupère 15 à 25 % de conversions attribuées supplémentaires par rapport à la mesure Pixel uniquement.
Maintien du pipeline
Meta Ads Pipeline Maintenance — Pratiques opérationnelles pour les pipelines en production : configuration des tokens System User (tokens sans expiration), réconciliation des dépenses contre Ads Manager, gestion du cycle de vie des versions API, implémentation d’un circuit breaker pour prévenir l’épuisement des limites de débit après des échecs consécutifs, et stockage des données brutes avant transformation.
Notes de jardin connexes
Ces notes du cluster plus large de données publicitaires se connectent directement à ce pipeline :
- Ad Platform API Landscape — Comparaison cross-plateforme des API ; la section Meta couvre le tableau actions à un haut niveau
- Ad Pipeline Engineering Challenges — Limites de débit, changements de schéma, normalisation des fenêtres d’attribution et réglementation sur la vie privée sur toutes les plateformes
- Ad Data Extraction Tools — Cadre de décision pour Fivetran vs Airbyte vs dlt vs Python personnalisé vs BigQuery DTS
- dbt Ad Reporting Patterns — Patterns UNION cross-plateforme et le package
dbt_facebook_adsde Fivetran - Meta CAPI Server-Side Setup: Deduplication and Event Match Quality — Implémentation de l’API Conversions incluant la déduplication d’événements et le mapping des données utilisateur pour l’Event Match Quality
- Late-Arriving Data and the Lookback Window Pattern — Le pattern dbt pour gérer les mises à jour d’attribution rétroactives de Meta
Article source
Meta Ads to BigQuery: a practical pipeline guide — Guide end-to-end du pipeline avec sélection des outils d’extraction et configurations spécifiques pour BigQuery et dbt.