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 d’événements : événements individuels tels que les appels, les soumissions de formulaires de prospects et les prospects Local Services. Ces tables sont entièrement actualisées à chaque exécution du pipeline.

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.
customer_hourly_report	Indicateurs de performance au niveau du compte ventilés par heure.
campaign_hourly_report	Indicateurs de performance au niveau de la campagne ventilés par heure.
ad_group_hourly_report	Indicateurs de performance au niveau du groupe d’annonces ventilés par heure.
audience_report	Indicateurs de performance au niveau de l’audience (critère de groupe d’annonces).
click_report	Indicateurs au niveau du clic indexés par ID de clic Google (gclid).
landing_page_report	Indicateurs de performance de la landing page (URL finale développée).
search_keyword_report	Indicateurs de performance au niveau du mot clé à partir de la vue des mots clés.

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.
customer_hourly_report	Indicateurs de performance au niveau du compte ventilés par heure.
campaign_hourly_report	Indicateurs de performance au niveau de la campagne ventilés par heure.
ad_group_hourly_report	Indicateurs de performance au niveau du groupe d’annonces ventilés par heure.
audience_report	Indicateurs de performance au niveau de l’audience (critère de groupe d’annonces).
click_report	Indicateurs au niveau du clic indexés par ID de clic Google (gclid).
landing_page_report	Indicateurs de performance de la landing page (URL finale développée).
search_keyword_report	Indicateurs de performance au niveau du mot clé à partir de la vue des mots clés.

Tables d'événements

Nom de la table	Description
call_view	Appels suivis à partir d'extensions d'appel et d'annonces appel uniquement.
lead_form_submission	Soumissions de formulaires de leads. Requiert un accès Standard ou Administrateur au compte Google Ads.
local_services_lead	Prospects issus des annonces de services locaux. Ne renvoie que les lignes pour les comptes Local Services.
local_services_lead_conversation	Conversations sur les prospects Local Services Ads. Ne renvoie que les lignes pour les comptes Local Services.

Nom de la table	Description
call_view	Appels suivis à partir d'extensions d'appel et d'annonces appel uniquement.
lead_form_submission	Soumissions de formulaires de leads. Requiert un accès Standard ou Administrateur au compte Google Ads.
local_services_lead	Prospects issus des annonces de services locaux. Ne renvoie que les lignes pour les comptes Local Services.
local_services_lead_conversation	Conversations sur les prospects Local Services Ads. Ne renvoie que les lignes pour les comptes Local Services.

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.

customer_hourly_report

Indicateurs de performance au niveau du compte ventilés par heure.

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.
hour	int	Clé primaire. Heure de la journée (0 à 23).
click_type	string	Clé primaire. Cliquez sur le type.
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.
ctr	double	Taux 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.
hour	int	Clé primaire. Heure de la journée (0 à 23).
click_type	string	Clé primaire. Cliquez sur le type.
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.
ctr	double	Taux de clics.

Les tables de rapport horaire incluent également des colonnes de segment supplémentaires (day_of_week, week, month, quarter, year, interaction_event_types) et des colonnes de métriques (interactions, interaction_rate, average_cost, average_cpc, average_cpm, cost_per_conversion, value_per_conversion, conversions_value, conversions_from_interactions_rate et les métriques Active View).

campaign_hourly_report

Indicateurs de performance au niveau de la campagne ventilés par heure. Mêmes colonnes que customer_hourly_report, plus :

Colonne	Type de données	Description
id	long	Clé primaire. ID de campagne.
base_campaign	string	Nom de la ressource de la campagne de base pour les expérimentations.

Colonne	Type de données	Description
id	long	Clé primaire. ID de campagne.
base_campaign	string	Nom de la ressource de la campagne de base pour les expérimentations.

ad_group_hourly_report

Indicateurs de performance au niveau du groupe d’annonces ventilés par heure. Mêmes colonnes que customer_hourly_report, plus :

Colonne	Type de données	Description
id	long	Clé primaire. ID de groupe d'annonces.
campaign_id	long	ID de campagne associé.

Colonne	Type de données	Description
id	long	Clé primaire. ID de groupe d'annonces.
campaign_id	long	ID de campagne associé.

audience_report

