Solução de problemas

Se você tiver problemas ao usar a API Search Ads 360, consulte esta seção de solução de problemas.

Se você não conseguir resolver um problema depois de ler os recursos deste site, entre em contato com o suporte e tenha as seguintes informações prontas:

Erros de autorização

Confira alguns erros de autorização comuns:

Mensagem Descrição

Access Not Configured. Please use Google API Console to activate the API for your project.

Esse erro ocorre se você não tiver ativado a API Search Ads 360 para sua conta. Verifique se você fez o seguinte:

  1. Vá para o Console de APIs do Google.

  2. Selecione o projeto. Se você ainda não criou um projeto, consulte Criar um projeto para o cliente.

  3. Na barra lateral à esquerda, expanda APIs e autorização. Em seguida, clique em APIs. Na lista de APIs, confira se o status da API Search Ads 360 está ATIVADO.

Invalid grant

Esse erro ocorre quando o token de atualização não é válido. É possível receber um token de atualização invocando o script de utilitário do Search Ads 360 da seguinte maneira:

sa360Api.py --login

Saiba mais sobre o fluxo de trabalho recomendado para autorização.

Invalid client
no application name

Esse erro ocorre se você não especificou um nome de produto ao configurar seu projeto no Google API Console. Para corrigir esse erro, insira o nome do seu produto na tela de consentimento do Console de APIs do Google.

Outros tipos de erros de autorização

Use uma Conta do Google que tenha acesso ao Search Ads 360 ao fazer login no Console de APIs do Google para recuperar o ID e o segredo do cliente e ao receber um token de atualização.

Erros no upload de conversões

A tabela a seguir lista os erros que podem ocorrer ao fazer upload de conversões. Os códigos de erro hexadecimais são imutáveis, então você pode usá-los nos seus próprios scripts para identificar erros.

Código do erro Mensagem Descrição
0x00000101

Click ID '{ID}' is not found

O ID de clique especificado em uma solicitação update não é válido. Faça o upload de novo das conversões depois de seguir estas etapas:

  • Verifiquei se o ID do clique foi gerado seis horas antes do upload das conversões.

  • Ativar o serviço de conversão da API.

  • Se você atribuir conversões a visitas específicas, aguarde pelo menos 6 horas após a visita para fazer upload da conversão. Talvez o Search Ads 360 não reconheça o ID de clique de uma visita se você fizer upload em menos de 6 horas após o acesso. Em casos raros, talvez seja necessário aguardar até 24 horas para que o Search Ads 360 reconheça o clickID.

  • Confirmou que o clique é de uma origem válida, conforme indicado pelo parâmetro gclsrc.

  • Confirme se você especificou o anunciante correto na coluna advertiserId.

  • Verifiquei que o ID do clique foi gerado nos últimos 90 dias.

0x0000010E Floodlight activity name '{name}' is not found

O nome da atividade do Floodlight especificada na coluna segmentationName está incorreto ou ainda não está disponível. Se esse erro aparecer, verifique os seguintes problemas comuns:

  • Os nomes diferenciam maiúsculas de minúsculas. Por isso, verifique se a solicitação corresponde exatamente ao caso.
  • Verifique se não há caracteres Unicode não imprimíveis ou espaços duplos no nome da atividade do Floodlight.
  • Verifique se você especificou o nome de uma atividade do Floodlight, não de uma coluna do Floodlight.
  • Verifique se a atividade do Floodlight existe para o anunciante especificado na coluna advertiserId. Talvez você tenha especificado o anunciante errado.
  • Depois de criar ou editar uma atividade do Floodlight, aguarde algumas horas antes de fazer o upload das conversões dela.
0x00000115 Custom dimension '{name}' is not found

Verifique se a variável personalizada do Floodlight especificada foi configurada como uma dimensão (não uma métrica) para o anunciante associado à clickId, criterionId ou productGroupId que você está atribuindo à conversão.

0x00000116 Custom metric '{name}' is not found

Verifique se a variável personalizada do Floodlight especificada foi configurada como uma métrica (não uma dimensão) para o anunciante associado ao clickId, criterionId ou productGroupId que você está atribuindo à conversão.

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

Alguém já enviou uma conversão para o mesmo escopo e ID de conversão do anunciante especificado na coluna conversionId.

O "ID de conversão do anunciante" é um ID gerado por você. O Search Ads 360 exige que esse ID seja exclusivo para um determinado escopo. O ID de conversão do Search Ads 360 é gerado pelo Search Ads 360 e é garantido que ele é exclusivo.

0x0000011B Advertiser conversion ID '{ID}' is not found

Sua solicitação update tentou atualizar um ID de conversão de anunciante que não existe. Verifique se você especificou o ID correto.

0x0000011D User does not have permission to view advertiser {advertiser ID}

A Conta do Google que seu cliente está usando não tem permissão para acessar o anunciante especificado na solicitação.

Ao fazer login no Console de APIs do Google para recuperar o ID e o segredo do cliente e receber um token de atualização, use uma Conta do Google que tenha acesso concedido ao anunciante especificado.

0x0000011F Advertiser conversion ID is already specified in this request

Duas ou mais conversões na solicitação especificam o mesmo escopo e o mesmo ID de conversão do anunciante.

O ID de conversão do anunciante é um ID gerado e especificado na coluna conversionId. O Search Ads 360 exige que esse ID seja exclusivo para um determinado escopo.

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

O ID ou nome da atividade do Floodlight informado não corresponde ao tipo de conversão especificado.

Informar códigos de resposta e mensagens de erro

Se você solicitar um relatório e a resposta for uma mensagem de erro, consulte Códigos de resposta na API Search Ads 360 e Respostas de erro padrão para mais informações sobre o erro.

Os dados na interface do Search Ads 360 não correspondem a um relatório retornado pela API

Por padrão, os dados na interface do Search Ads 360 precisam corresponder aos dados retornados pela API. Se você definir includeRemovedEntities como true em uma solicitação de relatório, verifique se a caixa de seleção Mostrar removido também está selecionada na interface.