Struttura dell'API di reporting di Search Ads 360

I componenti principali dell'API Search Ads 360 Reporting sono le risorse e i servizi. Una risorsa rappresenta un'entità Search Ads 360 e utilizzi un servizio per recuperare le entità 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.

• Ogni account contiene una o più campagne attive campagne.

• Ogni Campaign contiene uno o più gruppi di annunci che raggruppano gli annunci in raccolte logiche.

• Ogni AdGroup contiene uno o più annunci del gruppo di annunci.

• Puoi allegare uno o più AdGroupCriterion o CampaignCriterion a un gruppo di annunci o campagna. I criteri definiscono la modalità di attivazione degli annunci.

  • Esistono molti tipi di criteri, ad esempio parole chiave, fasce d'età e località. I criteri definiti a livello di campagna influiscono su tutte le altre risorse all'interno della campagna. Puoi anche specificare budget e date a livello di campagna.

Risorse

Le risorse rappresentano le entità nel tuo account Search Ads 360. Esempi di risorse includono Customer, Campaign e AdGroup.

ID oggetto

Ogni oggetto in Search Ads 360 è identificato dal proprio ID. Alcuni ID sono univoci a livello globale, ovvero in tutti gli account Search Ads 360, mentre altri sono univoci solo all'interno di un ambito limitato.

Queste regole per gli ID possono essere utili per progettare l'archiviazione locale degli oggetti 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 di hotel o un annuncio locale. Puoi accedere al valore del tipo tramite il AdGroupAd.ad.type campo. Il valore viene restituito nell' AdType enumerazione.

Nomi delle risorse

Ogni risorsa è identificata in modo univoco da una stringa resource_name che concatena la risorsa e i relativi genitori 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 il seguente 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:

Servizio di ricerca

SearchAds360Service è il servizio unico e unificato per recuperare tutti gli oggetti risorsa e le statistiche sul rendimento. Fornisce due metodi: Search e SearchStream. Entrambi i metodi richiedono una query che specifichi la risorsa su cui eseguire la query, gli attributi della risorsa e le metriche sul rendimento da recuperare, i predicati da utilizzare per filtrare la richiesta e i segmenti da utilizzare per suddividere ulteriormente le statistiche sul rendimento. Per ulteriori informazioni, consulta Creare report di ricerca e Linguaggio di query di Search Ads 360.

Servizio di 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 risorsa, chiavi di segmentazione e metriche disponibili nei metodi di ricerca SearchAds360Service. Per saperne di più, consulta Recuperare i metadati delle risorse.

Servizi specifici per 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 in tutti i dettagli.