01. Google Ads (Adwords)

Adicionando o conector

Instruções

Faça login na plataforma da Kondado, vá para a página de adicionar conectores e selecione o conector do Google Adwords
Clique em AUTORIZAR
Selecione a conta que irá utilizar
Na próxima tela, marque TODAS as permissões que são requisitadas e clique em Continue
Você será redirecionado para a Kondado e bastará dar um nome ao seu conector e clicar em SALVAR

💡Veja aqui o guia das dúvidas mais comuns sobre as integrações do Google Ads

Confira o guia das dúvidas mais comuns sobre as integrações do Google Ads.

Integrações

Gráfico de relacionamento

Clique para ampliar

Conversões de Campanha por Ação

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicação de dados.
Janela de atualização: Quantos dias retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Período: Selecione o período de dados. Use Incremental para atualizações diárias com savepoint.

Conversoes de campanha do Google Ads detalhadas por acao de conversao.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta do Google Ads.
segments_date	date	[pt] Data a qual as metricas se aplicam. Formato yyyy-MM-dd.
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
segments_conversionactionname	text	[pt] Nome da acao de conversao.
segments_conversionactioncategory	text	[pt] Categoria da acao de conversao.
metrics_conversions	float	[pt] Numero de conversoes.
metrics_conversionsvalue	float	[pt] Valor total das conversoes.
metrics_allconversions	float	[pt] Numero total de conversoes (incluindo conversoes nao contabilizadas).
metrics_allconversionsvalue	float	[pt] Valor total de todas as conversoes.

Desempenho de Campanha Diário

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicação de dados.
Janela de atualização: Quantos dias retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Período: Selecione o período de dados. Use Incremental para atualizações diárias com savepoint.

Desempenho diario de campanhas do Google Ads com metricas agregadas por campanha e data.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta do Google Ads.
segments_date	date	[pt] Data a qual as metricas se aplicam. Formato yyyy-MM-dd.
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
campaign_advertising_channel_type	text	[pt] Tipo de canal de publicidade da campanha (ex: SEARCH, DISPLAY, VIDEO).
campaign_status	text	[pt] Status da campanha (ENABLED, PAUSED, REMOVED).
metrics_impressions	float	[pt] Numero de vezes que seu anuncio apareceu em uma pagina de resultados de pesquisa ou site na Rede do Google.
metrics_clicks	float	[pt] Numero de cliques.
metrics_cost_micros	float	[pt] Soma dos custos de custo por clique (CPC) e custo por mil impressoes (CPM) durante este periodo, em micros.
metrics_conversions	float	[pt] Numero de conversoes.
metrics_ctr	float	[pt] Taxa de cliques (CTR): numero de cliques dividido pelo numero de impressoes.
metrics_average_cpc	float	[pt] Custo medio por clique: custo total de todos os cliques dividido pelo numero total de cliques.

Relatório personalizado

Notas importantes sobre esta integração:

Caso precise de ajuda para criar esta integração, confira:
Esta integração busca os dados de fato da performance dos seus anúncios e permite que você defina exatamente como quer buscar os seus dados, de acordo com o relatório, métricas e dimensões selecionadas
Como é possível buscar dados de várias contas na mesma integração (inclusive com MCC) por padrão a tabela desta integração conterá a coluna __kdd_account_id que indica a qual conta se referem os dados

Tipo de replicacao: Integral

Parametros:

Dimensões: Selecione as dimensões do relatório. Mais informações em: kondado.com.br/wiki
Métricas: Selecione as métricas do relatório. Mais informações em: kondado.com.br/wiki
Relatório: Selecione o relatório a ser utilizado. Mais informações em: kondado.com.br/wiki
Data inicial de leitura (Savepoint): Selecione a data inicial de leitura dos dados
Janela de atualização: Por quantos períodos anteriores ao savepoint os dados serão atualizados. Mais informações em: kondado.com.br/wiki
Contas: Selecione as contas que serão buscadas. Deixe em branco para buscar todas as contas associadas ao seu conector

Campo	Tipo
_kdd_account_id	text
dimension_x	text
dimension_y	date
dimension_z	text
metric_a	float
metric_b	int
metric_c	float

