Contas de teste

Com as contas de teste, você pode testar novas implementações de API ou configurações de conta antes de implementar as mudanças no ambiente de produção.

Enquanto as contas de produção veiculam anúncios que exigem faturamento e são renderizados para os usuários, as contas de teste aparecem na interface do Google Ads como canceladas, já que não há faturamento ativo e elas não renderizam anúncios para os usuários.

Como as contas de teste e de produção não podem interagir de forma alguma, não é possível usar uma conta de teste na sua conta de administrador de produção atual. Para usar contas de teste, você precisa de uma nova hierarquia de contas, com uma conta de administrador de teste como raiz.

Você precisa de uma conta de teste?

Antes de criar uma hierarquia de contas de teste separada, verifique qual opção de teste é mais adequada para seu caso de uso:

  • Fazer as primeiras chamadas de API ou testar em contas reais (até 2.880 operações por dia): não é necessário ter uma conta de teste, a menos que você esteja testando recursos restritos ao acesso do Explorer (como criação de conta, gerenciamento de usuários, planejamento de palavras-chave ou faturamento). Solicite o nível de acesso Explorer automático na página de visão geral da API Google Ads no console do Google Cloud para consultar e gerenciar contas de produção diretamente.
  • Validar a sintaxe da solicitação e a conformidade com a política sem alterar os dados: defina o campo validate_only em solicitações GoogleAdsService.Search ou de mutação (requer pelo menos acesso de explorador ao segmentar contas de produção).
  • Desenvolver com um projeto de acesso de teste ou testar a criação de campanhas completas em um sandbox sem custo financeiro: siga as etapas nesta página para criar uma conta de gerente de teste e uma conta de cliente de teste.

Por que usar contas de teste?

As contas de teste não afetam seus anúncios ativos nem cobram sua conta. Eles oferecem os seguintes benefícios durante o desenvolvimento ativo:

  • Podem ser configuradas em uma hierarquia e organizadas como as contas de produção.
  • Podem ser visualizadas e manipuladas na interface do Google Ads, assim como as contas de produção.
  • Não exigem que o acesso à API Products seja aprovado para seu projeto do Google Cloud. Assim, você pode começar a testar a API imediatamente enquanto seu projeto tem o nível de acesso de teste. Se um projeto do Google Cloud com acesso de teste tentar chamar uma conta de produção, a API vai retornar AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION a partir de v25 ou AuthorizationError.ACTION_NOT_PERMITTED em v24 e versões anteriores.
  • Não é possível veicular anúncios nem interagir com suas contas de produção de forma alguma. Isso oferece um ambiente seguro para testar alterações de código ou configuração sem afetar suas contas de veiculação.
  • Têm as mesmas restrições, incluindo limites de taxa, que as contas de produção.

Como as contas de teste não têm orçamentos, talvez você veja um erro ao criar uma subconta de teste em uma conta de administrador. Você pode ignorar esse erro com segurança.

Criar contas e campanhas de teste

As instruções a seguir criam uma conta de administrador de teste, uma conta de cliente de teste e algumas campanhas para preencher a conta de cliente de teste. Para uma explicação completa desses tipos de conta, consulte Tipos de conta.

  1. Clique em Criar uma conta de administrador de teste para abrir a página de seleção de contas do Google Ads. Se solicitado, faça login com uma Conta do Google que não esteja vinculada à sua conta de administrador do Google Ads de produção ou crie uma Conta do Google na solicitação de login.

    Criar uma conta de administrador de teste

  2. Na página de seleção de conta, clique em Nova conta do Google Ads (ou clique em Criar uma nova conta se a caixa de diálogo Terminar de configurar sua conta? aparecer). A página de seleção de conta não mostra um indicador de teste, mas abrir essa página em Criar uma conta de administrador de teste configura o fluxo de inscrição para criar uma conta de administrador de teste.

  3. Na página Confirmar suas informações comerciais, insira um Nome de exibição da conta, selecione uma opção de Uso principal da conta e escolha seu país, fuso horário e moeda. Confirme o rótulo da conta Teste em vermelho no canto superior direito, clique em Enviar e em Explorar sua conta para abrir o painel da conta de administrador de teste.

  4. Na sua conta de administrador de teste, crie uma conta de cliente de teste: clique em Contas > > Criar nova conta. Insira um nome de conta, selecione seu país, fuso horário e moeda e salve a conta. Todas as contas de cliente criadas na sua conta de administrador de teste são automaticamente contas de teste.

  5. Crie uma ou mais campanhas de teste na conta de cliente de teste para que as consultas de relatórios subsequentes retornem dados de amostra.

  6. Registre os dois IDs de cliente de 10 dígitos (sem hifens) da interface do Google Ads para sua configuração da API:

    • customer_id (conta de cliente de destino): use o ID de cliente de 10 dígitos da nova conta de cliente de teste em que você criou suas campanhas de teste (as chamadas de API que consultam ou modificam campanhas precisam segmentar uma conta de cliente, não uma conta de administrador).
    • login-customer-id (conta de administrador): se você fizer a autenticação com uma Conta do Google ou de serviço vinculada à sua conta de administrador de teste, defina login-customer-id como o ID de cliente de 10 dígitos da conta de administrador de teste.
  7. Siga as instruções em Fazer sua primeira chamada de API para configurar as credenciais da biblioteca de cliente ou REST e executar uma consulta de teste na nova conta de cliente de teste.

Ver contas de teste

Para ver as contas de cliente de teste em uma conta de administrador de teste na interface do Google Ads, reexiba as contas escolhendo a opção de visualizar as contas canceladas.

Durante a configuração da conta de administrador e em algumas visualizações da interface do Google Ads, as contas de teste mostram um rótulo vermelho Conta de teste:

Interface do Google Ads mostrando um rótulo vermelho de conta de teste

Para verificar se uma conta é de teste usando a API, consulte o campo customer.test_account usando o método GoogleAdsService.Search ou GoogleAdsService.SearchStream:

SELECT customer.id, customer.test_account
FROM customer
LIMIT 1

É possível executar essa consulta em uma conta de administrador ou em uma conta de cliente de teste. Ao consultar uma conta de cliente de teste usando sua conta de administrador de teste, inclua o ID da conta de administrador no cabeçalho login-customer-id. As contas de administrador e de cliente de teste retornam true para customer.test_account, enquanto as contas de produção retornam false.

Limitações

Ao trabalhar com contas de teste, lembre-se das seguintes limitações:

  • Como as contas de teste não podem veicular anúncios nem interagir com suas contas de produção, as métricas de veiculação, como impressões, conversões ou dados de custo, ficam vazias.
  • Não é possível testar alguns recursos em contas de teste, incluindo simulações de lances, uploads de conversão e faturamento. Outros recursos, incluindo recomendações, têm recursos limitados nas contas de teste porque elas não geram dados de veiculação.
  • As hierarquias de contas de administrador de teste podem conter até 50 contas de teste. Se você precisar de mais contas de teste, crie outra conta de administrador de teste.
  • As contas de teste que geram um alto volume de solicitações contínuas podem ser limitadas sem aviso prévio.

Consulte as práticas recomendadas de teste para saber como contornar essas limitações.