Solucionar problemas do conector do Google Ads
Beta
Este recurso está em Beta.
Aprenda a solucionar problemas comuns com o conector do Google Ads no LakeFlow Connect.
Eu me autentiquei, mas não consigo ver meus dados do Google Ads
Causa: Você pode estar se autenticando na account do Google errada. Alternativamente, a account pode não ter acesso ao Google Ads.
par:
- Confirme se você está se autenticando na account do Google correta. Você pode editar a conexão e autenticar-se novamente com a account correta ou recriar a conexão para reavaliar o fluxo OAuth .
- Confirme se a account tem acesso ao Google Ads. Faça login na sua account do Google e verifique se ela tem permissão para acessar seus dados do Google Ads.
Erro: GOOGLE_ADS_ACTION_NOT_PERMITTED
Mensagem de erro:
The authenticated Google Ads user or the Google Cloud project that owns the OAuth client is not permitted to perform this action on the requested resource or to call this method (authorization_error: ACTION_NOT_PERMITTED or CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION).
Causa: Ou o usuário autenticado não tem acesso ao account, ou o projeto Google Cloud proprietário do seu cliente OAuth tem apenas acesso de teste à API do Google Ads. Um projeto com acesso de teste não pode ler account de produção do Google Ads.
par:
- Confirme que o usuário autenticado tem acesso à account do Google Ads.
- Verifique o nível de acesso do projeto do Google Cloud que possui seu cliente OAuth. Consulte Confirmar o nível de acesso à API do Google Ads. Se mostrar Teste , solicite acesso Básico ou Padrão .
Erro de URI de redirecionamento durante a configuração do OAuth
Mensagem de erro:
Error: redirect_uri_mismatch
Causa: O URI de redirecionamento configurado no seu cliente OAuth do Google Cloud Console não corresponde ao URL workspace Databricks .
par:
- Acesse o Console do Google Cloud em https://console.cloud.google.com.
- Navegue até APIs & serviço /> Credenciais .
- Clique nas suas credenciais de cliente OAuth.
- Em URIs de redirecionamento autorizados , confirme se contém o seguinte padrão:
https://<workspace-url>/login/oauth/google.html. Substitua<workspace-url>pelo URL do seu workspace Databricks (por exemplo,https://dbc-a1b2c3d4-e5f6.cloud.databricks.com). - Salve as alterações e tente autenticar novamente.
Erro: SAAS_CONNECTION_ERROR.INVALID_CREDENTIALS
Mensagem de erro:
Failed to make a connection to the Google Ads source. Error code: INVALID_OAUTH_CREDENTIALS. Invalid credentials. Ensure the source connection credentials are provided correctly.
Causa: O Google Ads rejeitou as credenciais OAuth da conexão. Por exemplo, o usuário revogou o acesso ao aplicativo, a senha do usuário foi alterada ou o cliente OAuth foi excluído.
Solução: Edite a conexão e reautentique. Se você usar seu próprio cliente OAuth, confirme que ele ainda existe no console do Google Cloud.
Erro: GOOGLE_ADS_USER_PERMISSION_DENIED
Mensagem de erro:
The authenticated Google Ads user does not have permission to access the requested customer account (authorization_error: USER_PERMISSION_DENIED). Verify the authenticated user is linked to the account with at least read access.
Causa: O usuário autenticado não pode acessar a account do cliente que o pipeline lê. Uma causa comum é que manager_account_id não está definido, ou não é a account de gerenciador à qual a account de cliente está vinculada. Isso também acontece quando a account foi desvinculada da account de gerenciador que o pipeline usa, foi cancelada ou foi movida para outra account de gerenciador, ou quando o acesso do usuário foi removido.
par:
- No Google Ads, confirme se a account do cliente está vinculada à account de administrador que o pipeline usa e se o usuário autenticado tem pelo menos acesso de leitura a ela.
- Se a account não estiver mais disponível, remova suas tabelas do pipeline. Caso contrário, reautentique a conexão com um usuário que tenha acesso.
Erro: GOOGLE_ADS_QUOTA_EXCEEDED
Mensagem de erro:
The Google Ads API quota has been exhausted (rate name: <rateName>, scope: <rateScope>). ...
Causa: o pipeline fez mais solicitações da API do Google Ads do que o permitido pela cota. O Google Ads geralmente solicita que o cliente aguarde mais tempo do que a janela de repetição do pipeline, portanto, a atualização falha em vez de repetir.
par:
- Reduza o número de tabelas que o pipeline ingere ou programe o pipeline com menos frequência.
- Aguarde antes de executar o pipeline novamente. Se a mensagem de erro relatar um atraso de repetição, aguarde pelo menos esse tempo. Um atraso de
0significa que o Google Ads não informou um. - Se você usar seu próprio token de desenvolvedor e atingir a cota com frequência, solicite um nível de acesso mais alto para o token. Consulte Limites e cotas de API na documentação da API do Google Ads.
Erro: GOOGLE_ADS_INVALID_CUSTOM_REPORT_CONFIGURATION
Mensagem de erro:
Invalid custom_report configuration. <reason> ...
Causa: O custom_report_options de uma tabela de relatório personalizada não pode ser feita query. O motivo nomeia o problema. Os motivos comuns são:
- Um nome de campo é inválido ou o campo não pode ser selecionado no
resourceescolhido. - Nenhum segmento de timeline está selecionado. Cada relatório personalizado precisa de
segments.date,segments.weekousegments.month. - Um campo é selecionado a partir de um recurso atribuído sem o
resource_namedesse recurso. - O
sync_start_datetem mais de 37 meses para um relatório segmentado porsegments.dateousegments.week.
Solução: Corrija a opção que o motivo nomeia. Para testar a configuração sem mover dados, realize a execução de databricks pipelines start-update <pipeline-id> --validate-only. Consulte databricks pipelines começar-update. Para as regras de opção, consulte Opções de configuração de relatório personalizadas. Para relatar dados anteriores a 37 meses, use segments.month.
Erro: GOOGLE_ADS_API_ERROR
Mensagem de erro:
The Google Ads API returned an error (<googleAdsErrorCode>): <googleAdsErrorMessage> ...
Causa: O Google Ads rejeitou uma solicitação com um erro que o conector não classifica mais. O código de erro e a mensagem geralmente vêm do Google Ads. Um código vem do conector: UNRECOGNIZED_ACCOUNT_TIME_ZONE significa que o Google Ads não retornou fuso horário para a account, ou um que o conector não reconhece, por isso o conector não consegue compute datas de relatório no fuso horário da account.
Solução: Procure o código de erro na página Erros comuns da documentação da API do Google Ads e ajuste a conexão ou a tabela afetada. Para UNRECOGNIZED_ACCOUNT_TIME_ZONE, que não está listado lá, ou se o erro persistir, entre em contato com o suporte Databricks.
Erro: MANAGED_INGESTION_PIPELINE_SPEC_VALIDATION_ERROR.OBJECT_SETTING_NOT_SUPPORTED
Mensagem de erro:
These settings are not supported on these <sourceType> objects: <violations>. Remove them from these objects. A table_configuration setting on a table can also come from the pipeline's table_configuration.
Causa: O pipeline define uma opção em uma tabela, schema ou catalog que não a suporta. Por exemplo, um row_filter, primary_keys ou sequence_by em uma tabela de relatório, custom_report_options em uma tabela que não é um relatório personalizado ou sync_start_date ou lookback_window_days em uma tabela de recursos ou eventos. O erro lista cada objeto com as configurações a serem removidas, por exemplo ad: lookback_window_days, sync_start_date; campaign_report: row_filter.
Solução: Remova as configurações listadas desses objetos. Se uma tabela não definir row_filter, primary_keys ou sequence_by em si mesma, verifique o table_configuration do pipeline, que a tabela herda quando não tem nenhum próprio. lookback_window_days e sync_start_date vêm da tabela, do seu esquema ou, de outra forma, da primeira tabela ou esquema na especificação do pipeline que define as opções do conector do Google Ads. Para as regras, consulte Limitações de configuração da tabela.
Erro: MANAGED_INGESTION_CONNECTOR_OPTIONS_CHANGED_REQUIRE_FULL_REFRESH
Mensagem de erro:
The <options> connector option(s) of the <sourceType> destination table `<tableName>` cannot be changed during an incremental update. Perform a full refresh of the table, restore the original options, or create a new destination table.
Causa: Você alterou resource, resource_fields, segments ou metrics de um relatório personalizado ou sync_start_date de uma tabela de relatório. Essas opções definem as linhas que a tabela contém, por isso uma atualização incremental não pode aplicar a alteração. O erro nomeia as opções alteradas. 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, também conta. Alterar esse valor pode falhar todas as tabelas de relatório que o herdam.
Algumas alterações de relatório personalizadas falham anteriormente com SAAS_INCOMPATIBLE_SCHEMA_CHANGES_DURING_INIT, por exemplo, remover uma métrica ou adicionar um segmento. Eles também precisam de um refresh completo.
Solução : execute uma das seguintes ações:
- Realize a execução de um refresh completo somente desta tabela para ingeri-la novamente com as novas opções. Para fazer refresh das tabelas selecionadas, consulte refresh totalmente as tabelas de destino. Um refresh completo remove a história que o Google Ads não fornece mais, portanto, copie essa história para outra tabela primeiro. Veja A história mais antiga está faltando após um refresh completo.
- Restaure as opções originais.
- Ingira a nova configuração em uma nova tabela de destino.
Erro: CANNOT_FILTER_OUT_REQUIRED_COLUMN ou CANNOT_ADD_COLUMN_TO_INCLUDE_COLUMNS
Mensagem de erro:
Pipeline definition does not include required columns (<columnNames>) in the table <qualifiedTableName> of source <sourceType> for ingestion. Please add them to include_columns or remove them from exclude_columns.
New columns (<columnNames>) are added to include_columns field in pipeline definition for the table <qualifiedTableName>. Please full refresh the table to avoid potential data loss or remove these columns from include_columns.
Causa: A seleção de colunas remove uma key primária ou coluna de cursor de que a tabela precisa, ou adiciona colunas a include_columns em uma tabela que já existe. As linhas anteriores não têm valores para colunas adicionadas.
Solução: Mantenha as colunas da key primária e do cursor na seleção. Para adicionar colunas a uma tabela existente, faça a execução de um refresh completo apenas dessa tabela ou remova as novas colunas de include_columns. Para refresh tabelas selecionadas, consulte Refresh totalmente as tabelas de destino. Um refresh completo remove a história que o Google Ads não serve mais, portanto, copie essa história para outra tabela primeiro. Consulte A história mais antiga não aparece após um refresh completo.
Uma tabela de relatório tem valores que não correspondem mais ao Google Ads
Causa: O Google Ads alterou dados mais antigos do que a janela de retrospectiva ou redefiniu uma linha para métricas totalmente zero. O conector lê novamente apenas a janela de retrospectiva e não exclui as linhas do relatório, portanto, a tabela mantém os valores anteriores. Veja Limitações de alterações de dados atrasados e linhas excluídas.
par:
- Para refresh as linhas afetadas uma vez, faça uma execução de um refresh completo apenas dessa tabela. Para refresh as tabelas selecionadas, consulte Refresh completo das tabelas de destino. Um refresh completo remove a história que o Google Ads não serve mais, portanto, copie essa história para outra tabela primeiro. Consulte A história mais antiga está faltando após um refresh completo.
- Se as alterações chegarem com frequência após a janela de retrospectiva, aumente
lookback_window_dayspara corresponder à sua janela de conversão.
A história mais antiga está faltando após um refresh completo
Causa: um refresh completo ingere apenas o que o Google Ads ainda veicula. O Google Ads mantém dados de relatórios por hora, diários e semanais por 37 meses, dados de cliques por 90 dias e envios de formulários de leads por 60 dias. A história anterior a isso é removida da tabela. Consulte Limitações de retenção de dados.
par:
- Se você manteve uma cópia da tabela de antes do refresh total, restaure a história mais antiga dessa cópia.
- Se você não tiver uma cópia, entre em contato com o suporte da Databricks para avaliar as opções de recuperação.
- Antes de futuros refreshes completos, copie a história que o Google Ads não serve mais para outra tabela.
- Para um relatório personalizado que precise de dados com mais de 37 meses, use
segments.month. Isso retorna totais mensais para esses períodos. Não restaura as linhas originais de hora em hora, diariamente ou semanalmente.
click_report está faltando cliques depois que o pipeline foi colocado em pausa
Causa: O Google Ads fornece dados de cliques apenas para os últimos 90 dias, e o conector lê no máximo os últimos 88 dias. Se o pipeline não tiver execução com êxito por mais de 88 dias, os cliques entre a última atualização bem-sucedida e 88 dias atrás não poderão ser ingeridos.
Solução: As datas perdidas não podem ser recuperadas. Faça a execução do pipeline de forma programada, e corrija uma atualização com falha antes que 88 dias se passem após a última atualização bem-sucedida.