Solução de problemas
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
Vá para o Console de APIs do Google.
Selecione o projeto. Se você ainda não criou um projeto, consulte
Criar um projeto para o cliente.
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 novamente das conversões depois de fazer o seguinte:
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 .
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 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 à 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 o nome da atividade do Floodlight que você informou não corresponde ao tipo de conversão especificado. |
0x00000126 |
Service internal error |
Tente novamente mais tarde. Esse problema pode ser temporário. Entre em contato com o suporte do SA360 se o erro persistir. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-07 UTC.
[null,null,["Última atualização 2025-04-07 UTC."],[[["\u003cp\u003eThis page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors.\u003c/p\u003e\n"],["\u003cp\u003eIf the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses.\u003c/p\u003e\n"],["\u003cp\u003eThe page lists common authorization errors such as \u003ccode\u003eAccess Not Configured\u003c/code\u003e, \u003ccode\u003eInvalid grant\u003c/code\u003e, and \u003ccode\u003eInvalid client\u003c/code\u003e, with explanations and solutions.\u003c/p\u003e\n"],["\u003cp\u003eIt also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps.\u003c/p\u003e\n"],["\u003cp\u003eFor report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the \u003ccode\u003eincludeRemovedEntities\u003c/code\u003e setting in your request matches the "Show removed" checkbox selection in the Search Ads 360 UI.\u003c/p\u003e\n"]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"],null,[]]