L'API Search Ads 360 Reporting si basa su una piattaforma moderna e introduce una serie di nuovi concetti. Questi aspetti sono descritti nelle sezioni seguenti.
Risorse
Gli oggetti Resource 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 struttura dell'API Search Ads 360 Reporting.
Report sulla rete di ricerca
La ricerca dispone di un proprio servizio nella nuova API. Il servizio di ricerca sostituisce il servizio Report precedente. Tutte le query passano attraverso
SearchAds360Service, che offre 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 ulteriori informazioni, consulta
Creare report sulla rete di ricerca.
Metadati delle risorse
SearchAds360FieldService ti consente di richiedere in modo dinamico il catalogo delle risorse, dei campi delle risorse, delle chiavi di segmentazione e delle 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 con la notazione puntata. Ad esempio, campaign.id e ad_group.id. Puoi anche nidificare ulteriormente, ad esempioad_group.campaign.id. Per saperne di più, consulta la struttura dell'API Search Ads 360 Reporting.
I report nell'API Search Ads 360 precedente si basano su campi distinti in entità diverse per concetti simili. Ad esempio, sia i report campaign che adgroup includono un campo campaignId distinto.
Linguaggio di query
L'API introduce il linguaggio di query Search Ads 360. Si tratta di un linguaggio flessibile, simile all'SQL, che consente di definire query per recuperare i dati dei report specifici che meglio si adattano alla tua attività. Per saperne di più, consulta Language di query di Search Ads 360.
Ricevi richieste
Nella nuova API, la ricerca ha il proprio servizio (SearchAds360Service), ma
le richieste GET continuano a essere presenti nel servizio specifico di ciascuna entità. Ad esempio, puoi recuperare le informazioni sulle colonne personalizzate dal CustomColumnService. Per saperne di più, consulta Modifiche dei formati 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 le colonne personalizzate. Se disponi delle autorizzazioni necessarie, puoi richiedere risorse CustomColumn di proprietà di qualsiasi account nella struttura ad albero.
Gestione account
Il nuovo Search Ads 360 prevede una gerarchia ordinata per 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 Informazioni sugli account amministratore Search Ads 360.
Puoi eseguire query sull'albero dell'account e inviare richieste per ogni account da cui vuoi generare report.
In seguito alla modifica nella gerarchia degli account, i campi relativi al concetto di inserzionista/agenzia sono stati sostituiti con alternative appropriate per offrire la parità funzionale quando possibile. Consulta Mappature dei campi per un elenco dei campi interessati e dei relativi sostituti.
Intestazione ID cliente di accesso
login-customer-id è un nuovo intestazione obbligatorio 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 versionamento semantico.
Esistono versioni principali e secondarie, formattate come
vMAJOR_MINOR. Per saperne di più, consulta la sezione Controllo delle versioni.