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 houver um problema que você não consiga resolver depois de ler os recursos neste site, entre em contato com o suporte e tenha as informações a seguir:

  • ID da agência e do anunciante do Search Ads 360 que você está tentando acessar

  • Número do projeto do Console de APIs do Google

  • O nome de usuário da Conta do Google que você está usando para acessar a API.
    Essa é a conta com permissão para acessar o Search Ads 360, a mesma conta usada para configurar a autorização.

  • Snippet de código da solicitação

  • Resposta JSON
    Se a resposta for um erro, inclua a mensagem, não apenas o código numérico.

Erros de autorização

Veja alguns erros de autorização encontrados com frequência:

A mensagem Descrição

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

Esse erro ocorre quando você não ativa 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 está ATIVADO na API Search Ads 360.

Invalid grant

Esse erro ocorre quando o token de atualização não é válido. Você pode conseguir 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 o projeto no Console de APIs do Google. Para corrigir esse erro, insira o nome do 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 recebido acesso ao Search Ads 360 ao fazer login no Console de APIs do Google para recuperar o ID e a chave secreta do cliente e receber um token de atualização.

Erros no upload de conversões

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

Código do erro A mensagem Descrição
0x00000101

Click ID '{ID}' is not found

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

  • O código de clique foi gerado quatro horas antes do upload das conversões.

  • Ativação do serviço de conversão da API.

  • Se você estiver atribuindo conversões a visitas específicas, aguarde pelo menos 30 minutos após a visita antes de fazer o upload da conversão. O Search Ads 360 poderá não reconhecer o clickID da visita se você fizer o upload em menos de 30 minutos após a visita. Em casos raros, pode ser necessário esperar até quatro 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.

  • Seu ID de 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 você encontrar esse erro, verifique os seguintes problemas comuns:

  • Os nomes diferenciam maiúsculas de minúsculas, portanto, verifique se sua solicitação corresponde exatamente ao caso.
  • Verifique se você não incluiu qualquer caractere Unicode não imprimível ou espaços duplos no nome da atividade do Floodlight.
  • É preciso especificar o nome de uma atividade do Floodlight, não uma coluna do Floodlight.
  • Verifique se a atividade do Floodlight existe para o anunciante que você especificou na coluna advertiserId. É possível que 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 para a atividade.
0x00000115 Custom dimension '{name}' is not found

Verifique se a variável personalizada do Floodlight que você especificou foi configurada como uma dimensão (não uma métrica) para o anunciante associado a 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 a 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á fez upload de uma conversão para o mesmo escopo e o mesmo ID de conversão do anunciante especificado na coluna conversionId.

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

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

A solicitação update tentou atualizar um ID de conversão do 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 ver o anunciante especificado na solicitação.

Ao fazer login no Console de APIs do Google para recuperar o ID e a chave secreta do cliente e para receber um token de atualização, use uma Conta do Google que tenha acesso 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 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 nome ou ID 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 IU do Search Ads 360 não correspondem a um relatório retornado pela API

Por padrão, os dados da IU 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 removidas também está marcada na IU.