I componenti principali dell'API Search Ads 360 Reporting sono le risorse e i servizi. Una risorsa rappresenta un'entità Search Ads 360 e tu utilizzi un servizio per recuperare le entità di Search Ads 360.
Gerarchia degli oggetti
Un account Search Ads 360 è una gerarchia di oggetti.
La risorsa di primo livello di un account è il cliente.
Ciascun account contiene una o più campagne attive.
Ciascun
Campaign
contiene uno o più gruppi di annunci che raggruppano i tuoi annunci in raccolte logiche.Ciascun
AdGroup
contiene uno o più annunci del gruppo di annunci.Puoi collegare uno o più
AdGroupCriterion
oCampaignCriterion
a un gruppo di annunci o a una campagna. I criteri definiscono il modo in cui vengono attivati gli annunci.- Esistono molti tipi di criteri, come parole chiave, fasce d'età e località. I criteri definiti a livello di campagna influiscono su tutte le altre risorse della campagna. Puoi anche specificare budget e date a livello di campagna.
Risorse
Le risorse rappresentano le entità nel tuo account Search Ads 360. Le risorse di esempio includono Customer
, Campaign
e AdGroup
.
ID oggetto
Ogni oggetto in Search Ads 360 è identificato da un proprio ID. Alcuni ID sono univoci a livello globale, ossia in tutti gli account Search Ads 360, mentre altri sono univoci solo all'interno di un ambito limitato.
Ambito di univocità dell'ID oggetto | |
---|---|
ID budget | Globale |
ID campagna | Globale |
ID gruppo di annunci | Globale |
ID annuncio | Gruppo di annunciOgni coppia AdGroupId / AdId è univoca a livello globale. |
ID criteri del gruppo di annunci | Gruppo di annunciOgni coppia AdGroupId / CriterionId è univoca a livello globale. |
ID criterio campagna | PrioritàOgni coppia CampaignId / CriterionId è univoca a livello globale. |
Estensioni annuncio | PrioritàOgni coppia CampaignId / AdExtensionId è univoca a livello globale. |
ID feed | Globale |
ID elemento del feed | Globale |
ID attributo feed | Feed |
ID mappatura feed | Globale |
ID etichetta | Globale |
ID elenco utenti | Globale |
Queste regole ID possono essere utili durante la progettazione dell'archiviazione locale per gli oggetti di Search Ads 360.
Tipi di oggetti
Alcuni oggetti possono essere utilizzati per più tipi di entità. In questo caso, l'oggetto contiene un campo type
che ne descrive i contenuti. Ad esempio, AdGroupAd
può fare riferimento a un annuncio di testo, un annuncio per hotel o un annuncio locale.
Puoi accedere al valore del tipo tramite il campo AdGroupAd.ad.type
. Il suo valore viene restituito nell'enumerazione AdType
.
Nomi delle risorse
Ogni risorsa è identificata in modo univoco da una stringa resource_name
che concatena la risorsa e i relativi elementi padre in un percorso.
I nomi delle risorse della campagna, ad esempio, hanno il seguente formato:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
Una campagna con ID 987654
nell'account Search Ads 360 con ID cliente
1234567
ha resource_name
:
customers/1234567/campaigns/987654
Servizi
I servizi ti consentono di recuperare le entità e i metadati di Search Ads 360. Esistono tre tipi di servizi:
- Cerca servizio
SearchAds360Service
è il servizio unico unificato per il recupero di tutti gli oggetti risorsa e le statistiche delle prestazioni. Offre due metodi:Search
eSearchStream
. Entrambi i metodi richiedono una query che specifichi la risorsa su cui eseguire la query, gli attributi della risorsa e le metriche sulle prestazioni da recuperare, i predicati da utilizzare per filtrare la richiesta e i segmenti da utilizzare per suddividere ulteriormente le statistiche sulle prestazioni. Per ulteriori informazioni, consulta Creazione di report di ricerca e Linguaggio di query di Search Ads 360.- Servizio sul campo
SearchAds360FieldService
recupera i metadati sulle risorse, ad esempio gli attributi disponibili per una risorsa e il relativo tipo di dati. Puoi richiedere il catalogo per risorse, campi delle risorse, chiavi di segmentazione e metriche disponibili nei metodi di ricerca diSearchAds360Service
. Per scoprire di più, consulta Recuperare i metadati delle risorse.- Servizi specifici delle entità
Questi servizi forniscono un metodo di richiesta
GET
che recupera una singola istanza di risorsa. È utile per esaminare la struttura di una risorsa.Esempi di servizi specifici per entità includono:
- CustomColumnService che restituisce la colonna personalizzata richiesta nei dettagli.