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.

  • 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 associare uno o più AdGroupCriterion o CampaignCriterion a un gruppo di annunci o a una 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 in un ambito limitato.

Ambito di unicità 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 criterio gruppo di annunci Gruppo di annunci

Ogni coppia AdGroupId / CriterionId è univoca a livello globale.
ID CampaignCriterion Campagna

Ogni coppia CampaignId / CriterionId è univoca a livello globale.
Estensioni annuncio Campagna

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 per progettare lo spazio di archiviazione locale per gli 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 descrive i relativi 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'enum AdType.

Nomi delle risorse

Ogni risorsa è identificata in modo univoco da una stringa resource_name che concatena la risorsa e i relativi elementi principali 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 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 unificato singolo per il recupero di tutti gli oggetti delle risorse e delle 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 saperne di più, consulta Creare report sulla rete di ricerca e Lingua 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 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.
Servizi specifici per entità

Questi servizi forniscono un metodo di richiesta GET che recupera una singola istanza di risorsa. Questo è utile per esaminare la struttura di una risorsa.

Esempi di servizi specifici per entità includono: