L'API Search Ads 360 Reporting si basa su una piattaforma moderna e introduce una serie di nuovi concetti. Questi sono descritti nelle sezioni seguenti.
Risorse
Gli oggetti risorsa sostituiscono i tipi di report. Anziché richiedere tipi di report predefiniti, ora puoi eseguire query su tutte le risorse utilizzando un nuovo linguaggio di query simile a SQL. Per saperne di più, consulta la sezione Struttura dell'API Search Ads 360 Reporting.
Report di ricerca
La Ricerca ha un proprio servizio nella nuova API. Il servizio Ricerca sostituisce il servizio Report legacy. Tutte le query passano attraverso
SearchAds360Service
che fornisce due metodi, SearchStream e Search, per cercare e
recuperare dati e metriche dei report. Entrambi i metodi di ricerca restituiscono tutti gli oggetti SearchAds360Row che corrispondono alla query di ricerca. Per saperne di più, consulta la sezione
Creare report di ricerca.
Metadati delle risorse
SearchAds360FieldService
ti consente di richiedere dinamicamente il catalogo per risorse, campi risorsa, chiavi di segmentazione e metriche disponibili nei metodi di ricerca SearchAds360Service. Per saperne di più, consulta la sezione Recuperare i metadati delle risorse.
Nomi dei campi
L'API introduce nomi di campi nidificati separati dalla notazione con punti. Ad esempio, campaign.id e ad_group.id. Puoi anche nidificare ulteriormente, ad esempio ad_group.campaign.id. Per saperne di più, consulta la sezione
Struttura dell'API Search Ads 360 Reporting.
I report nella precedente API Search Ads 360 si basano su campi separati su entità diverse per concetti simili. Ad esempio, 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 ti consente di definire query per recuperare i dati dei report specifici più adatti alla tua attività. Per saperne di più, consulta la sezione Linguaggio di query di Search Ads 360.
Richieste GET
Nella nuova API, la ricerca ha un proprio servizio (SearchAds360Service), ma le richieste GET esistono ancora nel servizio specifico di ogni entità. Ad esempio, puoi ottenere
informazioni sulle colonne personalizzate da
CustomColumnService.
Per saperne di più, consulta la sezione
Modifiche al formato nell'API Search Ads 360 Reporting.
Colonne personalizzate
Nel nuovo Search Ads 360, le colonne formula e le conversioni personalizzate vengono chiamate colonne personalizzate.
Scopri di più sulle colonne personalizzate.
Il nuovo
CustomColumnService
consente di utilizzare le colonne personalizzate. Se disponi delle autorizzazioni necessarie, puoi richiedere le risorse CustomColumn di proprietà di qualsiasi account nella struttura dell'account.
Gestione 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 e gli account amministratore secondario corrispondono agli account inserzionista nella precedente esperienza Search Ads 360. Per saperne di più, consulta la sezione Informazioni sugli account amministratore di Search Ads 360.
Puoi eseguire query sulla struttura dell'account e poi inviare richieste per ogni account da cui vuoi ottenere i dati dei report.
A seguito della modifica della gerarchia degli account, i campi correlati al concetto di inserzionista/agenzia sono stati sostituiti con alternative appropriate per fornire la parità funzionale ove possibile. Per un elenco dei campi interessati e dei relativi sostituti, consulta la sezione Mappature dei campi.
Intestazione ID cliente di accesso
login-customer-id è una nuova intestazione obbligatoria quando utilizzi un account amministratore per accedere a un account amministratore secondario o cliente. Per saperne di più, consulta la sezione
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,
formattate come vMAJOR_MINOR. Per saperne di più, consulta la sezione
Controllo delle versioni.