Solução de problemas

O gerenciamento de conversões exige uma integração complexa, que geralmente envolve várias ferramentas e processos interdependentes. Este guia oferece etapas detalhadas para resolver problemas, seja para entender erros da API ou para esclarecer dúvidas sobre as métricas ou os diagnósticos que aparecem na interface.

Como ler métricas na interface do Google Ads

A interface do Google Ads não organiza as métricas de conversão por data de importação. Portanto, usar relatórios de campanha na interface para verificar os resultados da importação pode ser enganoso. Para verificar a integridade da importação no nível da solicitação de API, comece com o diagnóstico de dados off-line. O diagnóstico de dados off-line não avalia a correspondência de tags assíncronas nem a qualidade do identificador de usuário para conversões otimizadas. Para verificar a integridade da correspondência, consulte os relatórios de diagnóstico da interface do Google Ads para conversões otimizadas para leads e conversões otimizadas para a Web. Para ver as etapas de solução de problemas, consulte Alertas de diagnóstico da interface após um upload de API concluído.

Problemas com as conversões otimizadas para leads

Esta seção aborda problemas comuns encontrados ao importar conversões otimizadas para leads.

Erros comuns

As orientações a seguir ajudam a diagnosticar e corrigir erros comuns com as conversões otimizadas para leads.

Erro
NO_CONVERSION_ACTION_FOUND	A ação de conversão especificada não está ativada ou não pode ser acessada pela conta no campo customer_id da solicitação. Confirme se a ação de conversão no seu upload está ativada e se o proprietário dela é o cliente de conversão do Google Ads do clique ou uma conta na hierarquia de acompanhamento de conversões da conta de upload. Esse erro também pode ocorrer se o GCLID na solicitação pertencer a uma conta de cliente que não tem acesso à ação de conversão especificada na solicitação. Para verificar se um GCLID pertence a uma conta de cliente, use o recurso click_view e envie uma consulta que filtre por click_view.gclid e segments.date, em que a data é o dia em que o clique ocorreu.
INVALID_CONVERSION_ACTION_TYPE	A ação de conversão especificada tem um tipo que não é válido para conversões otimizadas para leads. Verifique se o ConversionAction especificado na solicitação de upload tem o tipo UPLOAD_CLICKS.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	Verifique se você ativou as conversões otimizadas para leads nas configurações de conversão. Encontre instruções para isso no guia de pré-requisitos.
DUPLICATE_ORDER_ID	Os eventos importados incluem várias conversões com o mesmo código de pedido e não foram processados. Verifique se os códigos dos pedidos são únicos e tente de novo.
CLICK_NOT_FOUND	Nenhum clique foi encontrado que correspondesse aos identificadores de usuário fornecidos. Se uma conversão encontrar esse aviso, a API Google Ads vai incluí-lo no successful_event_count do seu diagnóstico de dados off-line. A API Google Ads inclui uma entrada para CLICK_NOT_FOUND na coleção alerts para que você possa monitorar a frequência desse aviso. Esse erro é esperado se o clique não for de uma campanha do Google Ads. Por exemplo, ela pode vir do SA360 ou do DV360. Outras possíveis causas são: O cliente que faz o upload é diferente do cliente de conversão do Google Ads. A adição de tags não está configurada corretamente para seu formulário de lead. Os dados enviados não foram normalizados e criptografados com hash corretamente. Em casos raros em que o cliente que faz o upload é diferente do cliente de conversão do Google Ads, esse erro pode significar que o cliente que faz o upload aceitou os termos de dados do cliente, mas o cliente de veiculação não. Para determinar se uma conta aceitou os termos de dados do cliente, consulte o recurso customer e verifique o campo customer.conversion_tracking_setting.accepted_customer_data_terms.

Discrepâncias nas métricas

Lembre-se dos seguintes problemas comuns:

• As conversões podem ser descartadas pelo nosso pipeline de processamento por vários motivos, e essas conversões são irrecuperáveis. Consulte Discrepâncias de dados após um upload para mais informações.

• Verifique se a tag do Google está configurada corretamente na sua página da Web e se é disparada em envios de formulários de lead. Se a tag não for disparada em envios de formulários ou se estiver enviando dados incorretos, é provável que você veja uma atribuição baixa ou nenhuma atribuição nas conversões enviadas. Leia os artigos da Central de Ajuda sobre como configurar a tag do Google e configurar o Gerenciador de Tags do Google para conversões otimizadas para leads.

