Référence 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.

Cette page fournit des informations de référence pour le connecteur Google Ads géré dans Lakeflow Connect, y compris les tables prises en charge, les définitions de colonnes et les types de données.

Tables prises en charge

Le connecteur Google Ads prend en charge les types de tables suivants :

• Tables de ressources : données de configuration concernant votre compte Google Ads, telles que les campagnes, les groupes d'annonces et les annonces. Ces tables sont entièrement actualisées à chaque exécution de pipeline.
• Tables de rapport : métriques de performance, comme les impressions, les clics et les conversions. Ces tables prennent en charge l'ingestion incrémentielle.

Tables de ressources

Nom de la table	Description
customer	Informations concernant les comptes Google Ads.
campaign	Configuration et paramètres de la Campagne.
campaign_budget	Paramètres du budget pour les campagnes.
campaign_criterion	Critères de ciblage pour les campagnes.
ad_group	Configuration du groupe Ad.
ad_group_criterion	Critères de ciblage pour les groupes d'annonces.
ad	Détails et paramètres publicitaires individuels.

Nom de la table	Description
customer	Informations concernant les comptes Google Ads.
campaign	Configuration et paramètres de la Campagne.
campaign_budget	Paramètres du budget pour les campagnes.
campaign_criterion	Critères de ciblage pour les campagnes.
ad_group	Configuration du groupe Ad.
ad_group_criterion	Critères de ciblage pour les groupes d'annonces.
ad	Détails et paramètres publicitaires individuels.

Tables de rapports

Nom de la table	Description
customer_report	Métriques de performance au niveau du compte.
campaign_report	Indicateurs de performance au niveau de la campagne.
ad_group_report	Métriques de performance au niveau du groupe d'annonces.
ad_report	Indicateurs de performance au niveau des annonces.
keyword_report	Indicateurs de performance au niveau du mot-clé.
search_query_report	Rechercher les métriques de performances au niveau de la query.

Nom de la table	Description
customer_report	Métriques de performance au niveau du compte.
campaign_report	Indicateurs de performance au niveau de la campagne.
ad_group_report	Métriques de performance au niveau du groupe d'annonces.
ad_report	Indicateurs de performance au niveau des annonces.
keyword_report	Indicateurs de performance au niveau du mot-clé.
search_query_report	Rechercher les métriques de performances au niveau de la query.

Conventions de type de données

Stockage d'argent (micros)

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

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

Les champs avec le suffixe _micros contiennent des valeurs stockées en micro. Divisez par 1 000 000 pour convertir dans votre devise.

Clés principales

Les tables utilisent la notation (Primary Key) pour indiquer les colonnes qui forment la clé primaire. Les clés primaires composites sont indiquées par plusieurs colonnes marquées comme (Primary Key).

Schémas de table de ressources

customer

Informations concernant les comptes Google Ads.

Colonne	Type de données	Description
id	long	Clé primaire. ID de compte client.
auto_tagging_enabled	boolean	Si l'étiquetage automatique est activé pour le compte.
currency_code	string	Code de la devise pour le compte.
descriptive_name	string	Nom convivial pour le compte Google Ads.
final_url_suffix	string	Suffixe d'URL ajouté aux URL finales pour le suivi.
manager	boolean	Si le client est un Compte Manager (MCC).
optimization_score	double	Score d’optimisation du compte.
pay_per_conversion_eligibility_failure_reasons	array<string>	Raisons pour lesquelles le compte n’est pas admissible aux enchères au paiement par conversion.
test_account	boolean	Indique si le client est un compte de test.
time_zone	string	Fuseau horaire du compte.
tracking_url_template	string	Template d'URL pour la construction d'URL de suivi.

Colonne	Type de données	Description
id	long	Clé primaire. ID de compte client.
auto_tagging_enabled	boolean	Si l'étiquetage automatique est activé pour le compte.
currency_code	string	Code de la devise pour le compte.
descriptive_name	string	Nom convivial pour le compte Google Ads.
final_url_suffix	string	Suffixe d'URL ajouté aux URL finales pour le suivi.
manager	boolean	Si le client est un Compte Manager (MCC).
optimization_score	double	Score d’optimisation du compte.
pay_per_conversion_eligibility_failure_reasons	array<string>	Raisons pour lesquelles le compte n’est pas admissible aux enchères au paiement par conversion.
test_account	boolean	Indique si le client est un compte de test.
time_zone	string	Fuseau horaire du compte.
tracking_url_template	string	Template d'URL pour la construction d'URL de suivi.

campaign

Configuration et paramètres de la Campagne.

Colonne	Type de données	Description
id	long	Clé primaire. ID de campagne.
name	string	Nom de la campagne.
status	string	État de la campagne.
advertising_channel_type	string	Type de canal publicitaire.
start_date	string	Date de start de la campagne.
end_date	string	Date de fin de campagne.
campaign_budget_id	long	ID du budget de campagne associé.

Colonne	Type de données	Description
id	long	Clé primaire. ID de campagne.
name	string	Nom de la campagne.
status	string	État de la campagne.
advertising_channel_type	string	Type de canal publicitaire.
start_date	string	Date de start de la campagne.
end_date	string	Date de fin de campagne.
campaign_budget_id	long	ID du budget de campagne associé.

campaign_budget

Paramètres du budget pour les campagnes.

Colonne	Type de données	Description
id	long	Clé primaire. ID du budget.
resource_name	string	Nom de la ressource Google Ads.
name	string	Nom du budget.
amount_micros	long	Montant du budget en micros. Diviser par 1 000 000 pour convertir en devise.
delivery_method	string	Comment Google dépense le budget quotidien (standard ou accéléré).
period	string	Période budgétaire.
status	string	Statut du budget.
total_amount_micros	long	Montant total du budget en micros. Diviser par 1 000 000 pour convertir en devise.

Colonne	Type de données	Description
id	long	Clé primaire. ID du budget.
resource_name	string	Nom de la ressource Google Ads.
name	string	Nom du budget.
amount_micros	long	Montant du budget en micros. Diviser par 1 000 000 pour convertir en devise.
delivery_method	string	Comment Google dépense le budget quotidien (standard ou accéléré).
period	string	Période budgétaire.
status	string	Statut du budget.
total_amount_micros	long	Montant total du budget en micros. Diviser par 1 000 000 pour convertir en devise.

campaign_criterion

Critères de ciblage pour les campagnes.

Colonne	Type de données	Description
campaign_id	long	Clé primaire. ID de campagne.
criterion_id	long	Clé primaire. ID du critère.
resource_name	string	Nom de la ressource Google Ads.
type	string	Type de critère.
status	string	Statut du critère.
negative	boolean	Indique si ce critère exclut une audience.
bid_modifier	double	Valeur du modificateur d'enchère.

Colonne	Type de données	Description
campaign_id	long	Clé primaire. ID de campagne.
criterion_id	long	Clé primaire. ID du critère.
resource_name	string	Nom de la ressource Google Ads.
type	string	Type de critère.
status	string	Statut du critère.
negative	boolean	Indique si ce critère exclut une audience.
bid_modifier	double	Valeur du modificateur d'enchère.

ad_group

Configuration du groupe Ad.

Colonne	Type de données	Description
id	long	Clé primaire. ID de groupe d'annonces.
name	string	Nom du groupe Ad.
status	string	Statut du groupe.
campaign_id	long	ID de campagne associé.
type	string	Type de groupe d’annonces.
cpc_bid_micros	long	Enchère au coût par clic en micros.
target_cpa_micros	long	Coût cible par acquisition en micro.

Colonne	Type de données	Description
id	long	Clé primaire. ID de groupe d'annonces.
name	string	Nom du groupe Ad.
status	string	Statut du groupe.
campaign_id	long	ID de campagne associé.
type	string	Type de groupe d’annonces.
cpc_bid_micros	long	Enchère au coût par clic en micros.
target_cpa_micros	long	Coût cible par acquisition en micro.

ad_group_criterion

Critères de ciblage pour les groupes d'annonces.

Colonne	Type de données	Description
criterion_id	long	Clé primaire. ID du critère.
ad_group_id	long	Clé primaire. ID de groupe d'annonces.
resource_name	string	Nom de la ressource Google Ads.
status	string	Statut du critère.
type	string	Type de critère.
negative	boolean	Indique si ce critère exclut une audience.
keyword_match_type	string	Type de correspondance par mot-clé (exacte, expression, large).
keyword_text	string	Texte de mot-clé.

Colonne	Type de données	Description
criterion_id	long	Clé primaire. ID du critère.
ad_group_id	long	Clé primaire. ID de groupe d'annonces.
resource_name	string	Nom de la ressource Google Ads.
status	string	Statut du critère.
type	string	Type de critère.
negative	boolean	Indique si ce critère exclut une audience.
keyword_match_type	string	Type de correspondance par mot-clé (exacte, expression, large).
keyword_text	string	Texte de mot-clé.

ad

Détails et paramètres d'annonce individuels. Ce tableau correspond à ad_group_ad dans l'API Google Ads.

