Pular para o conteúdo principal

Limitações do conector do Google Ads

info

Beta

This recurso is in Beta.

Saiba mais sobre as limitações conhecidas ao usar o conector de gerenciamento do Google Ads no LakeFlow Connect.

Limitações gerais​

  • Ao executar um pipeline agendado, os alertas não são acionados imediatamente. Em vez disso, elas são acionadas na próxima execução da atualização.
  • Quando uma tabela de origem é excluída, a tabela de destino não é excluída automaticamente. Você deve excluir a tabela de destino manualmente. Este comportamento não é consistente com o comportamento de Spark Declarative Pipelines em Lakeflow.
  • Durante períodos de manutenção da fonte de dados, o Databricks poderá não conseguir acessar seus dados.
  • Se o nome de uma tabela de origem entrar em conflito com o nome de uma tabela de destino existente, a atualização do pipeline falhará.
  • O suporte pipeline com múltiplos destinos é feito exclusivamente via API.
  • Opcionalmente, você pode renomear uma tabela que você importa. Se você renomear uma tabela em seu pipeline, ele se tornará um pipeline somente para API e você não poderá mais editá- pipeline na interface do usuário.
  • Se você selecionar uma coluna depois que um pipeline já tiver sido iniciado, o conector não preencherá automaticamente os dados da nova coluna. Para ingerir dados históricos, execute manualmente uma refresh completa na tabela.
  • O Databricks não consegue ingerir duas ou mais tabelas com o mesmo nome no mesmo pipeline, mesmo que elas provenham de esquemas de origem diferentes.
  • O sistema de origem pressupõe que as colunas do cursor estejam em ordem crescente monotônica.
  • O conector ingere dados brutos sem transformações. Use os Spark Declarative Pipelines downstream nos Lakeflow pipelines para transformações.

Tabelas suportadas​

O conector oferece suporte às tabelas predefinidas listadas em referência do conector do Google Ads, bem como tabelas de relatório personalizadas que são definidas usando campos de recurso, segmentos e métricas do Google Ads.

Limitações de ingestão incremental​

  • As tabelas de recursos (como customer, campaign, ad_group e ad) são totalmente atualizadas em cada atualização pipeline . Somente as tabelas de relatório suportam ingestão incremental.
  • O acompanhamento de história (tipo SCD 2) não é compatível com nenhuma tabela. Somente o estado atual é armazenado.
  • As opções sync_start_date e lookback_window_days se aplicam apenas a tabelas de relatório. Um pipeline que os define em uma tabela de recurso ou evento é rejeitado quando você o salva.
  • As datas do relatório estão no fuso horário da account do Google Ads, e cada atualização lê as datas até a data atual nesse fuso horário.
  • Para um relatório personalizado segmentado por segments.week ou segments.month, o sync_start_date e a janela de retrospectiva são arredondados para o início da semana (segunda-feira) ou mês, para que cada atualização leia novamente períodos inteiros.
  • Se uma atualização falhar no meio de uma tabela de relatório, a próxima atualização começará a partir do último período que foi totalmente ingerido, menos a janela de retrocesso. As datas não são ignoradas.
  • As tabelas de eventos (call_view, lead_form_submission, local_services_lead e local_services_lead_conversation) são totalmente atualizadas em cada atualização de pipeline e contêm apenas as linhas retornadas pelo Google Ads. Por exemplo, a API do Google Ads retorna submissões de formulários de leads apenas nos últimos 60 dias, portanto, as submissões mais antigas são removidas da tabela de destino na próxima atualização. Para detalhes, consulte Sobre ativos de formulário de lead no centro de ajuda do Google Ads.

