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 seguintes informações em mãos:

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

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

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

  • Snippet de código da sua solicitação

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

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 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

Esse erro ocorre quando o token de atualização não é válido. Para receber um token de atualização, invoque 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 Console de APIs do Google. Para corrigir esse erro, insira o nome do seu produto na tela de permissão do Console de APIs do Google.

Outros tipos de erros de autorização

Use uma Conta do Google com acesso concedido ao Search Ads 360 ao fazer login no Console de APIs do Google para recuperar o ID do cliente e a chave secreta do cliente e ao obter 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 do 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 insert ou update não é válido. Faça o upload das conversões novamente depois de:

  • Verificado que o ID de clique foi gerado seis horas antes do upload das conversões.

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

  • Se você estiver atribuindo conversões a visitas específicas, aguarde pelo menos 6 horas após a visita antes de fazer o upload da conversão. Talvez o Search Ads 360 não reconheça o clickID da visita se você fizer o upload em menos de seis horas após a visita. Em casos raros, pode ser necessário aguardar até 24 horas para que o Search Ads 360 reconheça o clickId.

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

  • Verifique se o ID de clique foi gerado nos últimos 90 dias.

0x00000106 Either a click ID or keyword ID is required

A conversão não especifica a que é atribuída. Especifique a coluna clickId ou as colunas customerId, campaignId, adGroupId e criterionId que identificam uma palavra-chave.

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

Especifique segmentationType: "FLOODLIGHT" e a atividade do Floodlight na coluna segmentationName ou segmentationId.

Quando você edita uma conversão que o Search Ads 360 registrou usando uma tag do Floodlight, a atividade do Floodlight é necessária para identificar a conversão.

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

O nome da atividade do Floodlight especificado na coluna segmentationName está incorreto ou ainda não está disponível. Se você receber esse erro, verifique se os seguintes problemas comuns ocorreram:

  • Os nomes diferenciam maiúsculas de minúsculas. Por isso, verifique se a solicitação corresponde exatamente ao nome.
  • Verifique se você não incluiu 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 a que o ID de clique ou a palavra-chave na sua solicitação pertence.
  • 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 ao 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.

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

Sua solicitação de update não especificou a coluna conversionId. conversionId é necessário para identificar a conversão que você quer editar. Consulte Descontinuação de dsConversionId.

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

Alguém já fez o upload de 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 que você gera. 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 como exclusivo.

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

Sua solicitação de update tentou atualizar um ID de conversão do anunciante que não existe. Verifique os seguintes problemas comuns:

  • Verifique se você especificou o ID correto na coluna conversionId . Para conversões enviadas pela API, esse é o conversionId que você especificou ao inserir a conversão. Para conversões registradas por tags do Floodlight, esse é o código do pedido do Floodlight.
  • Verifique se conversionTimestamp é o carimbo de data/hora da conversão atual, em milissegundos da Era Unix UTC. Um carimbo de data/hora convertido de um fuso horário local ou especificado em segundos em vez de milissegundos não corresponde à conversão atual.
  • Para conversões registradas por tags do Floodlight, verifique se você especificou a atividade do Floodlight da conversão na coluna segmentationName ou segmentationId e se a conversão ocorreu nos últimos 28 dias.
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 ao qual o ID de clique ou a palavra-chave na solicitação pertence.

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

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 é um ID que você gera e especifica 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 que você informou não corresponde ao tipo de conversão especificado.

0x00000124 Conversion timestamp is before click timestamp

O conversionTimestamp é anterior ao horário do clique especificado na coluna clickId. Verifique se o carimbo de data/hora está especificado em milissegundos de época UTC, não em segundos ou em um fuso horário local.

0x00000125 Conversion age is older than the max supported age

Sua solicitação de update tentou editar uma conversão que é muito antiga para ser editada. As conversões que o Search Ads 360 registrou usando tags do Floodlight só podem ser editadas em até 28 dias após o conversionTimestamp.

0x00000126 Service internal error

Tente fazer a solicitação novamente mais tarde. Esse erro pode ser temporário. Entre em contato com o suporte do SA360 se o erro persistir.

0x00000129 Invalid customer ID: {ID}

O Search Ads 360 não consegue encontrar o ID de cliente que você especificou na coluna customerId. Especifique o ID de cliente do novo Search Ads 360 da conta de cliente que contém a palavra-chave, por exemplo, 123-456-7890.

0x0000012C Cannot find this keyword ID in Search Ads 360.

O Search Ads 360 não consegue encontrar a palavra-chave identificada pelas colunas customerId, campaignId, adGroupId e criterionId. Verifique se os quatro IDs são do novo Search Ads 360 e se a palavra-chave pertence ao grupo de anúncios, à campanha e à conta de cliente que você especificou.

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

Uma conversão atribuída a uma palavra-chave precisa especificar customerId, campaignId, adGroupId e criterionId. A mensagem indica o ID que está faltando. Consulte Atribuir uma conversão somente a uma palavra-chave.

0x0000012F Editing a click ID older than 60 days is not supported.

Sua solicitação de update especificou um clickId que foi gerado há mais de 60 dias. As conversões só podem ser editadas em até 60 dias após o clique.

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

Sua solicitação update especificou a coluna descontinuada dsConversionId ou transmitiu um ID de conversão do Search Ads 360 na coluna conversionId. Identifique a conversão pelo ID de conversão do anunciante. Consulte Descontinuação de dsConversionId.

Códigos de resposta de relatórios 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 Mostrar removidos também está marcada na interface.