Colonne	Type de données	Description
id	long	Clé primaire. ID d'annonce.
ad_group_id	long	Clé primaire. ID de groupe d'annonces.
status	string	État de l'annonce.
ad_type	string	Type d'annonce.
final_urls	array<string>	URL des landing page après avoir cliqué sur l'annonce.
policy_summary_approval_status	string	Si la publicité est approuvée selon la politique Google Ads (approuvée ou refusée).
policy_summary_review_status	string	Si Google a terminé l'examen de l'annonce (REVIEW_IN_PROGRESS ou REVIEWED).

Colonne	Type de données	Description
id	long	Clé primaire. ID d'annonce.
ad_group_id	long	Clé primaire. ID de groupe d'annonces.
status	string	État de l'annonce.
ad_type	string	Type d'annonce.
final_urls	array<string>	URL des landing page après avoir cliqué sur l'annonce.
policy_summary_approval_status	string	Si la publicité est approuvée selon la politique Google Ads (approuvée ou refusée).
policy_summary_review_status	string	Si Google a terminé l'examen de l'annonce (REVIEW_IN_PROGRESS ou REVIEWED).

Signaler les schémas de table

customer_report

Métriques de performance au niveau du compte.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
device	string	Clé primaire. Type d'appareil.
ad_network_type	string	Clé primaire. Type de réseau publicitaire.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.
cost_micros	long	Coût en micros. Diviser par 1 000 000 pour convertir en devise.
conversions	double	Nombre de conversions.
conversions_value	double	Valeur de conversion totale.
ctr	double	Taux de clics.
average_cpc	double	Coût moyen par clic.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
device	string	Clé primaire. Type d'appareil.
ad_network_type	string	Clé primaire. Type de réseau publicitaire.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.
cost_micros	long	Coût en micros. Diviser par 1 000 000 pour convertir en devise.
conversions	double	Nombre de conversions.
conversions_value	double	Valeur de conversion totale.
ctr	double	Taux de clics.
average_cpc	double	Coût moyen par clic.

campaign_report

Indicateurs de performance au niveau de la campagne.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
id	long	Clé primaire. ID de campagne.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
device	string	Clé primaire. Type d'appareil.
ad_network_type	string	Clé primaire. Type de réseau publicitaire.
campaign_name	string	Nom de la campagne.
campaign_status	string	État de la campagne.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.
cost_micros	long	Coût en micros.
conversions	double	Nombre de conversions.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
id	long	Clé primaire. ID de campagne.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
device	string	Clé primaire. Type d'appareil.
ad_network_type	string	Clé primaire. Type de réseau publicitaire.
campaign_name	string	Nom de la campagne.
campaign_status	string	État de la campagne.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.
cost_micros	long	Coût en micros.
conversions	double	Nombre de conversions.

ad_group_report

Métriques de performance au niveau du groupe d'annonces.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
id	long	Clé primaire. ID de groupe d'annonces.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
device	string	Clé primaire. Type d'appareil.
ad_network_type	string	Clé primaire. Type de réseau publicitaire.
ad_group_name	string	Nom du groupe Ad.
ad_group_status	string	Statut du groupe.
campaign_id	long	ID de campagne associé.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.
cost_micros	long	Coût en micros.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
id	long	Clé primaire. ID de groupe d'annonces.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
device	string	Clé primaire. Type d'appareil.
ad_network_type	string	Clé primaire. Type de réseau publicitaire.
ad_group_name	string	Nom du groupe Ad.
ad_group_status	string	Statut du groupe.
campaign_id	long	ID de campagne associé.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.
cost_micros	long	Coût en micros.

keyword_report

Indicateurs de performance au niveau du mot-clé.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
ad_group_criterion_criterion_id	long	Clé primaire. ID du critère.
ad_group_id	long	Clé primaire. ID de groupe d'annonces.
device	string	Clé primaire. Type d'appareil.
ad_network_type	string	Clé primaire. Type de réseau publicitaire.
keyword_text	string	Texte de mot-clé.
keyword_match_type	string	Type de correspondance de mots-clés.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.
cost_micros	long	Coût en micros.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
ad_group_criterion_criterion_id	long	Clé primaire. ID du critère.
ad_group_id	long	Clé primaire. ID de groupe d'annonces.
device	string	Clé primaire. Type d'appareil.
ad_network_type	string	Clé primaire. Type de réseau publicitaire.
keyword_text	string	Texte de mot-clé.
keyword_match_type	string	Type de correspondance de mots-clés.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.
cost_micros	long	Coût en micros.

ad_report