Desempenho de Anúncio Diário

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicação de dados.
Janela de atualização: Quantos dias retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Período: Selecione o período de dados. Use Incremental para atualizações diárias com savepoint.

Desempenho diario de anuncios do Google Ads com metricas agregadas por anuncio e data - *não retorna dados de PMAX*.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta do Google Ads.
segments_date	date	[pt] Data a qual as metricas se aplicam. Formato yyyy-MM-dd.
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
ad_group_id	float	[pt] ID do grupo de anuncios.
ad_group_name	text	[pt] Nome do grupo de anuncios.
ad_group_ad_ad_id	float	[pt] ID do anuncio.
ad_group_ad_ad_name	text	[pt] Nome do anuncio.
metrics_impressions	float	[pt] Numero de vezes que seu anuncio apareceu em uma pagina de resultados de pesquisa ou site na Rede do Google.
metrics_clicks	float	[pt] Numero de cliques.
metrics_cost_micros	float	[pt] Soma dos custos de custo por clique (CPC) e custo por mil impressoes (CPM) durante este periodo, em micros.
metrics_conversions	float	[pt] Numero de conversoes.
metrics_conversions_value	float	[pt] Valor total das conversoes.
metrics_all_conversions	float	[pt] Numero total de conversoes (incluindo conversoes nao contabilizadas).
metrics_all_conversions_value	float	[pt] Valor total de todas as conversoes.

Conversões de Anúncios por Ação

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicação de dados.
Janela de atualização: Quantos dias retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Período: Selecione o período de dados. Use Incremental para atualizações diárias com savepoint.

Conversoes de anuncios por acao do Google Ads com metricas de conversao agregadas por anuncio, acao de conversao e data.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta do Google Ads.
segments_date	date	[pt] Data a qual as metricas se aplicam. Formato yyyy-MM-dd.
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
ad_group_id	float	[pt] ID do grupo de anuncios.
ad_group_name	text	[pt] Nome do grupo de anuncios.
segments_conversion_action_name	text	[pt] Nome da acao de conversao.
segments_conversion_action_category	text	[pt] Categoria da acao de conversao.
metrics_conversions	float	[pt] Numero de conversoes.
metrics_all_conversions	float	[pt] Numero total de conversoes (incluindo conversoes nao contabilizadas).
metrics_all_conversions_value	float	[pt] Valor total de todas as conversoes.

Desempenho de Campanhas de Video

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicacao de dados.
Janela de atualizacao: Quantos dias retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Periodo: Selecione o periodo de dados. Use Incremental para atualizacoes diarias com savepoint.

Desempenho de video de campanhas do Google Ads com metricas de visualizacao e engajamento agregadas por campanha e data.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta do Google Ads.
segments_date	date	[pt] Data a qual as metricas se aplicam. Formato yyyy-MM-dd.
campaign_id	text	[pt] O ID da campanha.
campaign_name	text	[pt] O nome da campanha.
customer_id	text	[pt] O ID do cliente.
customer_descriptive_name	text	[pt] Nome descritivo do cliente.
metrics_impressions	int	[pt] Contagem de quantas vezes seu anuncio apareceu.
metrics_clicks	int	[pt] Numero de cliques.
metrics_cost_micros	int	[pt] A soma dos custos de CPC e CPM em micros.
metrics_video_trueview_views	int	[pt] O numero de vezes que seus anuncios de video TrueView foram visualizados.
metrics_video_quartile_p25_rate	float	[pt] Porcentagem de impressoes onde o espectador assistiu 25% do video.
metrics_video_quartile_p50_rate	float	[pt] Porcentagem de impressoes onde o espectador assistiu 50% do video.
metrics_video_quartile_p75_rate	float	[pt] Porcentagem de impressoes onde o espectador assistiu 75% do video.
metrics_video_quartile_p100_rate	float	[pt] Porcentagem de impressoes onde o espectador assistiu 100% do video.
metrics_engagements	int	[pt] Numero de engajamentos. Um engajamento ocorre quando um espectador expande seu anuncio lightbox.

