Referência do conector do Google Ads

info

Beta

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a este recurso na página de Pré-visualizações . Veja as prévias do Gerenciador Databricks.

Esta página fornece informações de referência para o conector de gerenciamento do Google Ads no LakeFlow Connect, incluindo tabelas compatíveis, definições de colunas e tipos de dados.

Tabelas suportadas

O conector do Google Ads é compatível com os seguintes tipos de tabelas:

• Tabelas de recursos: Dados de configuração sobre sua account do Google Ads, como campanhas, grupos de anúncios e anúncios. Essas tabelas são totalmente atualizadas a cada execução do pipeline.
• Tabelas de relatórios: métricas de desempenho, como impressões, cliques e conversões. Essas tabelas suportam a ingestão incremental.
• Tabelas de eventos: eventos individuais como chamadas, envios de formulários de lead e leads de Serviços Locais. Estas tabelas são totalmente atualizadas a cada execução do pipeline.

tabelas de recursos

Nome da tabela	Descrição
customer	informações sobre a conta do Google Ads.
campaign	Configuração e definições da campanha.
campaign_budget	Configurações de orçamento para campanhas.
campaign_criterion	Critérios de segmentação para campanhas.
ad_group	Configuração do grupo de anúncios.
ad_group_criterion	Critérios de segmentação para grupos de anúncios.
ad	Detalhes e configurações individuais do anúncio.

Nome da tabela	Descrição
customer	informações sobre a conta do Google Ads.
campaign	Configuração e definições da campanha.
campaign_budget	Configurações de orçamento para campanhas.
campaign_criterion	Critérios de segmentação para campanhas.
ad_group	Configuração do grupo de anúncios.
ad_group_criterion	Critérios de segmentação para grupos de anúncios.
ad	Detalhes e configurações individuais do anúncio.

Tabelas de relatório

Nome da tabela	Descrição
customer_report	métricas de desempenho em nível de conta.
campaign_report	Avaliações de desempenho em nível de campanha.
ad_group_report	Avaliações de desempenho em nível de grupo de anúncios.
ad_report	Avaliações de desempenho em nível de anúncio.
keyword_report	Avaliações de desempenho em nível de palavra-chave.
search_query_report	Pesquisar métricas de desempenho em nível de consulta.
customer_hourly_report	Métricas de desempenho em nível de account detalhadas por hora.
campaign_hourly_report	Métricas de desempenho em nível de campanha detalhadas por hora.
ad_group_hourly_report	Métricas de desempenho no nível do grupo de anúncios detalhadas por hora.
audience_report	Métricas de desempenho em nível de público (critério de grupo de anúncios).
click_report	Métricas em nível de clique indexadas pelo Google Click ID (gclid).
landing_page_report	Métricas de desempenho da página de aterrissagem (URL final expandida).
search_keyword_report	Métricas de desempenho em nível de palavra-chave da view de palavra-chave.

Nome da tabela	Descrição
customer_report	métricas de desempenho em nível de conta.
campaign_report	Avaliações de desempenho em nível de campanha.
ad_group_report	Avaliações de desempenho em nível de grupo de anúncios.
ad_report	Avaliações de desempenho em nível de anúncio.
keyword_report	Avaliações de desempenho em nível de palavra-chave.
search_query_report	Pesquisar métricas de desempenho em nível de consulta.
customer_hourly_report	Métricas de desempenho em nível de account detalhadas por hora.
campaign_hourly_report	Métricas de desempenho em nível de campanha detalhadas por hora.
ad_group_hourly_report	Métricas de desempenho no nível do grupo de anúncios detalhadas por hora.
audience_report	Métricas de desempenho em nível de público (critério de grupo de anúncios).
click_report	Métricas em nível de clique indexadas pelo Google Click ID (gclid).
landing_page_report	Métricas de desempenho da página de aterrissagem (URL final expandida).
search_keyword_report	Métricas de desempenho em nível de palavra-chave da view de palavra-chave.

Tabelas de eventos