Indicateurs de performance au niveau des annonces.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
ad_id	long	Clé primaire. ID d'annonce.
ad_group_id	long	Clé primaire. ID de groupe d'annonces.
device	string	Clé primaire. Type d'appareil.
ad_network_type	string	Clé primaire. Type de réseau publicitaire.
campaign_id	long	ID de campagne associé.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.
cost_micros	long	Coût en micros.
conversions	double	Nombre de conversions.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
ad_id	long	Clé primaire. ID d'annonce.
ad_group_id	long	Clé primaire. ID de groupe d'annonces.
device	string	Clé primaire. Type d'appareil.
ad_network_type	string	Clé primaire. Type de réseau publicitaire.
campaign_id	long	ID de campagne associé.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.
cost_micros	long	Coût en micros.
conversions	double	Nombre de conversions.

search_query_report

Rechercher les métriques de performances au niveau de la query.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
resource_name	string	Clé primaire. Nom de la ressource Google Ads.
search_term	string	Terme de recherche de l'utilisateur.
search_term_match_type	string	Comment le mot-clé correspondait au terme de recherche.
ad_group_id	long	ID de groupe d'annonces associé.
campaign_id	long	ID de campagne associé.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
date	string	Clé primaire. Date au format AAAA-MM-JJ.
resource_name	string	Clé primaire. Nom de la ressource Google Ads.
search_term	string	Terme de recherche de l'utilisateur.
search_term_match_type	string	Comment le mot-clé correspondait au terme de recherche.
ad_group_id	long	ID de groupe d'annonces associé.
campaign_id	long	ID de campagne associé.
impressions	long	Nombre d'impressions.
clicks	long	Nombre de clics.

Ingestion incrémentielle

Les tables de rapports prennent en charge l'ingestion incémentielle avec une fenêtre rétrospective configurable. Le connecteur utilise la colonne date comme colonne de curseur pour le suivi des mises à jour incémentielles.

Pour plus d'information sur l'ingestion incrémentielle et les fenêtres de rétrospection, consultez Concepts du connecteur Google Ads.

Options de configuration de rapport personnalisé

Les rapports personnalisés vous permettent de sélectionner n'importe quelle Ressource Google Ads avec une combinaison de champs de Ressource, de segments et de métriques. Le nom de destination_table est requis.

Définissez source_table sur custom_report et fournissez custom_report_options sous connector_options.google_ads_options:

Option	Obligatoire	Description
resource	Oui	La ressource Google Ads à query (par exemple, ad_group_ad, keyword_view, search_term_view). La ressource doit prendre en charge les métriques.
resource_fields	Non	Champs de ressources à sélectionner, au format GAQL entièrement qualifié (par exemple, ad_group_ad.ad.id, ad_group_ad.status). Le nom de la ressource est ajouté par default.
segments	Non	Champs de segment à sélectionner (par exemple, segments.date, segments.device). Vous devez inclure au moins un segment de chronologie — segments.date, segments.week, ou segments.month — qui devient le curseur incrémentiel de la table.
metrics	Non	Champs de métrique à sélectionner (par exemple, metrics.clicks, metrics.cost_micros).

Option	Obligatoire	Description
resource	Oui	La ressource Google Ads à query (par exemple, ad_group_ad, keyword_view, search_term_view). La ressource doit prendre en charge les métriques.
resource_fields	Non	Champs de ressources à sélectionner, au format GAQL entièrement qualifié (par exemple, ad_group_ad.ad.id, ad_group_ad.status). Le nom de la ressource est ajouté par default.
segments	Non	Champs de segment à sélectionner (par exemple, segments.date, segments.device). Vous devez inclure au moins un segment de chronologie — segments.date, segments.week, ou segments.month — qui devient le curseur incrémentiel de la table.
metrics	Non	Champs de métrique à sélectionner (par exemple, metrics.clicks, metrics.cost_micros).

Notes

• Les colonnes de destination omettent les préfixes standard metrics. et segments. ; pour les champs de ressource, les points sont convertis en tirets bas (par exemple, ad_group_ad.ad.id devient ad_group_ad_ad_id).
• L'attribut resource_name est toujours inclus pour identifier chaque ligne.
• L’ingestion des rapports personnalisés est incrémentielle, basée sur la fenêtre de rétrospection.
• Google Ads conserve les données segmentées quotidiennement et hebdomadairement pendant seulement 37 mois. Les rapports personnalisés utilisant segments.date ou segments.week ne peuvent pas synchroniser les données antérieures à cette période ; utilisez segments.month pour les données plus anciennes.
• La planification du pipeline valide les noms de champ par rapport à Google Ads. Les segments de chronologie manquants ou les champs non valides provoquent des échecs de mise à jour. Utilisez le paramètre validate_only pour tester les configurations sans déplacer les données.