Nuovi concetti nella nuova API Search Ads Reporting

L'API Search Ads 360 Reporting si basa su una piattaforma moderna e introduce una serie di nuovi concetti. e sono descritte nelle sezioni seguenti.

Risorse

Gli oggetti risorsa sostituiscono i tipi di report. Invece di richiedere tipi di report predefiniti, ora puoi eseguire query su tutte le risorse utilizzando un nuovo linguaggio di query di tipo SQL. Per saperne di più, consulta Struttura dell'API Search Ads 360 Reporting.

Nota: l'API Search Ads 360 Reporting fornisce metriche per la maggior parte delle risorse solo a livello di account cliente. Scopri di più sulla gerarchia degli account Search Ads 360 e sulla proprietà delle risorse.

Report sulle ricerche

La ricerca dispone di un proprio servizio nella nuova API. Il servizio di ricerca sostituisce il precedente servizio Report. Tutte le query passano attraverso SearchAds360Service, che offre due metodi, SearchStream e Search, per la ricerca e il recupero di dati e metriche dei report. Entrambi i metodi di ricerca restituiscono tutti gli oggetti SearchAds360Row che corrispondono alla tua query di ricerca. Per ulteriori informazioni, consulta Creare report di ricerca.

Metadati delle risorse

SearchAds360FieldService consente di richiedere dinamicamente il catalogo per le risorse, i campi delle risorse, le chiavi di segmentazione e le metriche disponibili nei metodi di ricerca SearchAds360Service. Per saperne di più, consulta Recupero dei metadati delle risorse.

Nomi dei campi

L'API introduce nomi di campi nidificati separati da una notazione con punto. Ad esempio, campaign.id e ad_group.id. Puoi anche nidificare ulteriormente, ad esempio,ad_group.campaign.id. Per saperne di più, consulta Struttura dell'API Search Ads 360 Reporting.

I report nella precedente API Search Ads 360 si basano su campi distinti su entità diverse per concetti simili. Ad esempio, entrambi i report campaign e adgroup includono un campo campaignId separato.

Linguaggio di query

L'API introduce il linguaggio di query di Search Ads 360. Si tratta di un linguaggio flessibile simile a SQL che consente di definire query per recuperare i dati dei report specifici più adatti alla tua attività. Per ulteriori informazioni, consulta il documento sul linguaggio di query di Search Ads 360.

Ricevi richieste

Nella nuova API, la ricerca ha il proprio servizio (SearchAds360Service), ma le richieste GET esistono ancora per il servizio specifico di ogni entità. Ad esempio, puoi ottenere informazioni sulle colonne personalizzate dal CustomColumnService. Per scoprire di più, consulta Modifiche ai formati nell'API Search Ads 360 Reporting.

Nota: le richieste GET hanno uno scopo diverso nella nuova API. Non puoi filtrare come parte di una chiamata get. Quando passi il nome della risorsa dell'entità come identificatore, la risposta include tutti i campi compilati (non è necessario elencarli).

Colonne personalizzate

Nella nuova esperienza Search Ads 360, le colonne formula e le conversioni personalizzate vengono chiamate colonne personalizzate. Scopri di più sulle colonne personalizzate. Il nuovo CustomColumnService attiva le colonne personalizzate. Se disponi delle autorizzazioni necessarie, puoi richiedere risorse CustomColumn di proprietà di qualsiasi account nella struttura ad albero.

Gestione dell'account

Il nuovo Search Ads 360 organizza gli account in una gerarchia di account amministratore, account amministratore secondario e account cliente. Un account amministratore rappresenta l'account agenzia, mentre gli account amministratore secondario rappresentano gli account inserzionista nella precedente esperienza Search Ads 360. Per saperne di più, consulta Informazioni sugli account amministratore Search Ads 360.

Puoi eseguire una query nella struttura ad albero e poi inviare richieste per ciascun account da cui vuoi generare report sui dati.

In seguito alla modifica della gerarchia degli account, i campi relativi al concetto di inserzionista/agenzia sono stati sostituiti con alternative appropriate per garantire la parità funzionale laddove possibile. Consulta Mappature dei campi per un elenco dei campi interessati e dei relativi sostituti.

Intestazione ID cliente di accesso

login-customer-id è una nuova intestazione obbligatoria quando si utilizza un account amministratore per accedere a un account amministratore secondario o cliente. Per ulteriori informazioni, consulta Intestazione ID cliente di accesso.

Controllo delle versioni

L'API Search Ads 360 Reporting utilizza il controllo delle versioni semantico. Esistono versioni principali e secondarie, nel formato vMAJOR_MINOR. Per scoprire di più, consulta Controllo delle versioni.