Concepts du connecteur Google 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.

Découvrez comment fonctionne le connecteur Google Ads géré dans Lakeflow Connect.

Fonctionnement du connecteur

Le connecteur Google Ads ingère des données des comptes Google Ads dans Databricks en utilisant l'API Google Ads. Le connecteur prend en charge deux types de tables :

• Tables de ressources : ces tables contiennent des données de configuration concernant votre compte Google Ads, telles que les campagnes, les groupes d'annonces et les annonces. Les tables de ressources ne prennent pas en charge l'ingestion incrémentielle ; elles sont entièrement actualisées à chaque exécution de pipeline. Ils ne prennent pas non plus en charge le suivi de l'historique (SCD de type 2).
• Tableaux de rapport : ces tableaux contiennent des métriques de performance, comme les impressions, les clics et les conversions. Les tables de rapports prennent en charge l'ingestion incrémentielle avec une fenêtre de rétrospection configurable pour capturer les événements tardifs et les mises à jour d'attribution.

Pour la liste des tables prises en charge, consultez la référence du connecteur Google Ads.

Hiérarchie des comptes

Le connecteur Google Ads fonctionne avec la structure de compte suivante :

• ID de compte administrateur (MCC) : Un identifiant à 10 chiffres pour un compte administrateur Google Ads qui gère un ou plusieurs comptes Google Ads. Un pipeline correspond à un seul ID de compte de gestionnaire au maximum.
• Identifiant de compte client : un identifiant à 10 chiffres pour un compte Google Ads spécifique. Si votre ID de compte de gestionnaire correspond à plusieurs ID de compte client, vous pouvez ingérer des données depuis ces différents ID de compte client au sein du même pipeline.

Google Ads organise les données publicitaires dans la hiérarchie suivante :

• **Compte gestionnaire** : Compte central pour gérer plusieurs comptes publicitaires clients, utilisateurs et la facturation.
  • Compte publicitaire : compte publicitaire individuel.
    • Campagne : unité organisationnelle de niveau supérieur pour les annonces.
      • Groupe d'annonces : collection d'annonces qui partagent les paramètres de ciblage.
        • Annonce : Publicité individuelle.
          • Asset : composants créatifs réutilisables (titres, images, logos, liens de site) qui peuvent être joints aux annonces ou aux campagnes.

Modèles d'ingestion des données

Synchronisation des données historiques

Par default, le connecteur ingère deux ans de données historiques pour les tables de rapports. Vous pouvez configurer cela à l'aide du paramètre sync_start_date. Il n'y a pas de limite maximale.

Mises à jour incrémentielles et fenêtres de lookback

Les données de conversion Google Ads peuvent changer jusqu'à 90 jours après le fait. Par exemple, un utilisateur peut convertir les jours après avoir cliqué sur une annonce, ou Google Ads peut recalculer l'attribution. Pour capturer ces modifications, le connecteur revérifie par default les données des 30 derniers jours lors de chaque mise à jour du pipeline.

Vous pouvez personnaliser cette fenêtre rétrospective en utilisant le paramètre lookback_window_days. Tenez compte de la fenêtre d'attribution de la conversion de votre organisation lors de la définition de cette valeur. Par exemple, si votre organisation utilise une fenêtre de conversion de 60 jours, définissez lookback_window_days=60 pour vous assurer que les conversions tardives et les mises à jour d'attribution sont reflétées dans vos données.

Stockage de l'argent dans Google Ads

Google Ads stocke les valeurs monétaires en micros pour éviter les problèmes d'arrondi. Un million de micros équivaut à une unité de devise. Par exemple :

• 1,000,000 micros = $1.00 USD
• 5,500,000 micros = $5.50 USD

Lorsque vous travaillez avec des champs de coût et de budget dans vos tables de destination, divisez par 1 000 000 pour convertir les micros dans votre devise.