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 ocorrerá se você não tiver ativado a API Search Ads 360 na 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, verifique se o status da API Search Ads 360 está ATIVADO.

Invalid grant

Este 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 de 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 do clique especificado em uma solicitação update não é válido. Refaça o upload das conversões depois de realizar as seguintes ações:

  • Verifiquei se o ID do clique foi gerado quatro 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 30 minutos após a visita antes de fazer upload da conversão. O Search Ads 360 poderá não reconhecer o ID de clique da visita se você fizer o upload menos de 30 minutos após a visita. Em casos raros, talvez seja necessário esperar até 4 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.

  • Confirmou que você especificou o anunciante correto na coluna advertiserId.

  • Verifique se 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 upload de conversões para ela.
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 que você especificou foi configurada como uma métrica (não uma dimensão) para o anunciante associado ao clickId, criterionId ou productGroupId que você está atribuindo pela 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 tem a garantia de ser único.

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 ID de conversão do anunciante.

O ID de conversão do anunciante é 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 o nome da atividade do Floodlight fornecido 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

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