Há três tipos de contas na hierarquia do novo Search Ads 360:
Conta de administrador (anteriormente chamada de "conta da agência"). Esse é o nível superior da hierarquia de contas do Search Ads 360 e é usado para administração e geração de relatórios nas contas de cliente e subadministrador de nível inferior.
Contas de subadministrador, anteriormente chamadas de "contas de anunciantes". As contas de subadministrador atuam como pontos únicos de administração e geração de relatórios nas contas de cliente que elas gerenciam.
Contas de cliente - anteriormente chamadas de "contas de mecanismo". Uma conta de cliente contém as campanhas, os grupos de anúncios e outros itens.
Saiba mais sobre a hierarquia de contas do Search Ads 360.
Cada recurso do Search Ads 360 pertence ao nível de conta de administrador, subadministrador ou cliente.
Para consultar um recurso, você precisa estar autenticado no nível da conta de proprietário ou superior. Depois de autenticar-se no nível apropriado da conta do proprietário, você precisa incluir na consulta o ID específico da conta proprietária dos dados solicitados.
Por exemplo, o recurso CustomColumn é de propriedade no nível da conta de administrador ou subadministrador, enquanto o recurso Campaign é de propriedade no nível da conta de cliente. Isso significa que, para consultar CustomColumn, você precisa estar autenticado no nível da conta de administrador ou subadministrador. Também é necessário especificar na consulta o ID da conta de administrador ou subadministrador que detém a CustomColumn solicitada. Para consultar os dados de Campaign, você pode ter autenticação no nível da conta de administrador ou subadministrador. Além disso, é necessário especificar na consulta o ID da conta de cliente que tem os dados da campanha solicitados.
Noções básicas sobre a hierarquia da conta
Para criar relatórios usando a API Search Ads 360 Reporting, primeiro é preciso entender a hierarquia de contas identificando as relações pai-filho entre as contas de administrador, subadministrador e cliente que você está consultando.
Identificar crianças em uma conta de administrador ou subadministrador
Para conferir a estrutura das contas filhas em uma conta de administrador ou subadministrador, crie uma instrução da linguagem de consulta do Search Ads 360 para consultar todas as contas filhas diretas do recurso CustomerClient. Em seguida, consulte iterativamente o recurso CustomerClient para cada conta filha direta para retornar as contas filhas vinculadas indiretamente à conta de administrador ou subadministrador.
Identificar o administrador (mãe) de uma conta
Para identificar o pai de uma conta de cliente, consulte o recurso
CustomerManagerLink.
Criar relatórios com dados de vários níveis da conta
Em alguns casos, você precisará usar dados de vários níveis da conta para criar um relatório. Por exemplo, talvez você receba a maioria dos dados do recurso Campaign
na conta de cliente, mas também precise de dados de suporte do
CustomColumn
na conta de subadministrador.
Recursos em diferentes níveis de conta
Alguns recursos, como BiddingStrategy,
podem ser de propriedade nos níveis da conta de administrador, subadministrador e cliente. Nesses casos, as contas de cliente costumam ter acesso a diferentes subconjuntos de dados de recursos.
Embora a API Search Ads 360 Reporting forneça métricas para a maioria dos recursos somente no nível da conta de cliente, alguns recursos, como BiddingStrategy, podem acessar métricas nos níveis de administrador e subadministrador.
Propriedade de recursos
A tabela a seguir mostra a propriedade no nível da conta de cada recurso do Search Ads 360.
| Recurso do Search Ads 360 | Propriedade no nível da conta |
|---|---|
| Cliente | Gerente, subadministrador e cliente |
| AdGroup | Cliente |
| AdGroupAd | Cliente |
| AdGroupCriterion | Cliente |
| BiddingStrategy | Subadministrador e cliente |
| Campaign | Cliente |
| CampaignCriterion | Cliente |
| ExtensionFeedItem | Cliente |
| ConversionAction | Subadministrador (excluindo métricas) e cliente |
| CustomerManagerLink | Subadministrador e cliente |
| CustomColumn | Gerente e subadministrador |