Nome da tabela	Descrição
call_view	Chamadas rastreadas a partir de extensões de chamada e anúncios apenas de chamada.
lead_form_submission	Envios de formulário de lead. Requer acesso Standard ou Admin à conta do Google Ads.
local_services_lead	Leads de anúncios de Serviços Locais. Retorna apenas linhas para contas de Serviços Locais.
local_services_lead_conversation	Conversas sobre leads de anúncios de serviços locais. Retorna apenas linhas para accounts de Local serviços.

Nome da tabela	Descrição
call_view	Chamadas rastreadas a partir de extensões de chamada e anúncios apenas de chamada.
lead_form_submission	Envios de formulário de lead. Requer acesso Standard ou Admin à conta do Google Ads.
local_services_lead	Leads de anúncios de Serviços Locais. Retorna apenas linhas para contas de Serviços Locais.
local_services_lead_conversation	Conversas sobre leads de anúncios de serviços locais. Retorna apenas linhas para accounts de Local serviços.

Convenções de tipo de dados

Armazenamento de dinheiro (micros)

O Google Ads armazena valores monetários em microssegundos para evitar problemas de arredondamento. Um milhão de micros equivale a uma unidade monetária:

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

Os campos com sufixo _micros contêm valores armazenados em micros. Divida por 1.000.000 para converter para a sua moeda.

Chave primária

As tabelas usam a notação (Primary Key) para indicar as colunas que formam a key primária. A chave primária composta é indicada por múltiplas colunas marcadas como (Primary Key).

esquemas de tabelas de recursos

customer

informações sobre a conta do Google Ads.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID account do cliente.
auto_tagging_enabled	boolean	Indica se a marcação automática está ativada para a account.
currency_code	string	Código da moeda da account.
descriptive_name	string	Nome amigável para a account do Google Ads.
final_url_suffix	string	Sufixo de URL adicionado aos URLs finais para acompanhamento.
manager	boolean	Se o cliente possui uma conta de Gerente (MCC).
optimization_score	double	Pontuação de otimização para a account.
pay_per_conversion_eligibility_failure_reasons	array<string>	Motivos pelos quais a account não é elegível para lances com pagamento por conversão.
test_account	boolean	Se o cliente é uma account de teste.
time_zone	string	Fuso horário da account.
tracking_url_template	string	URL padrão para construção de URLs de acompanhamento.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID account do cliente.
auto_tagging_enabled	boolean	Indica se a marcação automática está ativada para a account.
currency_code	string	Código da moeda da account.
descriptive_name	string	Nome amigável para a account do Google Ads.
final_url_suffix	string	Sufixo de URL adicionado aos URLs finais para acompanhamento.
manager	boolean	Se o cliente possui uma conta de Gerente (MCC).
optimization_score	double	Pontuação de otimização para a account.
pay_per_conversion_eligibility_failure_reasons	array<string>	Motivos pelos quais a account não é elegível para lances com pagamento por conversão.
test_account	boolean	Se o cliente é uma account de teste.
time_zone	string	Fuso horário da account.
tracking_url_template	string	URL padrão para construção de URLs de acompanhamento.

campaign

Configuração e definições da campanha.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID da campanha.
name	string	Nome da campanha.
status	string	Situação da campanha.
advertising_channel_type	string	Tipo de canal de publicidade.
start_date	string	Data de início da campanha.
end_date	string	Data de término da campanha.
campaign_budget_id	long	Identificação do orçamento de campanha associado.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID da campanha.
name	string	Nome da campanha.
status	string	Situação da campanha.
advertising_channel_type	string	Tipo de canal de publicidade.
start_date	string	Data de início da campanha.
end_date	string	Data de término da campanha.
campaign_budget_id	long	Identificação do orçamento de campanha associado.

campaign_budget

Configurações de orçamento para campanhas.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID do orçamento.
resource_name	string	Nome do recurso do Google Ads.
name	string	Nome do orçamento.
amount_micros	long	Valor do orçamento em microssegundos. Divida por 1.000.000 para converter para moeda corrente.
delivery_method	string	Como o Google gasta o orçamento diário (padrão ou acelerado).
period	string	Período orçamentário.
status	string	Situação orçamentária.
total_amount_micros	long	Montante total do orçamento em microssegundos. Divida por 1.000.000 para converter para moeda corrente.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID do orçamento.
resource_name	string	Nome do recurso do Google Ads.
name	string	Nome do orçamento.
amount_micros	long	Valor do orçamento em microssegundos. Divida por 1.000.000 para converter para moeda corrente.
delivery_method	string	Como o Google gasta o orçamento diário (padrão ou acelerado).
period	string	Período orçamentário.
status	string	Situação orçamentária.
total_amount_micros	long	Montante total do orçamento em microssegundos. Divida por 1.000.000 para converter para moeda corrente.

campaign_criterion

Critérios de segmentação para campanhas.

Coluna	Tipo de dados	Descrição
campaign_id	long	key primária. ID da campanha.
criterion_id	long	key primária. Critério de identificação.
resource_name	string	Nome do recurso do Google Ads.
type	string	Tipo de critério.
status	string	Status do critério.
negative	boolean	Se esse critério exclui um público.
bid_modifier	double	Valor do modificador de lance.

Coluna	Tipo de dados	Descrição
campaign_id	long	key primária. ID da campanha.
criterion_id	long	key primária. Critério de identificação.
resource_name	string	Nome do recurso do Google Ads.
type	string	Tipo de critério.
status	string	Status do critério.
negative	boolean	Se esse critério exclui um público.
bid_modifier	double	Valor do modificador de lance.

ad_group

Configuração do grupo de anúncios.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID do grupo de anúncios.
name	string	Nome do grupo de anúncios.
status	string	Status do grupo de anúncios.
campaign_id	long	ID da campanha associada.
type	string	Tipo de grupo de anúncios.
cpc_bid_micros	long	Lance de custo por clique em microssegundos.
target_cpa_micros	long	Custo alvo por aquisição em microssegundos.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID do grupo de anúncios.
name	string	Nome do grupo de anúncios.
status	string	Status do grupo de anúncios.
campaign_id	long	ID da campanha associada.
type	string	Tipo de grupo de anúncios.
cpc_bid_micros	long	Lance de custo por clique em microssegundos.
target_cpa_micros	long	Custo alvo por aquisição em microssegundos.

ad_group_criterion

Critérios de segmentação para grupos de anúncios.

Coluna	Tipo de dados	Descrição
criterion_id	long	key primária. Critério de identificação.
ad_group_id	long	key primária. ID do grupo de anúncios.
resource_name	string	Nome do recurso do Google Ads.
status	string	Status do critério.
type	string	Tipo de critério.
negative	boolean	Se esse critério exclui um público.
keyword_match_type	string	Tipo de correspondência de palavras-chave (exata, frase, ampla).
keyword_text	string	Texto com palavra-chave.

Coluna	Tipo de dados	Descrição
criterion_id	long	key primária. Critério de identificação.
ad_group_id	long	key primária. ID do grupo de anúncios.
resource_name	string	Nome do recurso do Google Ads.
status	string	Status do critério.
type	string	Tipo de critério.
negative	boolean	Se esse critério exclui um público.
keyword_match_type	string	Tipo de correspondência de palavras-chave (exata, frase, ampla).
keyword_text	string	Texto com palavra-chave.

ad

Detalhes e configurações individuais do anúncio. Esta tabela corresponde a ad_group_ad na API do Google Ads.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID do anúncio.
ad_group_id	long	key primária. ID do grupo de anúncios.
status	string	Status do anúncio.
ad_type	string	Tipo de anúncio.
final_urls	array<string>	URLs de páginas de aterrissagem após clicar no anúncio.
policy_summary_approval_status	string	Se o anúncio foi aprovado de acordo com a política do Google Ads (APROVADO ou REPROVADO).
policy_summary_review_status	string	Indica se o Google concluiu a análise do anúncio (REVIEW_IN_PROGRESS ou REVIEWED).

