Tipos de conta na API Google Ads

Este documento explica 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 gerar confusão. É importante entender essas distinções 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:era conhecida como "MCC" (Minha central de clientes). Você ainda pode encontrar 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:é aqui que 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 ao relacionamento na hierarquia (gerenciado 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 vínculos 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 Customer recurso, identificado por um customer_id.
• Função: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 ativos ou gerar custos. Elas não veiculam anúncios ativos.
• 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 é uma conta de administrador.
• As contas B, C e D são contas de cliente em relação aos pais.
• As contas B e D são contas de anunciante (veiculação).
• A conta C é uma conta de cliente (para A) e uma conta de administrador (para D).