I componenti principali dell'API Search Ads 360 Reporting sono risorse e 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 collegare uno o più
AdGroupCriterion
oCampaignCriterion
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 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 annunciOgni coppia AdGroupId / AdId è univoca a livello globale. |
ID criterio gruppo di annunci | Gruppo di annunciOgni coppia AdGroupId / CriterionId è univoca a livello globale. |
ID CampaignCriterion | CampagnaOgni coppia CampaignId / CriterionId è univoca a livello globale. |
Estensioni annuncio | CampagnaOgni coppia CampaignId / AdExtensionId è unica a livello globale. |
ID feed | Globale |
ID elemento del feed | Globale |
ID attributo del 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
è l'unico servizio unificato per il recupero di tutti gli oggetti delle risorse e le statistiche sulle prestazioni. Fornisce due metodi:Search
eSearchStream
. Entrambi i metodi richiedono una query che specifica la risorsa su cui eseguire la query, gli attributi della risorsa e le metriche delle prestazioni da recuperare, i predicati da utilizzare per filtrare la richiesta e i segmenti da utilizzare per analizzare ulteriormente le statistiche sulle prestazioni. Per saperne di più, consulta Creare report sulla rete di ricerca e Language di query 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 al catalogo risorse, campi delle risorse, chiavi di segmentazione e metriche disponibili nei metodi di ricercaSearchAds360Service
. Per saperne di più, consulta la sezione 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:
- CustomColumnService che restituisce la colonna personalizzata richiesta in dettaglio.