Coluna	Tipo de dados	Descrição
id	long	key primária. ID do anúncio.
ad_group_id	long	key primária. ID do grupo de anúncios.
status	string	Status do anúncio.
ad_type	string	Tipo de anúncio.
final_urls	array<string>	URLs de páginas de aterrissagem após clicar no anúncio.
policy_summary_approval_status	string	Se o anúncio foi aprovado de acordo com a política do Google Ads (APROVADO ou REPROVADO).
policy_summary_review_status	string	Indica se o Google concluiu a análise do anúncio (REVIEW_IN_PROGRESS ou REVIEWED).

Esquemas de tabelas de relatório

customer_report

métricas de desempenho em nível de conta.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros. Divida por 1.000.000 para converter para moeda corrente.
conversions	double	Número de conversões.
conversions_value	double	Valor total da conversão.
ctr	double	Taxa de cliques.
average_cpc	double	Custo médio por clique.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros. Divida por 1.000.000 para converter para moeda corrente.
conversions	double	Número de conversões.
conversions_value	double	Valor total da conversão.
ctr	double	Taxa de cliques.
average_cpc	double	Custo médio por clique.

campaign_report

Avaliações de desempenho em nível de campanha.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
id	long	key primária. ID da campanha.
date	string	key primária. Data no formato AAAA-MM-DD.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
campaign_name	string	Nome da campanha.
campaign_status	string	Situação da campanha.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros.
conversions	double	Número de conversões.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
id	long	key primária. ID da campanha.
date	string	key primária. Data no formato AAAA-MM-DD.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
campaign_name	string	Nome da campanha.
campaign_status	string	Situação da campanha.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros.
conversions	double	Número de conversões.

ad_group_report

Avaliações de desempenho em nível de grupo de anúncios.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
id	long	key primária. ID do grupo de anúncios.
date	string	key primária. Data no formato AAAA-MM-DD.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
ad_group_name	string	Nome do grupo de anúncios.
ad_group_status	string	Status do grupo de anúncios.
campaign_id	long	ID da campanha associada.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
id	long	key primária. ID do grupo de anúncios.
date	string	key primária. Data no formato AAAA-MM-DD.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
ad_group_name	string	Nome do grupo de anúncios.
ad_group_status	string	Status do grupo de anúncios.
campaign_id	long	ID da campanha associada.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros.

keyword_report

Avaliações de desempenho em nível de palavra-chave.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
ad_group_criterion_criterion_id	long	key primária. Critério de identificação.
ad_group_id	long	key primária. ID do grupo de anúncios.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
keyword_text	string	Texto com palavra-chave.
keyword_match_type	string	Tipo de correspondência de palavras-chave.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
ad_group_criterion_criterion_id	long	key primária. Critério de identificação.
ad_group_id	long	key primária. ID do grupo de anúncios.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
keyword_text	string	Texto com palavra-chave.
keyword_match_type	string	Tipo de correspondência de palavras-chave.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros.

ad_report

Avaliações de desempenho em nível de anúncio.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
ad_id	long	key primária. ID do anúncio.
ad_group_id	long	key primária. ID do grupo de anúncios.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
campaign_id	long	ID da campanha associada.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros.
conversions	double	Número de conversões.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
ad_id	long	key primária. ID do anúncio.
ad_group_id	long	key primária. ID do grupo de anúncios.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
campaign_id	long	ID da campanha associada.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros.
conversions	double	Número de conversões.

search_query_report

Pesquisar métricas de desempenho em nível de consulta.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
resource_name	string	key primária. Nome do recurso do Google Ads.
search_term	string	Termo de pesquisa do usuário.
search_term_match_type	string	Como a palavra-chave correspondeu ao termo de pesquisa.
ad_group_id	long	ID do grupo de anúncios associado.
campaign_id	long	ID da campanha associada.
impressions	long	Número de impressões.
clicks	long	Número de cliques.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
resource_name	string	key primária. Nome do recurso do Google Ads.
search_term	string	Termo de pesquisa do usuário.
search_term_match_type	string	Como a palavra-chave correspondeu ao termo de pesquisa.
ad_group_id	long	ID do grupo de anúncios associado.
campaign_id	long	ID da campanha associada.
impressions	long	Número de impressões.
clicks	long	Número de cliques.

customer_hourly_report

Métricas de desempenho em nível de account detalhadas por hora.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
hour	int	Chave primária. Hora do dia (0–23).
click_type	string	Chave primária. Clique no tipo.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros. Divida por 1.000.000 para converter para moeda corrente.
conversions	double	Número de conversões.
ctr	double	Taxa de cliques.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
hour	int	Chave primária. Hora do dia (0–23).
click_type	string	Chave primária. Clique no tipo.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros. Divida por 1.000.000 para converter para moeda corrente.
conversions	double	Número de conversões.
ctr	double	Taxa de cliques.

As tabelas de relatório por hora também incluem colunas de segmento adicionais (day_of_week, week, month, quarter, year, interaction_event_types) e colunas de métricas (interactions, interaction_rate, average_cost, average_cpc, average_cpm, cost_per_conversion, value_per_conversion, conversions_value, conversions_from_interactions_rate e métricas de Active View).

campaign_hourly_report

Métricas de desempenho em nível de campanha detalhadas por hora. Mesmas colunas que customer_hourly_report, mais:

Coluna	Tipo de dados	Descrição
id	long	key primária. ID da campanha.
base_campaign	string	Nome do recurso da campanha base para experimentos.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID da campanha.
base_campaign	string	Nome do recurso da campanha base para experimentos.

ad_group_hourly_report

Métricas de desempenho no nível do grupo de anúncios detalhadas por hora. Mesmas colunas que customer_hourly_report, mais:

Coluna	Tipo de dados	Descrição
id	long	key primária. ID do grupo de anúncios.
campaign_id	long	ID da campanha associada.

Coluna	Tipo de dados	Descrição
id	long	key primária. ID do grupo de anúncios.
campaign_id	long	ID da campanha associada.

audience_report

Métricas de desempenho em nível de público (critério de grupo de anúncios).

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
ad_group_criterion_criterion_id	long	Chave primária. ID do critério (público-alvo) do grupo de anúncios.
ad_group_id	long	key primária. ID do grupo de anúncios.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
campaign_id	long	ID da campanha associada.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros. Divida por 1.000.000 para converter para moeda corrente.
conversions	double	Número de conversões.
conversions_value	double	Valor total da conversão.
view_through_conversions	long	Conversões por visualização.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
ad_group_criterion_criterion_id	long	Chave primária. ID do critério (público-alvo) do grupo de anúncios.
ad_group_id	long	key primária. ID do grupo de anúncios.
device	string	key primária. Tipo de dispositivo.
ad_network_type	string	key primária. Tipo de rede de anúncios.
campaign_id	long	ID da campanha associada.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros. Divida por 1.000.000 para converter para moeda corrente.
conversions	double	Número de conversões.
conversions_value	double	Valor total da conversão.
view_through_conversions	long	Conversões por visualização.

click_report

Métricas em nível de clique indexadas pelo Google Click ID.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
gclid	string	Chave primária. Google Click ID.
ad_group_id	long	ID do grupo de anúncios associado.
campaign_id	long	ID da campanha associada.
clicks	long	Número de cliques.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
gclid	string	Chave primária. Google Click ID.
ad_group_id	long	ID do grupo de anúncios associado.
campaign_id	long	ID da campanha associada.
clicks	long	Número de cliques.

landing_page_report