Limitações de alterações de dados tardias e linhas excluídas​

  • Cada atualização de pipeline lê novamente apenas a janela de lookback dos dados do relatório. As alterações que o Google Ads faz nos dados anteriores à janela de lookback não são capturadas. Para capturá-las, faça uma execução do refresh completo da tabela.
  • A API do Google Ads omite linhas de relatório cujas métricas selecionadas são todas zero. As tabelas de relatório não contêm linhas para períodos sem atividade. Para detalhes, consulte Métricas zero na documentação da API do Google Ads.
  • O connector não exclui linhas de tabelas de relatório. Se o Google Ads reajustar posteriormente uma linha ingerida para métricas de todos os zeros, a API para de retornar essa linha e a tabela de destino mantém seus valores anteriores. Para remover essas linhas, faça uma execução de um full refresh da tabela.

Limitações de retenção de dados​

  • O Google Ads retém dados de desempenho segmentados por hora, dia e semana por 37 meses. O conector não consegue ingerir dados que o Google Ads não serve mais, então um refresh completo remove qualquer história mais antiga que a tabela de destino contém. Um relatório personalizado segmentado por segments.date ou segments.week é rejeitado se seu sync_start_date for de mais de 37 meses atrás. Para detalhes, consulte o anúncio da política de retenção de dados do Google Ads. Para relatórios personalizados que precisam de uso de dados mais antigos, use segments.month.
  • A tabela click_report pode ingerir apenas os últimos 88 dias de cliques, porque o Google Ads fornece dados de cliques apenas nos últimos 90 dias. Uma sincronização inicial ou um refresh completo não começa antes de 88 dias atrás, mesmo que sync_start_date seja anterior. Se a execução do pipeline não ocorrer com êxito por mais de 88 dias, os cliques entre a última atualização bem-sucedida e 88 dias atrás não serão ingeridos, pois o Google Ads não os veicula mais.

Limitações de configuração de tabela​

  • resource, resource_fields, segments e metrics de um relatório personalizado e sync_start_date de uma tabela de relatório não podem mudar em uma tabela existente. Depois que você altera um deles, a próxima atualização da tabela falha e solicita um refresh completo, e a tabela mantém seus dados existentes até que você faça uma execução. Um refresh completo reingere a tabela com a nova configuração. Reordenar campos não é uma mudança. Remover uma opção é uma mudança, assim como uma mudança em um sync_start_date que a tabela herda de seu esquema ou da primeira tabela ou esquema na especificação do pipeline que define as opções do conector do Google Ads.
  • Filtros de linha não são suportados em tabelas de relatório. A janela de lookback relê as linhas para atualizar suas métricas, e um filtro de linha em uma coluna de métrica pode impedir que uma linha atualizada seja ingerida, o que deixa seus valores anteriores na tabela.
  • A substituição de sequence_by não é suportada em nenhuma tabela, e a substituição de primary_keys não é suportada em tabelas de relatório ou recurso. As keys e o sequenciamento default do conector permitem que as releituras de lookback atualizem as linhas existentes e mantenham cada recurso com a key em seu próprio ID.
  • custom_report_options se aplica apenas à tabela custom_report.
  • Um esquema ou catálogo na especificação do pipeline não pode definir row_filter, primary_keys, sequence_by ou custom_report_options, porque essas configurações seriam aplicadas às tabelas de relatório que ele contém. Um catálogo também não pode definir lookback_window_days ou sync_start_date. Defina-os em um esquema ou em tabelas de relatório individuais.
  • Um pipeline que define qualquer uma dessas configurações não suportadas é rejeitado quando você o cria ou edita, e o erro lista cada objeto com as configurações a serem removidas. Uma tabela, esquema ou catálogo que não define seu próprio table_configuration herda o table_configuration do nível do pipeline, portanto row_filter, primary_keys e sequence_by também podem vir de lá. As opções de conector não têm uma configuração de nível de pipeline. Uma tabela de relatório que não define lookback_window_days ou sync_start_date por si só, e cujo esquema não o define, usa o valor da primeira tabela ou esquema na especificação do pipeline que define as opções do conector do Google Ads. Para manter os valores de cada tabela previsíveis, defina-os em cada tabela de relatório ou esquema. custom_report_options sempre vem da própria tabela.
  • A seleção de colunas não pode remover a key primária ou as colunas de cursor de uma tabela. Adicionar colunas ao include_columns em uma tabela existente requer um refresh completo da tabela.