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 causar 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:antes, 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 à 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 vinculações entre contas de administrador e de cliente.

Cliente

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

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

Conta de teste

As contas de teste são contas especiais de anunciante 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 administrador de produção.

• Finalidade:as contas de teste permitem testar chamadas de API sem veicular anúncios ativos ou gerar custos. Eles 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 gerente 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 admin)
    • 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 familiares responsáveis.
• As contas B e D são de anunciante (veiculação).
• A conta C é uma conta de cliente (de A) e de administrador (de D).