Métricas de desempenho das páginas de aterrissagem indexadas pela URL final expandida.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
resource_name	string	key primária. Nome do recurso do Google Ads.
ad_group_id	long	key primária. ID do grupo de anúncios.
campaign_id	long	key primária. ID da campanha.
unexpanded_final_url	string	URL da página de aterrissagem antes da expansão.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros. Divida por 1.000.000 para converter para moeda corrente.
ctr	double	Taxa de cliques.
average_cpc	double	Custo médio por clique.
mobile_friendly_clicks_percentage	double	Porcentagem de cliques compatíveis com dispositivos móveis.
speed_score	long	Pontuação de velocidade móvel.
valid_accelerated_mobile_pages_clicks_percentage	double	Porcentagem de cliques AMP válidos.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
resource_name	string	key primária. Nome do recurso do Google Ads.
ad_group_id	long	key primária. ID do grupo de anúncios.
campaign_id	long	key primária. ID da campanha.
unexpanded_final_url	string	URL da página de aterrissagem antes da expansão.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros. Divida por 1.000.000 para converter para moeda corrente.
ctr	double	Taxa de cliques.
average_cpc	double	Custo médio por clique.
mobile_friendly_clicks_percentage	double	Porcentagem de cliques compatíveis com dispositivos móveis.
speed_score	long	Pontuação de velocidade móvel.
valid_accelerated_mobile_pages_clicks_percentage	double	Porcentagem de cliques AMP válidos.

search_keyword_report

Métricas de desempenho em nível de palavra-chave da view de palavra-chave.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
resource_name	string	key primária. Nome do recurso do Google Ads.
ad_group_criterion_criterion_id	long	ID do critério (palavra-chave) do grupo de anúncios.
ad_group_id	long	ID do grupo de anúncios associado.
campaign_id	long	ID da campanha associada.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros. Divida por 1.000.000 para converter para moeda corrente.
ctr	double	Taxa de cliques.
average_cpc	double	Custo médio por clique.
conversions_value	double	Valor total da conversão.
view_through_conversions	long	Conversões por visualização.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
date	string	key primária. Data no formato AAAA-MM-DD.
resource_name	string	key primária. Nome do recurso do Google Ads.
ad_group_criterion_criterion_id	long	ID do critério (palavra-chave) do grupo de anúncios.
ad_group_id	long	ID do grupo de anúncios associado.
campaign_id	long	ID da campanha associada.
impressions	long	Número de impressões.
clicks	long	Número de cliques.
cost_micros	long	Custo em micros. Divida por 1.000.000 para converter para moeda corrente.
ctr	double	Taxa de cliques.
average_cpc	double	Custo médio por clique.
conversions_value	double	Valor total da conversão.
view_through_conversions	long	Conversões por visualização.

Esquemas de tabela de eventos

call_view

Chamadas rastreadas a partir de extensões de chamada e anúncios apenas de chamada.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
resource_name	string	Chave primária. Nome do recurso do Google Ads (ID da chamada).
ad_group_id	long	Chave primária. Grupo de anúncios ao qual a chamada é atribuída.
campaign_id	long	Chave primária. Campanha à qual a chamada é atribuída.
start_call_date_time	string	Quando a chamada começou.
end_call_date_time	string	Quando a chamada terminou.
caller_country_code	string	Código de país do chamador.
caller_area_code	string	Código de área do chamador.
type	string	Tipo de chamada.
call_status	string	Status da chamada.
call_tracking_display_location	string	Onde o número de acompanhamento da chamada foi mostrado.
call_duration_seconds	long	Duração da chamada em segundos.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
resource_name	string	Chave primária. Nome do recurso do Google Ads (ID da chamada).
ad_group_id	long	Chave primária. Grupo de anúncios ao qual a chamada é atribuída.
campaign_id	long	Chave primária. Campanha à qual a chamada é atribuída.
start_call_date_time	string	Quando a chamada começou.
end_call_date_time	string	Quando a chamada terminou.
caller_country_code	string	Código de país do chamador.
caller_area_code	string	Código de área do chamador.
type	string	Tipo de chamada.
call_status	string	Status da chamada.
call_tracking_display_location	string	Onde o número de acompanhamento da chamada foi mostrado.
call_duration_seconds	long	Duração da chamada em segundos.