Desempenho de Grupo de Anuncios Diario

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicacao de dados.
Janela de atualizacao: Quantos dias retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Periodo: Selecione o periodo de dados. Use Incremental para atualizacoes diarias com savepoint.

Desempenho diario de grupos de anuncios do Google Ads com metricas agregadas por grupo de anuncio e data.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta do Google Ads.
segments_date	date	[pt] Data a qual as metricas se aplicam. Formato yyyy-MM-dd.
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
ad_group_id	float	[pt] ID do grupo de anuncios.
ad_group_name	text	[pt] Nome do grupo de anuncios.
ad_group_status	text	[pt] Status do grupo de anuncios (ENABLED, PAUSED, REMOVED).
metrics_impressions	float	[pt] Numero de vezes que seu anuncio apareceu em uma pagina de resultados de pesquisa ou site na Rede do Google.
metrics_clicks	float	[pt] Numero de cliques.
metrics_cost_micros	float	[pt] Soma dos custos de custo por clique (CPC) e custo por mil impressoes (CPM) durante este periodo, em micros.
metrics_conversions	float	[pt] Numero de conversoes.
metrics_ctr	float	[pt] Taxa de cliques (CTR): numero de cliques dividido pelo numero de impressoes.
metrics_average_cpc	float	[pt] Custo medio por clique: custo total de todos os cliques dividido pelo numero total de cliques.

Desempenho de Palavra-chave Diário

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicação de dados.
Janela de atualização: Quantos dias retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Período: Selecione o período de dados. Use Incremental para atualizações diárias com savepoint.

Desempenho diario de palavras-chave do Google Ads com metricas agregadas por palavra-chave e data.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta do Google Ads.
segments_date	date	[pt] Data a qual as metricas se aplicam. Formato yyyy-MM-dd.
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
ad_group_id	float	[pt] ID do grupo de anuncios.
ad_group_name	text	[pt] Nome do grupo de anuncios.
ad_group_criterion_keyword_text	text	[pt] Texto da palavra-chave.
ad_group_criterion_keyword_match_type	text	[pt] Tipo de correspondencia da palavra-chave (EXACT, PHRASE, BROAD).
metrics_impressions	float	[pt] Numero de vezes que seu anuncio apareceu em uma pagina de resultados de pesquisa ou site na Rede do Google.
metrics_clicks	float	[pt] Numero de cliques.
metrics_cost_micros	float	[pt] Soma dos custos de custo por clique (CPC) e custo por mil impressoes (CPM) durante este periodo, em micros.
metrics_conversions	float	[pt] Numero de conversoes.
metrics_ctr	float	[pt] Taxa de cliques (CTR): numero de cliques dividido pelo numero de impressoes.
metrics_average_cpc	float	[pt] Custo medio por clique: custo total de todos os cliques dividido pelo numero total de cliques.
metrics_search_impression_share	float	[pt] Porcentagem de impressoes de pesquisa que seu anuncio recebeu em relacao ao total estimado de impressoes de pesquisa elegiveis.

Desempenho Geografico

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicacao de dados.
Janela de atualizacao: Quantos meses retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Periodo: Selecione o periodo de dados. Use Incremental para atualizacoes com savepoint.

Desempenho geografico de campanhas do Google Ads com metricas agregadas por localizacao, campanha e mes.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta do Google Ads.
segments_month	date	[pt] Mes ao qual as metricas se aplicam. Formato yyyy-MM-dd (primeiro dia do mes).
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
segments_geo_target_city	text	[pt] Nome da cidade de destino do anuncio.
segments_geo_target_state	text	[pt] Nome do estado de destino do anuncio.
metrics_impressions	float	[pt] Numero de vezes que seu anuncio apareceu em uma pagina de resultados de pesquisa ou site na Rede do Google.
metrics_clicks	float	[pt] Numero de cliques.
metrics_cost_micros	float	[pt] Soma dos custos de custo por clique (CPC) e custo por mil impressoes (CPM) durante este periodo, em micros.
metrics_conversions	float	[pt] Numero de conversoes.
metrics_average_cpc	float	[pt] Custo medio por clique: custo total de todos os cliques dividido pelo numero total de cliques.
metrics_cost_per_conversion	float	[pt] Custo medio por conversao: custo total dividido pelo numero de conversoes.

