Tipos de conta na API Google Ads

Neste documento, explicamos os diferentes termos usados para descrever contas na API Google Ads e como eles se relacionam.

Visão geral

A API Google Ads usa vários termos para descrever contas, o que às vezes pode causar confusão. Entender essas distinções é importante para gerenciar contas e interpretar respostas da API.

Tipos de conta

As definições a seguir esclarecem os diferentes tipos de conta que você vai encontrar ao trabalhar com a API Google Ads.

Conta de administrador

Uma conta de administrador é uma conta principal usada para gerenciar várias contas do Google Ads.

• Nome anterior: antes, esse recurso era conhecido como "MCC" (Minha central de clientes). Você ainda pode ver esse termo em documentações ou discussões legadas.
• Finalidade: use uma conta de administrador quando quiser vincular e gerenciar várias contas em uma única hierarquia.
• Representação da API: identificada por um recurso Customer, em que customer.manager é true.

Conta de anunciante (veiculação)

Uma conta de anunciante (ou conta de veiculação) é uma conta individual do Google Ads que veicula campanhas publicitárias.

• Finalidade: é onde as campanhas, os grupos de anúncios, os grupos de recursos e os anúncios são criados e veiculados.
• Representação da API: identificada por um recurso Customer, em que customer.manager é false.

Conta de cliente

Uma conta de cliente é qualquer conta (de anunciante ou de administrador) vinculada e gerenciada por uma conta de administrador superior na hierarquia.

• Contexto: o termo "cliente" se refere à relação na hierarquia (gerenciada por um administrador), não necessariamente a um "cliente" no sentido comercial.
• Representação da API: consulte CustomerClient para inspecionar contas na hierarquia de um administrador e use CustomerClientLink para gerenciar as vinculações entre contas de administrador e contas de cliente.

Cliente

No contexto da API, um cliente é o recurso que representa qualquer conta do Google Ads, seja uma conta de administrador ou uma conta de anunciante.

• Representação: todas as contas são representadas por um recurso Customer, identificado por um customer_id.
• Papel: a natureza da conta (administrador ou veiculação) depende do recurso específico.

Conta de teste

As contas de teste são contas de anunciante especiais organizadas em uma conta de administrador de teste dedicada especificamente para testar integrações de API. Tanto a conta de administrador de teste quanto as contas de anunciante de teste abaixo dela têm o campo customer.test_account definido como true. Não é possível criar contas de teste em uma conta de gerente de produtos.

• Finalidade: as contas de teste permitem testar chamadas de API sem veicular anúncios reais nem gerar custos. Eles não veiculam anúncios em transmissões ao vivo.
• Representação da API: identificada por um recurso Customer, em que customer.test_account é true (com customer.manager distinguindo uma conta de administrador de teste de uma conta de anunciante de teste).

Exemplo de hierarquia

Uma hierarquia típica é assim:

• Conta de administrador A (nível superior)
  • Conta de cliente B (conta de anunciante)
  • Conta de cliente C (outra conta de administrador)
    • Conta de cliente D (conta de anunciante)

Neste exemplo:

• A conta A é de administrador.
• As contas B, C e D são contas de cliente em relação às contas principais.
• As contas B e D são de anunciante (veiculação).
• A conta C é uma conta de cliente (para A) e uma conta de administrador (para D).