lead_form_submission

Envios de formulário de lead. Requer acesso Standard ou Admin à conta do Google Ads.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
id	string	Chave primária. ID de envio do formulário de lead.
ad_group_id	long	Chave primária. Grupo de anúncios ao qual a submissão é atribuída.
campaign_id	long	Chave primária. Campanha à qual o envio é atribuído.
resource_name	string	Nome do recurso do Google Ads.
submission_date_time	string	Quando o formulário foi enviado.
ad_id	long	Anúncio que gerou o envio.
gclid	string	Google Click ID.
lead_form_submission_fields	array<string>	Valores de campo padrão enviados.
custom_lead_form_submission_fields	array<string>	Valores de campo personalizados enviados.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
id	string	Chave primária. ID de envio do formulário de lead.
ad_group_id	long	Chave primária. Grupo de anúncios ao qual a submissão é atribuída.
campaign_id	long	Chave primária. Campanha à qual o envio é atribuído.
resource_name	string	Nome do recurso do Google Ads.
submission_date_time	string	Quando o formulário foi enviado.
ad_id	long	Anúncio que gerou o envio.
gclid	string	Google Click ID.
lead_form_submission_fields	array<string>	Valores de campo padrão enviados.
custom_lead_form_submission_fields	array<string>	Valores de campo personalizados enviados.

local_services_lead

Leads de anúncios de Serviços Locais. Retorna apenas linhas para contas de Serviços Locais.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
id	long	Chave primária. ID do lead.
creation_date_time	string	Quando o lead foi criado.
category_id	string	ID da categoria de serviço.
service_id	string	ID do serviço.
locale	string	Localidade principal.
lead_charged	boolean	Se o anunciante foi cobrado pelo lead.
lead_status	string	Status do lead.
lead_type	string	Tipo de lead.
credit_details_credit_state	string	Estado de crédito, se contestado.
credit_details_credit_state_last_update_date_time	string	Quando o estado do crédito foi atualizado pela última vez.
note_description	string	Texto da nota.
note_edit_date_time	string	Quando a nota foi editada pela última vez.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
id	long	Chave primária. ID do lead.
creation_date_time	string	Quando o lead foi criado.
category_id	string	ID da categoria de serviço.
service_id	string	ID do serviço.
locale	string	Localidade principal.
lead_charged	boolean	Se o anunciante foi cobrado pelo lead.
lead_status	string	Status do lead.
lead_type	string	Tipo de lead.
credit_details_credit_state	string	Estado de crédito, se contestado.
credit_details_credit_state_last_update_date_time	string	Quando o estado do crédito foi atualizado pela última vez.
note_description	string	Texto da nota.
note_edit_date_time	string	Quando a nota foi editada pela última vez.

local_services_lead_conversation

Conversas sobre leads de anúncios de serviços locais. Retorna apenas linhas para accounts de Local serviços.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
id	long	Chave primária. ID da conversa.
event_date_time	string	Quando o evento de conversa ocorreu.
local_services_lead_id	long	ID do lead pai.
conversation_channel	string	Canal de conversa.
participant_type	string	Quem iniciou a conversa.
message_details_text	string	Texto da mensagem.
message_details_attachment_urls	array<string>	URLs de anexo.
phone_call_details_call_duration_millis	long	Duração da chamada em milissegundos.
phone_call_details_call_recording_url	string	URL de gravação de chamada.

Coluna	Tipo de dados	Descrição
customer_id	long	key primária. ID account do cliente.
id	long	Chave primária. ID da conversa.
event_date_time	string	Quando o evento de conversa ocorreu.
local_services_lead_id	long	ID do lead pai.
conversation_channel	string	Canal de conversa.
participant_type	string	Quem iniciou a conversa.
message_details_text	string	Texto da mensagem.
message_details_attachment_urls	array<string>	URLs de anexo.
phone_call_details_call_duration_millis	long	Duração da chamada em milissegundos.
phone_call_details_call_recording_url	string	URL de gravação de chamada.