• Se você estiver usando conversões otimizadas para leads sem a tag do Google na sua página da Web, precisa incluir o GCLID nas importações de conversão definindo o campo ClickConversion.gclid em cada conversão.

• Verifique se você está especificando corretamente o consentimento nos seus uploads. Para fazer isso, defina as configurações de consentimento padrão da sua conta (na interface do Google Ads, clique em Ferramentas > Central de dados > Configurações de consentimento) ou defina o campo ClickConversion.consent em cada conversão enviada.

Problemas com a performance da campanha

Se você não tiver problemas técnicos para fazer o upload das conversões e estiver confortável com as métricas apresentadas, mas não notar as melhorias esperadas na performance da campanha ou o "lift" após implementar as conversões otimizadas para leads, entre em contato com o suporte ao produto do Google Ads para receber ajuda.

Problemas com as conversões otimizadas para a Web

Esta seção aborda problemas comuns encontrados ao importar conversões otimizadas para a Web.

Erros comuns

As orientações a seguir ajudam a diagnosticar e corrigir erros comuns com as conversões otimizadas para a Web.

Erro
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	Os Termos e Condições de dados do cliente não foram aceitos para o customer_id da solicitação. Encontre instruções para isso no guia de pré-requisitos.
CONVERSION_ALREADY_ENHANCED	Esta conversão já recebeu um ajuste de ENHANCEMENT com os campos order_id e conversion_action fornecidos. Forneça um valor de order_id exclusivo para cada conversão.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	O conversion_action fornecido não está qualificado para conversões otimizadas para a Web. Na interface do Google Ads, marque a caixa Ativar as conversões otimizadas na ação de conversão mencionada na sua solicitação. Encontre instruções para isso na Central de Ajuda.
INVALID_USER_IDENTIFIER	Um campo de identificador de usuário com hash (hashed_email, hashed_phone_number, hashed_first_name, hashed_last_name ou hashed_street_address) não é um resumo SHA-256 hexadecimal válido de 64 caracteres. Normalizar e gerar hash dos dados fornecidos pelo usuário antes de importá-los. Para instruções, consulte Normalizar e gerar hash de dados fornecidos pelo usuário.
CONVERSION_NOT_FOUND	O Google Ads não encontrou uma conversão correspondente ao campo conversion_action e ao identificador de conversão (order_id ou gclid_date_time_pair) fornecidos. Esse erro se aplica apenas aos ajustes RESTATEMENT e RETRACTION. Para mais detalhes, consulte Requisitos em "Importar ajustes de conversão". Para ajustes de ENHANCEMENT, a API aceita a solicitação sem retornar um erro CONVERSION_NOT_FOUND e avalia a correspondência de order_id da tag com a API de forma assíncrona. Altas taxas de valores de order_id não correspondentes acionam um alerta de incompatibilidade de código do pedido no relatório de diagnóstico de conversões otimizadas na interface do Google Ads. Para ver as etapas de solução de problemas, consulte Alertas de diagnóstico da interface após um upload de API.

Alertas de diagnóstico da interface após um upload de API bem-sucedido

Quando você faz upload de ajustes de ENHANCEMENT usando o serviço ConversionAdjustmentUploadService, a API valida a formatação da solicitação no momento da ingestão e faz a correspondência das melhorias com os eventos de tag do site de forma assíncrona. Como resultado, as solicitações de API podem ser bem-sucedidas sem erros no campo partial_failure_error e mostrar um status EXCELLENT em diagnóstico de dados off-line. Ao mesmo tempo, o relatório de diagnóstico de conversões otimizadas na interface do Google Ads ainda pode mostrar alertas.

Verifique as seguintes causas quando os alertas de diagnóstico da interface aparecerem após uploads de API bem-sucedidos:

• Campos de endereço obrigatórios ausentes: um objeto OfflineUserAddressInfo no campo address_info requer quatro campos na mesma entrada: hashed_first_name, hashed_last_name, country_code e postal_code. Os campos hashed_street_address, city e state são opcionais. Se você preencher o campo hashed_street_address, ele ainda precisará ser um resumo hexadecimal SHA-256 válido de 64 caracteres. A API aceita objetos address_info parciais não vazios (como apenas nome e sobrenome) sem retornar um erro no campo partial_failure_error. No entanto, a correspondência downstream descarta endereços incompletos e aciona um alerta para campos de endereço ausentes. Se algum dos quatro campos obrigatórios não estiver disponível, omita o objeto UserIdentifier do campo address_info.

