Conceitos de conexão 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.

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.

padrões de ingestão de dados

sincronização de dados históricos

Por default, o conector importa dois anos de dados históricos para as tabelas de relatório. Você pode configurar isso usando o parâmetro sync_start_date . Não há limite máximo.

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.

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 USD
• 5,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.