Ingestão incremental

As tabelas de relatório suportam ingestão incremental com uma janela de retrospectiva configurável. O conector usa a coluna date como a coluna do cursor para o acompanhamento de atualizações incrementais. As tabelas de recurso e as tabelas de evento são totalmente atualizadas a cada execução do pipeline.

Para obter mais informações sobre ingestão incremental e janelas de retrospectiva, consulte Conceitos do conector do Google Ads.

Opções de configuração de relatório personalizado

Relatórios personalizados permitem selecionar qualquer recurso do Google Ads com uma combinação de campos de recurso, segmentos e métricas. O nome destination_table é obrigatório.

Defina source_table como custom_report e forneça custom_report_options em connector_options.google_ads_options:

Opção	Obrigatório	Descrição
resource	Sim	O recurso do Google Ads para query (por exemplo, ad_group_ad, keyword_view, search_term_view). O recurso deve suportar métricas.
resource_fields	Não	Campos de recurso para selecionar, no formato GAQL totalmente qualificado (por exemplo, ad_group_ad.ad.id, ad_group_ad.status). O nome do recurso é adicionado por default.
segments	Não	Campos de segmento para selecionar (por exemplo, segments.date, segments.device). É necessário incluir pelo menos um segmento de linha do tempo — segments.date, segments.week ou segments.month — que se torna o cursor incremental da tabela.
metrics	Não	Campos de métricas para selecionar (por exemplo, metrics.clicks, metrics.cost_micros).

Opção	Obrigatório	Descrição
resource	Sim	O recurso do Google Ads para query (por exemplo, ad_group_ad, keyword_view, search_term_view). O recurso deve suportar métricas.
resource_fields	Não	Campos de recurso para selecionar, no formato GAQL totalmente qualificado (por exemplo, ad_group_ad.ad.id, ad_group_ad.status). O nome do recurso é adicionado por default.
segments	Não	Campos de segmento para selecionar (por exemplo, segments.date, segments.device). É necessário incluir pelo menos um segmento de linha do tempo — segments.date, segments.week ou segments.month — que se torna o cursor incremental da tabela.
metrics	Não	Campos de métricas para selecionar (por exemplo, metrics.clicks, metrics.cost_micros).

Observações:

• As colunas de destino omitem os prefixos padrão metrics. e segments.; para campos de recurso, os pontos são convertidos em underscores (por exemplo, ad_group_ad.ad.id se torna ad_group_ad_ad_id).
• O atributo resource_name é sempre incluído para identificar cada linha.
• A key primária é cada resource_name selecionado mais todos os segmentos selecionados. Isso significa o próprio resource_name do recurso de relatório e um resource_name para cada recurso atribuído — um recurso diferente daquele nomeado em resource, como campaign em um relatório ad_group_ad. Nenhum outro campo faz parte da chave primária: resource_name já identifica a linha, e usar como chave um valor que muda a montante (como campaign.name) adicionaria uma linha duplicada em vez de atualizar a existente.
• Para selecionar campos de um recurso atribuído, selecione também o resource_name desse recurso. Por exemplo, um relatório sobre ad_group_ad que seleciona campaign.id também deve selecionar campaign.resource_name. O Google Ads retorna uma linha por valor atribuído, portanto, sem esse resource_name, essas linhas compartilham uma chave primária e a atualização falha. O planejamento do pipeline verifica isso e lista os resource_name campos a serem adicionados.
• A ingestão de relatórios personalizados é incremental, com base na janela de retrospectiva.
• Google Ads retém dados segmentados diária e semanalmente por apenas 37 meses. Relatórios personalizados que usam segments.date ou segments.week não podem sincronizar dados mais antigos que esta janela; use segments.month para dados mais antigos.
• O planejamento de pipeline valida nomes de campo em relação ao Google Ads. A falta de segmentos de linha do tempo ou campos inválidos causa falhas de atualização. Use a configuração validate_only para testar configurações sem mover dados.