Aller au contenu principal
Dernière mise à jour le

Concepts du connecteur Meta Ads

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Le connecteur Meta Ads vous permet d'ingérer des données publicitaires de Meta Ads à l'aide de Databricks Lakeflow Connect.

Comment fonctionne l'ingestion Meta Ads ?​

Le connecteur récupère les données des APIs Meta Ads et les écrit dans des tables de streaming. L'objet ad_insights utilise l'API Insights. Les objets ads, ad_sets et campaigns utilisent l'API Marketing. Chaque objet Meta Ads correspond à une table dans votre schéma de destination.

Modèle de données du connecteur​

Le connecteur Meta Ads peut ingérer les objets suivants depuis votre compte Meta Ads :

  • ads: annonces individuelles dans vos campagnes
  • ad_sets: Ensembles d'annonces qui regroupent les annonces.
  • campaigns: Objets de campagne de haut niveau
  • ad_images: Images utilisées dans les annonces
  • ad_insights: Indicateurs de performance et données d'analytique
  • ad_creatives: Éléments créatifs utilisés dans les annonces
  • custom_audiences: Définitions d'audience personnalisées
  • ad_videos: assets vidéo utilisés dans les publicités
  • custom_conversions: Définitions d'événements de conversion personnalisées
  • Rapports prédéfinis (21 tables) : Variantes prédéfinies ad_insights avec une configuration fixe par rapport
  • custom_report: Rapport d'insights défini par l'utilisateur avec un niveau, une répartition et une combinaison de répartition par action entièrement configurables

objet ad_insights​

L'objet ad_insights fournit des indicateurs de performance pour vos campagnes publicitaires. Vous pouvez configurer les répartitions et les répartitions d'action pour analyser les performances à différents niveaux :

  • **Niveaux de granularité** account:,,, campaign adsetou ad
  • Dimensions de répartition : âge, genre, pays, placement, plateforme d'appareil, et plus
  • Répartition des actions : type d'action, destination de l'action et autres dimensions liées à la conversion
  • Incrément de temps : all_days, monthly ou un nombre de jours personnalisé. L’API Insights ne prend pas en charge les incréments horaires.
  • **Heure du rapport d'activité** : si le connecteur génère des statistiques d'action par impression, conversion, mix et durée de vie.
  • Fenêtre de rétrospection : Nombre de jours que le connecteur réingère à chaque synchronisation pour capturer les conversions à arrivée tardive.

Pour plus de détails sur chaque option, consultez les options de configurationad_insights.

Rapports prédéfinis​

Les rapports prédéfinis sont 21 variantes ad_insights prêtes à l'emploi, organisées en quatre familles : de base, de livraison, démographiques et d'action. Chaque rapport possède une configuration fixe — le niveau, les répartitions, les répartitions d'action, l'incrément de temps et les fenêtres d'attribution sont définis par rapport et ne peuvent pas être remplacés. Pour ingérer un rapport prédéfini, définissez source_table sur le nom du rapport. Vous pouvez éventuellement définir start_date et custom_insights_lookback_window.

Pour la liste complète des rapports prédéfinis et de leurs configurations, consultez Rapports prédéfinis.

objet de rapport personnalisé​

L’objet custom_report vous permet de définir votre propre rapport de type ad_insightsavec une combinaison de niveaux, de répartitions et de répartitions d’actions entièrement configurable. Contrairement aux rapports prédéfinis, vous contrôlez la configuration complète à l'aide de custom_report_options. Chaque rapport personnalisé s'ingère dans un destination_table distinct, de sorte que vous pouvez exécuter plusieurs rapports personnalisés dans un seul pipeline.

Pour plus de détails sur custom_report_options, consultez les options de configurationcustom_report.

Notions de base du connecteur​

  • Lors de la première exécution du pipeline, le connecteur ingère toutes les données des objets sélectionnés.
  • Lors des exécutions de pipeline ultérieures, le connecteur ingère les enregistrements nouvellement créés ou modifiés à l'aide de l'ingestion incrémentielle.
  • Le connecteur transforme automatiquement les types de données Meta Ads en types de données compatibles Delta.
  • Chaque table de destination est une table de streaming, qui est une table Delta avec un support supplémentaire pour le traitement incrémentiel des données.

Ingestion incrémentielle​

Le connecteur Meta Ads utilise l'ingestion incrémentielle pour améliorer l'efficacité des pipelines. Lors de la première exécution de votre pipeline, il ingère toutes les données sélectionnées de la source. Lors des exécutions ultérieures, le connecteur utilise le suivi des modifications basé sur un curseur pour ingérer uniquement les données qui ont changé depuis l'exécution précédente.

Le connecteur utilise le champ updated_time (si disponible) comme colonne de curseur pour détecter les changements. Pour les objets sans champ updated_time, le connecteur utilise l'ingestion par refresh complet.

Paramètres d'attribution​

Par default, le connecteur Meta Ads utilise les paramètres d'attribution de votre compte Meta Ads lors de la récupération des données ad_insights. Vous pouvez remplacer cela en définissant action_attribution_windows pour spécifier une ou plusieurs fenêtres d'attribution (par exemple, 7d_click ou 1d_view). Pour les valeurs prises en charge, consultez Fenêtres d'attribution.

Étant donné que les événements de conversion peuvent être signalés après l’impression ou le clic, les données pour les dates récentes peuvent être incomplètes tant que la fenêtre d’attribution configurée n’est pas fermée. Le connecteur réingère automatiquement ces données lors des exécutions de pipeline ultérieures.

Plateformes publicitaires prises en charge​

En version bêta, le connecteur prend en charge uniquement les Facebook Ads. Les publicités Instagram ne sont pas prises en charge.

Authentification​

Le connecteur utilise OAuth 2.0 pour s'authentifier auprès de Meta Ads. Vous créez une application Meta dans le portail des développeurs Meta et configurez les paramètres OAuth pour permettre à Databricks d’accéder à vos données publicitaires. Les identifiants de connexion sont stockés en toute sécurité dans Unity Catalog.

Ressources supplémentaires​

Sur cette page