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 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 o CampaignCriterion 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 annunci

Ogni coppia AdGroupId / AdId è univoca a livello globale.
ID criteri del gruppo di annunci Gruppo di annunci

Ogni 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 e SearchStream. 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 di SearchAds360Service. 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: