Conceitos de conexão do Google Ads
Beta
This recurso is in Beta.
Aprenda como funciona o conector de gerenciamento do Google Ads no LakeFlow Connect .
Como funciona o conector
O conector do Google Ads importa dados da conta do Google Ads para o Databricks usando a API do Google Ads. O conector suporta dois tipos de tabelas:
- Tabelas de recursos: Essas tabelas contêm dados de configuração sobre sua account do Google Ads, como campanhas, grupos de anúncios e anúncios. As tabelas de recursos não suportam ingestão incremental; elas são totalmente atualizadas a cada execução pipeline . Também não suportam história acompanhamento (SCD tipo 2).
- Tabelas de relatório: Essas tabelas contêm métricas de desempenho, como impressões, cliques e conversões. As tabelas de relatório suportam a ingestão incremental com uma janela de retrospectiva configurável para capturar eventos tardios e atualizações de atribuição.
Para obter uma lista das tabelas compatíveis, consulte a referência do conector do Google Ads.
hierarquia de contas
O conector do Google Ads funciona com a seguinte estrutura account :
- ID da conta do administrador (MCC): um identificador de 10 dígitos para uma account do Google Ads Manager que gerencia uma ou mais contas do Google Ads. Um pipeline corresponde a, no máximo, um ID de conta de Gerente.
- ID da conta do cliente: um identificador de 10 dígitos para uma account específica do Google Ads. Se o seu ID de conta de Gerente estiver mapeado para vários IDs de conta de Cliente, você poderá ingerir dados desses diferentes IDs de conta de Cliente no mesmo pipeline.
O Google Ads organiza os dados de publicidade na seguinte hierarquia:
- accountde administrador : account principal para gerenciar várias contas de anúncios, usuários e faturamento de clientes.
- accountde anúncios : account de publicidade individual.
- Campanha : Unidade organizacional de nível superior para anúncios.
- Grupo de anúncios : Conjunto de anúncios que compartilham configurações de segmentação.
- Anúncio : Anúncio individual.
- Ativo : Componentes criativos reutilizáveis (títulos, imagens, logotipos, sitelinks) que podem ser anexados a anúncios ou campanhas.
- Anúncio : Anúncio individual.
- Grupo de anúncios : Conjunto de anúncios que compartilham configurações de segmentação.
- Campanha : Unidade organizacional de nível superior para anúncios.
- accountde anúncios : account de publicidade individual.
padrões de ingestão de dados
sincronização de dados históricos
Por default, o conector ingere dois anos de data histórica para tabelas de relatório. Você pode configurar isso utilizando o parâmetro sync_start_date. O Google Ads retém dados de desempenho de hora em hora, diariamente e semanalmente por apenas 37 meses, e a tabela click_report ingere apenas os últimos 88 dias de cliques. Para mais detalhes, consulte Limitações de retenção de dados.
Atualizações incrementais e janelas de retrospectiva
Os dados de conversão do Google Ads podem mudar por até 90 dias após a conversão. Por exemplo, um usuário pode realizar uma conversão dias depois de clicar em um anúncio, ou o Google Ads pode recalcular a atribuição. Para capturar essas alterações, o conector verifica novamente os dados dos últimos 30 dias por default durante cada atualização pipeline .
Você pode personalizar esta janela de retrospectiva usando o parâmetro lookback_window_days . Ao definir esse valor, leve em consideração o período de atribuição de conversão da sua organização. Por exemplo, se a sua organização usa uma janela de conversão de 60 dias, defina lookback_window_days=60 para garantir que as conversões tardias e as atualizações de atribuição sejam refletidas nos seus dados.
Alterações nos dados mais antigos que a janela de retrocesso não são capturadas, e as linhas que o Google Ads redefine para métricas todas iguais a zero não são excluídas. Para detectar essas alterações, faça uma execução do refresh completo da tabela. Um refresh completo reingere apenas os dados que o Google Ads ainda retém, portanto, ele remove qualquer história mais antiga que a tabela possua. Para manter essa história, copie-o para outra tabela antes do refresh completo. Consulte Limitações de alterações de dados atrasadas e linhas excluídas e Limitações de retenção de dados.
Armazenamento de dinheiro no Google Ads
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. Por exemplo:
1,000,000 micros = $1.00 USD5,500,000 micros = $5.50 USD
Ao trabalhar com campos de custo e orçamento em suas tabelas de destino, divida por 1.000.000 para converter de micros para sua moeda.