• IDs de transação ausentes em eventos de tag do site: omitir o campo order_id de um ajuste de ENHANCEMENT na API retorna um erro síncrono FieldError.REQUIRED. Quando as solicitações de API incluem o campo order_id, um alerta da interface sobre um ID de transação ausente do evento de conversão se refere à tag do site. Esse alerta aparece quando menos de 90% dos eventos da tag de conversão no site incluem um ID de transação válido (ou quando a tag envia strings de marcador de posição, como "undefined" ou "null"). Configure sua tag de conversão no site para enviar um ID de transação exclusivo para cada evento de conversão.

• Incompatibilidade de código do pedido de tag e API ou uploads atrasados: para ajustes de ENHANCEMENT, a API não retorna um erro CONVERSION_NOT_FOUND ou CONVERSION_EXPIRED no momento do upload. Em vez disso, valores de order_id não correspondentes acionam um alerta de incompatibilidade de código do pedido na interface, e as melhorias enviadas mais de 24 horas após a conversão acionam um alerta de upload atrasado. Faça a correspondência do campo order_id da API com a string exata do ID da transação enviada pela tag de conversão no site e faça o upload da otimização em até 24 horas após o evento de conversão.

• Dados do usuário não normalizados com hash antes do upload: gerar hash de valores não normalizados, como letras maiúsculas, espaços em branco no início ou no final ou números de telefone fora do formato E.164, ainda produz um resumo hexadecimal SHA-256 válido de 64 caracteres. A API aceita o upload sem retornar um erro INVALID_USER_IDENTIFIER, enquanto a correspondência downstream falha e informa alertas de formatação ou de baixa taxa de correspondência. Siga as regras de normalização em Normalizar e criptografar com hash os dados fornecidos pelo usuário.

• Baixo volume de melhorias da API em relação ao volume de tags do site: os diagnósticos da interface comparam as melhorias da API sem duplicação que contêm identificadores de usuário com os eventos de tag do site sem duplicação e com consentimento:

  • Configuração do modo de consentimento: quando o modo de consentimento na tag do Google sinaliza a configuração ad_storage='denied', os diagnósticos da interface excluem os eventos de tag do site sem consentimento da comparação. Assim, omitir esses eventos dos uploads da API não aciona um alerta de baixo volume. No entanto, o tratamento de consentimento incompatível entre a tag do site e os acionadores de back-end gera alertas:

    • A tag não tem ad_storage='denied', o back-end ignora o upload: os diagnósticos da interface contam os eventos da tag como consentidos e informam um alerta de baixa cobertura.
    • Indicadores de tag ad_storage='denied', melhoria de uploads de back-end: as melhorias enviadas não têm um evento de tag consentido correspondente e contribuem para alertas de incompatibilidade de código do pedido.

    Aplique o mesmo estado de consentimento à tag do site e aos uploads de melhoria da API.

  • Eventos anônimos no site: não ative as conversões otimizadas em ações de conversão do funil superior (como visualizações de página ou de item) em que a tag do site é disparada para visitantes anônimos. Se o servidor enviar melhorias de API apenas para usuários conectados com detalhes de contato conhecidos, os eventos de tag anônimos sem correspondência vão acionar um alerta de baixa cobertura. Ative as conversões otimizadas apenas em ações de conversão em que os dados fornecidos pelo usuário estejam sempre disponíveis.

Problemas gerais de gerenciamento de conversões

Lembre-se dos seguintes problemas comuns:

• A tentativa de definir qualquer campo de tipo enumerado como UNKNOWN resultará em um erro RequestError.INVALID_ENUM_VALUE. Esse é um problema comum ao especificar consent quando o anunciante não sabe se o consentimento foi dado. Se o status de consent for desconhecido, ele precisará ser definido como DENIED.

• Ao criar uma ação de conversão para conversões de app ou análises de apps de terceiros e do Firebase, só é possível alterar o campo app_id na criação. Depois que a ação de conversão é criada, esse campo não pode ser alterado.

