Solução de problemas

O gerenciamento de conversões exige uma integração complexa, geralmente envolvendo várias ferramentas e processos interdependentes. Este guia oferece etapas detalhadas para resolver problemas, seja por erros da API que você não entende ou por confusão sobre as métricas ou os diagnósticos mostrados na interface.

Importante: uma resposta de importação bem-sucedida da API não significa necessariamente que as conversões foram atribuídas. Consulte este artigo da Central de Ajuda para mais detalhes sobre discrepâncias de dados após uma importação bem-sucedida.

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 os relatórios na interface para verificar os resultados da importação pode ser enganoso. Para verificar a integridade da importação, comece com os diagnósticos off-line. Você também pode saber mais sobre os diagnósticos na interface do Google Ads para conversões otimizadas para leads e conversões otimizadas para a Web.

Problemas com as conversões otimizadas para leads

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

Erros comuns

Erro
NO_CONVERSION_ACTION_FOUND	A ação de conversão especificada não está ativada ou não pode ser acessada pela conta de cliente especificada pelo campo "client_id" na solicitação. Confira se a ação de conversão no seu upload está ativada e pertence ao cliente que enviou a solicitação 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. É possível verificar se um GCLID pertence a uma conta de cliente usando o recurso click_view. Para isso, 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	O tipo da ação de conversão especificada não é válido para conversões otimizadas para leads. Verifique se o ConversionAction especificado na solicitação de upload é do 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 corresponda aos identificadores de usuário fornecidos. A API Google Ads só retorna esse erro se debug_enabled for true no UploadClickConversionsRequest. Observação:trate esse erro como um aviso, a menos que ele ocorra com a maioria das suas conversões. Se uma conversão encontrar esse aviso, a API Google Ads a incluirá 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, pode vir do SA360 ou do DV360. Outras possíveis causas: O cliente que faz o upload é diferente do cliente de conversão do Google Ads. O uso de tags não está configurado corretamente para seu formulário de lead. Os dados enviados por upload não foram normalizados e criptografados com hash corretamente. Em casos raros, quando 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.offline_conversion_tracking_info.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 não podem ser recuperadas. Consulte o artigo Discrepâncias de dados após um upload bem-sucedido para mais informações.

• Verifique se a tag do Google está configurada corretamente na sua página da Web e se é acionada quando há envios de formulário de lead. Se a tag não for disparada no envio de formulários ou se ela estiver enviando dados incorretos, provavelmente você vai notar uma atribuição baixa ou inexistente nas conversões enviadas. Leia os artigos da Central de Ajuda sobre como configurar a tag do Google e como 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, inclua 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 ao fazer upload das conversões e se sentir à vontade com as métricas apresentadas, mas não notar as melhorias esperadas na performance da campanha ou o "aumento" 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 se concentra em resolver problemas comuns encontrados ao importar conversões otimizadas para a Web.

Erros comuns

Erro
CONVERSION_NOT_FOUND	Não foi possível encontrar uma conversão para o par de ação de conversão e identificador de conversão fornecido ou order_id. Verifique se a conversão é do Google Ads para o cliente de conversão do Google Ads especificado no customer_id da solicitação. Além disso, verifique se a conversão não foi de um clique em que gbraid ou wbraid foi preenchido em vez de gclid. O Google Ads não oferece suporte a conversões otimizadas para a Web nesses casos.
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	Essa conversão já recebeu um ajuste com o order_id e o conversion_action especificados. Forneça um 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 referenciada na sua solicitação. Confira as instruções na Central de Ajuda.

Problemas gerais de gerenciamento de conversões

Lembre-se dos seguintes problemas comuns:

• A tentativa de definir qualquer campo de enumeração 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 deverá ser definido como DENIED.

• Ao criar uma ação de conversão para Conversões de apps ou Firebase e análise de apps de terceiros, só é possível mudar 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 vai resultar em um erro de CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Confira mais detalhes na postagem do blog sobre a suspensão de uso de outros modelos de atribuição.

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

• O intervalo permitido para o campo view_through_lookback_window_days é [1, 30] na maioria das ações de conversão. Esse campo precisa ser não definido para ações de conversão do tipo AD_CALL e WEBSITE_CALL.

• Definir ou atualizar o campo include_in_conversion_metrics em uma ação de conversão 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

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 é do tipo UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND	A ação de conversão especificada não está ativada ou não foi encontrada no customer_id de upload. Recupere informações sobre sua configuração de conversão para garantir que a ação de conversão no seu upload esteja ativada e seja de propriedade do customer_id da solicitação de upload.
TOO_RECENT_CONVERSION_ACTION	A ação de conversão foi criada recentemente. Aguarde pelo menos seis horas após a criação da ação antes de tentar novamente as conversões com falha.
INVALID_CUSTOMER_FOR_CLICK	O customer_id da solicitação não é o mesmo ID de cliente que era a conta de conversão da API Google Ads no momento do clique. Atualize o customer_id da solicitação para o cliente correto.
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 correta 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 sua 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ê estiver tentando fazer o upload novamente e essa conversão já tiver sido concluída. Se quiser adicionar outra conversão além da que foi enviada anteriormente, ajuste o conversion_date_time do ClickConversion para evitar a duplicaçã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 correta do Google Ads.
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 só afeta os cliques registrados após a mudança. Portanto, alterar a janela de lookback não resolve esse erro para o clique específico. Se for o caso, mude o conversion_action para outra ação com uma janela de lookback maior.
CONVERSION_PRECEDES_EVENT	O conversion_date_time é anterior à data e hora do clique. Atualize o conversion_date_time para um valor posterior.
GBRAID_WBRAID_BOTH_SET	O ClickConversion tem um valor definido para gbraid e wbraid. Atualize a conversão para usar apenas um ID de clique e verifique se você não está combinando vários cliques na mesma conversão. Cada clique tem apenas um ID.
VALUE_MUST_BE_UNSET	Verifique o location do GoogleAdsError para determinar qual dos seguintes problemas causou o erro. O ClickConversion tem um valor definido para gclid e pelo menos um de gbraid ou wbraid. Atualize a conversão para usar apenas um ID de clique e verifique se você não está combinando vários cliques na mesma conversão. Cada clique tem apenas um ID. O ClickConversion tem um valor definido para gbraid ou wbraid e um valor para custom_variables. O Google Ads não aceita variáveis personalizadas para uma conversão com um ID de clique gbraid ou wbraid. Remova a definição do campo custom_variables da conversão.