Indicateurs de performance au niveau de l’audience (critère de groupe d’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_group_criterion_criterion_id	long	Clé primaire. ID de critère (audience) du groupe d'annonces.
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. Diviser par 1 000 000 pour convertir en devise.
conversions	double	Nombre de conversions.
conversions_value	double	Valeur de conversion totale.
view_through_conversions	long	Conversions après affichage.

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 de critère (audience) du groupe d'annonces.
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. Diviser par 1 000 000 pour convertir en devise.
conversions	double	Nombre de conversions.
conversions_value	double	Valeur de conversion totale.
view_through_conversions	long	Conversions après affichage.

click_report

Mesures au niveau du clic indexées par l'ID de clic Google.

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.
gclid	string	Clé primaire. ID de clic Google.
ad_group_id	long	ID de groupe d'annonces associé.
campaign_id	long	ID de campagne associé.
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.
gclid	string	Clé primaire. ID de clic Google.
ad_group_id	long	ID de groupe d'annonces associé.
campaign_id	long	ID de campagne associé.
clicks	long	Nombre de clics.

landing_page_report

Indicateurs de performance de la landing page indexés par URL finale développée.

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.
ad_group_id	long	Clé primaire. ID de groupe d'annonces.
campaign_id	long	Clé primaire. ID de campagne.
unexpanded_final_url	string	URL de la landing page avant expansion.
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.
ctr	double	Taux de clics.
average_cpc	double	Coût moyen par clic.
mobile_friendly_clicks_percentage	double	Pourcentage de clics adaptés aux mobiles.
speed_score	long	Score de vitesse mobile.
valid_accelerated_mobile_pages_clicks_percentage	double	Pourcentage de clics AMP valides.

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.
ad_group_id	long	Clé primaire. ID de groupe d'annonces.
campaign_id	long	Clé primaire. ID de campagne.
unexpanded_final_url	string	URL de la landing page avant expansion.
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.
ctr	double	Taux de clics.
average_cpc	double	Coût moyen par clic.
mobile_friendly_clicks_percentage	double	Pourcentage de clics adaptés aux mobiles.
speed_score	long	Score de vitesse mobile.
valid_accelerated_mobile_pages_clicks_percentage	double	Pourcentage de clics AMP valides.

search_keyword_report

Indicateurs de performance au niveau du mot clé à partir de la vue des mots clés.

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.
ad_group_criterion_criterion_id	long	ID du critère (mot-clé) du groupe d'annonces.
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.
cost_micros	long	Coût en micros. Diviser par 1 000 000 pour convertir en devise.
ctr	double	Taux de clics.
average_cpc	double	Coût moyen par clic.
conversions_value	double	Valeur de conversion totale.
view_through_conversions	long	Conversions après affichage.

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.
ad_group_criterion_criterion_id	long	ID du critère (mot-clé) du groupe d'annonces.
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.
cost_micros	long	Coût en micros. Diviser par 1 000 000 pour convertir en devise.
ctr	double	Taux de clics.
average_cpc	double	Coût moyen par clic.
conversions_value	double	Valeur de conversion totale.
view_through_conversions	long	Conversions après affichage.

Schémas de table d’événement

call_view

Appels suivis à partir d'extensions d'appel et d'annonces appel uniquement.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
resource_name	string	Clé primaire. Nom de la ressource Google Ads (ID d'appel).
ad_group_id	long	Clé primaire. Groupe d'annonces auquel l'appel est attribué.
campaign_id	long	Clé primaire. Campagne à laquelle l'appel est attribué.
start_call_date_time	string	Au moment où l'appel a start.
end_call_date_time	string	Quand l’appel s’est terminé.
caller_country_code	string	Code pays de l'appelant.
caller_area_code	string	Code de zone de l'appelant.
type	string	Type d’appel.
call_status	string	Statut de l'appel.
call_tracking_display_location	string	Où le numéro de suivi des appels était affiché.
call_duration_seconds	long	Durée de l'appel en secondes.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
resource_name	string	Clé primaire. Nom de la ressource Google Ads (ID d'appel).
ad_group_id	long	Clé primaire. Groupe d'annonces auquel l'appel est attribué.
campaign_id	long	Clé primaire. Campagne à laquelle l'appel est attribué.
start_call_date_time	string	Au moment où l'appel a start.
end_call_date_time	string	Quand l’appel s’est terminé.
caller_country_code	string	Code pays de l'appelant.
caller_area_code	string	Code de zone de l'appelant.
type	string	Type d’appel.
call_status	string	Statut de l'appel.
call_tracking_display_location	string	Où le numéro de suivi des appels était affiché.
call_duration_seconds	long	Durée de l'appel en secondes.

lead_form_submission

Soumissions de formulaires de leads. Requiert un accès Standard ou Administrateur au compte Google Ads.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
id	string	Clé primaire. ID de soumission du formulaire de lead.
ad_group_id	long	Clé primaire. Groupe d'annonces auquel la soumission est attribuée.
campaign_id	long	Clé primaire. Campagne à laquelle la soumission est attribuée.
resource_name	string	Nom de la ressource Google Ads.
submission_date_time	string	Lorsque le formulaire a été envoyé.
ad_id	long	Publicité ayant généré la soumission.
gclid	string	ID de clic Google.
lead_form_submission_fields	array<string>	Valeurs de champ standard soumises.
custom_lead_form_submission_fields	array<string>	Valeurs de champ personnalisées soumises.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
id	string	Clé primaire. ID de soumission du formulaire de lead.
ad_group_id	long	Clé primaire. Groupe d'annonces auquel la soumission est attribuée.
campaign_id	long	Clé primaire. Campagne à laquelle la soumission est attribuée.
resource_name	string	Nom de la ressource Google Ads.
submission_date_time	string	Lorsque le formulaire a été envoyé.
ad_id	long	Publicité ayant généré la soumission.
gclid	string	ID de clic Google.
lead_form_submission_fields	array<string>	Valeurs de champ standard soumises.
custom_lead_form_submission_fields	array<string>	Valeurs de champ personnalisées soumises.

local_services_lead

Prospects issus des annonces de services locaux. Ne renvoie que les lignes pour les comptes Local Services.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
id	long	Clé primaire. ID de prospect.
creation_date_time	string	Date de création du prospect.
category_id	string	ID de catégorie de service.
service_id	string	ID de service.
locale	string	Locale principale.
lead_charged	boolean	Si l'annonceur a été facturé pour le prospect.
lead_status	string	Statut du prospect.
lead_type	string	Type de prospect.
credit_details_credit_state	string	État du crédit, en cas de litige.
credit_details_credit_state_last_update_date_time	string	Date de la dernière mise à jour de l’état du crédit.
note_description	string	Texte de la note.
note_edit_date_time	string	Date de la dernière modification de la note.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
id	long	Clé primaire. ID de prospect.
creation_date_time	string	Date de création du prospect.
category_id	string	ID de catégorie de service.
service_id	string	ID de service.
locale	string	Locale principale.
lead_charged	boolean	Si l'annonceur a été facturé pour le prospect.
lead_status	string	Statut du prospect.
lead_type	string	Type de prospect.
credit_details_credit_state	string	État du crédit, en cas de litige.
credit_details_credit_state_last_update_date_time	string	Date de la dernière mise à jour de l’état du crédit.
note_description	string	Texte de la note.
note_edit_date_time	string	Date de la dernière modification de la note.

local_services_lead_conversation

Conversations sur les prospects Local Services Ads. Ne renvoie que les lignes pour les comptes Local Services.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
id	long	Clé primaire. ID de conversation.
event_date_time	string	Lorsque l’événement de conversation s’est produit.
local_services_lead_id	long	ID du prospect parent.
conversation_channel	string	Canal de discussion.
participant_type	string	Qui a initié la conversation.
message_details_text	string	Texte du message.
message_details_attachment_urls	array<string>	URL des pièces jointes.
phone_call_details_call_duration_millis	long	Durée de l’appel en millisecondes.
phone_call_details_call_recording_url	string	URL de l'enregistrement d'appel.

Colonne	Type de données	Description
customer_id	long	Clé primaire. ID de compte client.
id	long	Clé primaire. ID de conversation.
event_date_time	string	Lorsque l’événement de conversation s’est produit.
local_services_lead_id	long	ID du prospect parent.
conversation_channel	string	Canal de discussion.
participant_type	string	Qui a initié la conversation.
message_details_text	string	Texte du message.
message_details_attachment_urls	array<string>	URL des pièces jointes.
phone_call_details_call_duration_millis	long	Durée de l’appel en millisecondes.
phone_call_details_call_recording_url	string	URL de l'enregistrement d'appel.

Ingestion incrémentielle

Les tables de rapport prennent en charge l’ingestion incrémentielle avec une fenêtre rétrospective configurable. Le connecteur utilise la colonne date comme colonne curseur pour le suivi des mises à jour incrémentielles. Les tables de ressources et les tables d’événements sont entièrement actualisées à chaque exécution du pipeline.

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.
• La clé primaire est composée de chaque resource_name sélectionné ainsi que de tous les segments sélectionnés. Cela signifie le resource_name propre à la ressource de rapport, et un resource_name pour chaque ressource attribuée — une ressource autre que celle nommée dans resource, telle que campaign sur un rapport ad_group_ad. Aucun autre champ ne fait partie de la clé primaire : resource_name identifie déjà la ligne, et utiliser comme clé une valeur qui change en amont (telle que campaign.name) ajouterait une ligne en double au lieu de mettre à jour la ligne existante.
• Pour sélectionner des champs à partir d'une ressource attribuée, sélectionnez également resource_name de cette ressource. Par exemple, un rapport sur ad_group_ad qui sélectionne campaign.id doit également sélectionner campaign.resource_name. Google Ads renvoie une ligne par valeur attribuée ; sans ce resource_name, ces lignes partagent une clé primaire et la mise à jour échoue. La planification du pipeline vérifie cela et répertorie les champs resource_name à ajouter.
• 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.