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_groupead) 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_dateelookback_window_daysse 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.weekousegments.month, osync_start_datee 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_leadelocal_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.dateousegments.weeké rejeitado se seusync_start_datefor 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, usesegments.month. - A tabela
click_reportpode 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 quesync_start_dateseja 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,segmentsemetricsde um relatório personalizado esync_start_datede 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 umsync_start_dateque 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_bynão é suportada em nenhuma tabela, e a substituição deprimary_keysnã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_optionsse aplica apenas à tabelacustom_report.- Um esquema ou catálogo na especificação do pipeline não pode definir
row_filter,primary_keys,sequence_byoucustom_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 definirlookback_window_daysousync_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_configurationherda otable_configurationdo nível do pipeline, portantorow_filter,primary_keysesequence_bytambé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 definelookback_window_daysousync_start_datepor 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_optionssempre 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_columnsem uma tabela existente requer um refresh completo da tabela.