Nella gerarchia del nuovo Search Ads 360 sono disponibili tre tipi di account:
Account amministratore, in precedenza chiamato "account agenzia". Si tratta del livello più alto della gerarchia dell'account Search Ads 360 e viene utilizzato per l'amministrazione e la generazione di report negli account amministratore secondario e cliente di livello inferiore.
Account amministratore secondario, precedentemente chiamati "account inserzionista". Gli account amministratore secondario fungono da singoli punti di amministrazione e di reporting per gli account cliente che gestiscono.
Account cliente, precedentemente chiamati "account motore". Un account cliente contiene le campagne, i gruppi di annunci e altri elementi.
Scopri di più sulla gerarchia degli account Search Ads 360.
Ogni risorsa Search Ads 360 è di proprietà a livello di account amministratore, amministratore secondario o cliente.
Per eseguire query su una risorsa, devi eseguire l'autenticazione a livello di account proprietario o superiore. Dopo aver eseguito l'autenticazione al livello di account proprietario appropriato, devi includere nella query l'ID specifico dell'account proprietario dei dati richiesti.
Ad esempio, la risorsa CustomColumn
è di proprietà a livello di account amministratore o amministratore secondario, mentre la risorsa Campaign
è di proprietà a livello di account cliente. Ciò significa che per eseguire una query su CustomColumn devi eseguire l'autenticazione a livello di account amministratore o amministratore secondario. Devi
anche specificare nella query l'ID dell'account amministratore o amministratore secondario proprietario
dell'account CustomColumn richiesto. Per eseguire query sui dati di Campaign,
è possibile che tu abbia eseguito l'autenticazione a livello di account amministratore o amministratore secondario. Inoltre, devi specificare nella query l'ID dell'account cliente proprietario dei dati della campagna richiesti.
Descrizione della gerarchia degli account
Per creare report utilizzando l'API Search Ads 360 Reporting, devi prima comprendere la gerarchia degli account identificando le relazioni padre-figlio tra gli account amministratore, amministratore secondario e cliente su cui stai eseguendo query.
Identificare i publisher secondari di un account amministratore o amministratore secondario
Per visualizzare la struttura degli account secondari di un account amministratore o amministratore secondario, crea un'istruzione Query Language di Search Ads 360 per eseguire query su tutti gli account secondari diretti dalla risorsa CustomerClient. Successivamente, esegui una query iterativa sulla risorsa CustomerClient per ogni account secondario diretto per restituire gli account secondari collegati indirettamente all'account amministratore o amministratore secondario.
Identificare il gestore (padre) di un account
Per identificare l'account padre di un account cliente, esegui una query sulla risorsa CustomerManagerLink.
Generare report con dati provenienti da più livelli di account
In alcuni casi, per creare un report dovrai utilizzare i dati di più livelli di account. Ad esempio, potresti ottenere la maggior parte dei dati dalla risorsa Campaign a livello di account cliente, ma anche i dati di supporto della risorsa CustomColumn a livello di account amministratore secondario.
Risorse di proprietà a diversi livelli di account
Alcune risorse, ad esempio BiddingStrategy,
possono essere di proprietà a livello di account amministratore, amministratore secondario e cliente. In questi casi, gli account cliente hanno in genere accesso a diversi sottoinsiemi di dati delle risorse.
Sebbene l'API Search Ads 360 Reporting fornisca metriche per la maggior parte delle risorse solo a livello di account cliente, alcune risorse come BiddingStrategy possono ottenere metriche a livello di amministratore e amministratore secondario.
Proprietà della risorsa
La tabella seguente mostra la proprietà a livello di account per ogni risorsa Search Ads 360.
| Risorsa Search Ads 360 | Proprietà a livello di account |
|---|---|
| Cliente | Amministratore, amministratore secondario e cliente |
| AdGroup | Client |
| AdGroupAd | Client |
| AdGroupCriterion | Client |
| BiddingStrategy | Amministratore secondario e cliente |
| Campagna | Client |
| CampaignCriterion | Client |
| ExtensionFeedItem | Client |
| ConversionAction | Amministratore secondario (escluse metriche) e cliente |
| CustomerManagerLink | Amministratore secondario e cliente |
| CustomColumn | Amministratore e amministratore secondario |