• Ao criar uma ação de conversão, só é possível definir o campo ConversionAction.attribution_model_settings.attribution_model como GOOGLE_ADS_LAST_CLICK ou GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. Qualquer outra opção resultará em um erro CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Nossa postagem do blog que anuncia a descontinuação de outros modelos de atribuição tem mais detalhes.

• O intervalo permitido para o campo click_through_lookback_window_days é de 1 a 60 dias para ações de conversão com o tipo AD_CALL e WEBSITE_CALL. Para a maioria das outras ações de conversão, o intervalo permitido é de 1 a 90 dias.

• O intervalo permitido para o campo view_through_lookback_window_days é de 1 a 30 dias para a maioria das ações de conversão. Este campo precisa ser desmarcado para ações de conversão do tipo AD_CALL e WEBSITE_CALL.

• Definir ou atualizar o campo include_in_conversions_metric em uma ação de conversão vai resultar em um erro FieldError.IMMUTABLE_FIELD. Em vez disso, defina o campo primary_for_goal, conforme descrito no guia de metas de conversão.

• Ao criar uma ação de conversão do tipo WEBSITE_CALL ou AD_CALL, o value_settings.always_use_default_value precisa ser definido como true. Especificar um valor de false vai resultar em um erro INVALID_VALUE.

Erros comuns

As orientações a seguir ajudam a diagnosticar e corrigir erros comuns com importações de conversões off-line, incluindo erros de acesso ao acompanhamento de conversões de várias contas.

Erro
INVALID_CONVERSION_ACTION_TYPE	A ação de conversão especificada tem um tipo que não é válido para o upload de conversões de clique. Verifique se o ConversionAction especificado na solicitação de upload tem o tipo UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND	A ação de conversão especificada não está ativada ou não pode ser acessada pela conta no campo customer_id da solicitação. Recupere informações sobre a configuração do rastreamento de conversões para confirmar que a ação de conversão está ativada. O proprietário da ação de conversão precisa ser o cliente de conversão do Google Ads do clique ou uma conta na hierarquia de acompanhamento de conversões da conta de upload. Por exemplo, esse erro ocorre se a ação de conversão pertence a uma conta de administrador anterior que foi desvinculada após o clique.
TOO_RECENT_CONVERSION_ACTION	A ação de conversão foi criada recentemente. Aguarde pelo menos 6 horas após a criação da ação antes de tentar novamente as conversões com falha.
INVALID_CUSTOMER_FOR_CLICK	O campo customer_id na solicitação não corresponde ao cliente de conversão do Google Ads no momento do clique. Esse erro ocorre quando a conta de upload também não tem acesso entre contas à ação de conversão. Atualize o campo customer_id da solicitação para uma conta na hierarquia do proprietário da ação de conversão.
EVENT_NOT_FOUND	O Google Ads não consegue encontrar a combinação de ID de clique e customer_id. Revise os requisitos para customer_id e confirme se você está fazendo o upload usando a conta certa do Google Ads.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST	Várias conversões na solicitação têm a mesma combinação de ID de clique, conversion_date_time e conversion_action. Remova as conversões duplicadas da solicitação.
CLICK_CONVERSION_ALREADY_EXISTS	Uma conversão com a mesma combinação de ID de clique, conversion_date_time e conversion_action foi enviada anteriormente. Ignore esse erro se você estava tentando fazer o upload novamente e essa conversão foi bem-sucedida. Se você quiser adicionar outra conversão além da que foi enviada anteriormente, ajuste o conversion_date_time do ClickConversion para evitar a duplicação da conversão enviada anteriormente.
EXPIRED_EVENT	O clique importado ocorreu antes do período especificado no campo click_through_lookback_window_days. Uma mudança no click_through_lookback_window_days afeta apenas os cliques registrados após a mudança. Portanto, mudar a janela de lookback não resolveria esse erro para o clique em questão. Se for o caso, mude a conversion_action para outra ação com uma janela de lookback mais longa.
CONVERSION_PRECEDES_EVENT	O conversion_date_time é anterior à data e hora do clique. Atualize o conversion_date_time para um valor posterior.
VALUE_MUST_BE_UNSET	O ClickConversion tem um valor definido para gbraid ou wbraid (sem um gclid) e tem um valor para custom_variables ou cart_data, que não é aceito pelo Google Ads com gbraid ou wbraid. Remova a definição do campo conflitante.