Há três tipos de contas na nova hierarquia do Search Ads 360:
Conta de administrador: antes chamada de "conta de agência". Esse é o nível mais alto da hierarquia de contas do Search Ads 360 e é usado para administração e geração de relatórios nas contas de cliente e de subadministrador de nível inferior.
Contas de subadministrador, antes 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 eles gerenciam.
Contas de cliente: antes 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 é de propriedade do administrador, do subadministrador ou da conta de cliente.
Para consultar um recurso, você precisa estar autenticado no nível da conta de proprietário ou superior. Depois que você for autenticado no nível adequado da conta de proprietário, é necessário incluir na consulta o ID específico da conta proprietária dos dados solicitados.
Por exemplo, o recurso CustomColumn
é de propriedade da conta de administrador ou subadministrador, enquanto o recurso Campaign
é de propriedade da conta de cliente. Isso significa que, para consultar
CustomColumn,
você precisa ser 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 tem o CustomColumn solicitado. Para consultar dados de Campaign,
você pode fazer a autenticação no nível da conta de administrador ou de subadministrador. Além disso, é necessário especificar na consulta o ID da conta de cliente que é proprietária dos dados da campanha solicitada.
Noções básicas sobre a hierarquia de contas
Para criar relatórios usando a API Search Ads 360 Reporting, primeiro é preciso entender a hierarquia de contas, identificando as relações mãe-filha 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 de forma iterativa o recurso CustomerClient para cada conta filha direta para retornar as contas filhas que estão vinculadas indiretamente à conta de administrador ou subadministrador.
Identificação do administrador (pai) de uma conta
Para identificar o pai de uma conta de cliente, consulte o recurso
CustomerManagerLink.
Criação de relatórios com dados de vários níveis de conta
Em alguns casos, você vai precisar usar dados de vários níveis de conta para criar um
relatório. Por exemplo, você pode receber a maioria dos seus dados do recurso Campaign no nível da conta de cliente, mas também exigir dados de suporte do recurso CustomColumn no nível da conta de subadministrador.
Recursos de propriedade em diferentes níveis de conta
Alguns recursos, como BiddingStrategy,
podem ser de propriedade do administrador, do subadministrador e da conta de cliente. Nesses
casos, as contas de cliente geralmente têm acesso a diferentes subconjuntos de
dados de recursos.
Embora a API Search Ads 360 Reporting forneça métricas para a maioria dos recursos apenas no nível da conta de cliente, alguns recursos, como BiddingStrategy, podem receber métricas nos níveis de administrador e subadministrador.
Propriedade de recursos
A tabela a seguir mostra a propriedade no nível da conta para cada recurso do Search Ads 360.
| Recurso do Search Ads 360 | Propriedade no nível da conta |
|---|---|
| Cliente | Administrador, subadministrador e cliente |
| AdGroup | Cliente |
| AdGroupAd | Cliente |
| AdGroupCriterion | Cliente |
| BiddingStrategy | Subadministrador e cliente |
| Campanha | Cliente |
| CampaignCriterion | Cliente |
| ExtensionFeedItem | Cliente |
| ConversionAction | Subadministrador (excluindo métricas) e cliente |
| CustomerManagerLink | Subadministrador e cliente |
| CustomColumn | Administrador e Subadministrador |