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:
ID da agência e do anunciante do Search Ads 360 que você está tentando acessar
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.
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.
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.
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 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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-12-21 UTC."],[[["This page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors."],["If 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."],["The page lists common authorization errors such as `Access Not Configured`, `Invalid grant`, and `Invalid client`, with explanations and solutions."],["It also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps."],["For report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the `includeRemovedEntities` setting in your request matches the \"Show removed\" checkbox selection in the Search Ads 360 UI."]]],["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"]]