Analise de Orcamento de Campanha

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicacao de dados.
Janela de atualizacao: Quantos meses retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Periodo: Selecione o periodo de dados. Use Incremental para atualizacoes com savepoint.

Analise de orcamento de campanhas do Google Ads.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta.
segments_date	date	[pt] Data.
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
campaign_budget_amount_micros	float	[pt] Orcamento em micros.
campaign_start_date	date	[pt] Data inicio.
campaign_end_date	date	[pt] Data fim.
metrics_cost_micros	float	[pt] Custo em micros.
metrics_impressions	float	[pt] Impressoes.
metrics_clicks	float	[pt] Cliques.
metrics_conversions	float	[pt] Conversoes.

Desempenho por Faixa Etaria

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicacao de dados.
Janela de atualizacao: Quantos meses retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Periodo: Selecione o periodo de dados. Use Incremental para atualizacoes com savepoint.

Desempenho por faixa etaria do Google Ads.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta.
segments_date	date	[pt] Data.
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
ad_group_criterion_age_range_type	text	[pt] Faixa etaria.
metrics_impressions	float	[pt] Impressoes.
metrics_clicks	float	[pt] Cliques.
metrics_cost_micros	float	[pt] Custo em micros.
metrics_conversions	float	[pt] Conversoes.

Desempenho por Genero

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicacao de dados.
Janela de atualizacao: Quantos meses retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Periodo: Selecione o periodo de dados. Use Incremental para atualizacoes com savepoint.

Desempenho por genero do Google Ads.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta.
segments_date	date	[pt] Data.
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
ad_group_criterion_gender_type	text	[pt] Genero.
metrics_impressions	float	[pt] Impressoes.
metrics_clicks	float	[pt] Cliques.
metrics_cost_micros	float	[pt] Custo em micros.
metrics_conversions	float	[pt] Conversoes.

Relatorio de Termos de Pesquisa

Tipo de replicacao: Integral

Parametros:

Data inicial de leitura (Savepoint): Data inicial para replicacao de dados.
Janela de atualizacao: Quantos meses retroagir do savepoint para atualizar dados.
Contas: Selecione as contas para buscar dados. Deixe em branco para incluir todas as contas.
Periodo: Selecione o periodo de dados. Use Incremental para atualizacoes com savepoint.

Relatorio de termos de pesquisa do Google Ads.

Campo	Tipo
_kdd_account_id	text	[pt] ID da conta.
segments_date	date	[pt] Data.
campaign_id	float	[pt] ID da campanha.
campaign_name	text	[pt] Nome da campanha.
ad_group_id	float	[pt] ID do grupo.
ad_group_name	text	[pt] Nome do grupo.
search_term_view_search_term	text	[pt] Termo pesquisado.
metrics_impressions	float	[pt] Impressoes.
metrics_clicks	float	[pt] Cliques.
metrics_cost_micros	float	[pt] Custo em micros.
metrics_conversions	float	[pt] Conversoes.

Notas

Algumas métricas e dimensões não podem ser combinadas, por isso, durante o processo de criação da integração, a lista de métricas e dimensões possíveis será constantemente recarregada por alguns segundos
Todas as dimensões selecionadas serão chaves de replicação, juntamente com __kdd_account_id
A integração poderá ser integral ou incremental, dependendo das dimensões selecionadas. As dimensões que farão com que a integração seja incremental são: Date, Week, Month, Quarter e Year. Caso a integração seja integral, o savepoint não será atualizado após cada rodada
As integrações incluirão "zero impressions"
Pode haver uma variação de resultados conforme o tipo de atribuição do relatório
Em alguns casos, certas dimensões podem filtrar os resultados. Por exemplo, utilizar uma dimensão do tipo keyword, irá fazer com que anúncios de vídeo não sejam retornados
Campanhas do tipo "Performance Max (Pmax)" não possuem grupo de anúncio. Dessa forma, elas podem não ser retornadas em integrações que utilizem dimensões de grupos de anúncio, sendo necessário uma integração separada para buscar dados de Pmax
Apenas são buscados dados de contas Ativas

Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas