Il linguaggio di query di Google Ads può eseguire query all'API Google Ads per
- Risorse e relativi attributi, segmenti e metriche che utilizzano
GoogleAdsService
Ricerca o SearchStream- Il risultato di una query GoogleAdsService è un elenco di
GoogleAdsRow
istanze, con ogniGoogleAdsRow
che rappresentano una risorsa. Se vengono richiesti attributi o metriche, include anche questi campi. Se vengono richiesti segmenti, mostra anche una riga aggiuntiva per ogni tupla segmento-risorsa. - Metadati sui campi e sulle risorse disponibili in
GoogleAdsFieldService
Questo servizio offre un catalogo di campi interrogabili con specifiche su la compatibilità e il tipo.
Il risultato di una query
GoogleAdsFieldService
è un elenco diGoogleAdsField
di istanze, ciascunaGoogleAdsField
con i dettagli sul campo richiesto.
Esecuzione di query sugli attributi di una risorsa
Di seguito è riportata una query di base per gli attributi della risorsa campagna, che illustra come per restituire l'ID, il nome e lo stato della campagna:
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
Questa query ordina per ID campagna. Ogni GoogleAdsRow
risultante rappresenta
un oggetto campaign
compilato con i campi selezionati (inclusi quelli specificati
resource_name
della campagna).
Per scoprire quali altri campi sono disponibili per le query della campagna, consulta il
documentazione di riferimento di Campaign
.
Esecuzione di query sulle metriche
Oltre agli attributi selezionati per una determinata risorsa, puoi anche eseguire query metriche correlate:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
Questa query filtra solo le campagne con stato PAUSED
e
hanno registrato più di 1000 impressioni mentre vengono ordinati per ID campagna. Ciascuna
il valore GoogleAdsRow
risultante avrà un campo metrics
compilato con
metriche selezionate.
Per un elenco delle metriche su cui è possibile eseguire query, consulta la Metrics
documentazione.
Esecuzione di query sui segmenti
Oltre agli attributi selezionati per una determinata risorsa, puoi anche eseguire query segmenti correlati:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
Analogamente alle query sulle metriche, questa query filtra solo le campagne che
presentano lo stato PAUSED
e hanno ricevuto più di 1000 impressioni; ma
questa query segmenta i dati per data. Questo porta a ogni risultato
GoogleAdsRow
che rappresenta una tupla di una campagna e la data Segment
. È
è importante notare che la segmentazione suddivide le metriche selezionate, raggruppando
nella clausola SELECT.
Per un elenco dei segmenti interrogabili, consulta il Segments
documentazione.
Esecuzione di query sugli attributi di una risorsa correlata
In una query per una determinata risorsa, potresti essere in grado di eseguire il join con altre se disponibili. Queste risorse correlate sono note come "attribuite risorse". Puoi eseguire un join con risorse attribuite in modo implicito selezionando un nella tua query.
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
Questa query non solo seleziona gli attributi della campagna, ma estrae anche le
attributi di ogni campagna selezionata. Ogni elemento GoogleAdsRow
risultante rappresenta
un oggetto campaign
completato con gli attributi della campagna selezionati e
l'attributo della strategia di offerta selezionato: bidding_strategy.name
.
Per scoprire quali risorse attribuite sono disponibili per le query delle campagne,
consulta la documentazione di riferimento di Campaign
.
Variazione in base ai risultati della query
Quando esegui una query per una determinata risorsa, puoi prendere immediatamente quelle restituite come oggetti, modificarli e inviarli al metodo mutate in di Google Cloud. Di seguito è riportato un flusso di lavoro di esempio:
- Esegui una query per tutte le campagne attualmente
PAUSED
e che hanno impressioni superiori a 1000. - Recupera l'oggetto
Campaign
dal campocampaign
di ogniGoogleAdsRow
in la risposta. - Modifica lo stato di ogni campagna da
PAUSED
aENABLED
. - Chiama il numero
CampaignService.MutateCampaigns
con le campagne modificate per aggiornarle.
Metadati dei campi
Le query inviate a GoogleAdsFieldService
sono concepite per recuperare i metadati dei campi.
Queste informazioni possono essere utilizzate per comprendere come i campi possono essere utilizzati insieme
in una query. Poiché i dati sono disponibili dall'API e forniscono i necessari
metadati necessari per convalidare o creare una query, questo consente agli sviluppatori
in modo programmatico. Ecco un
tipica query sui metadati:
SELECT
name,
category,
selectable,
filterable,
sortable,
selectable_with,
data_type,
is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"
Puoi sostituire <INSERT_RESOURCE_OR_FIELD>
in questa query con un
risorsa (ad es. customer
o campaign
) o campo (ad es. campaign.id
,
metrics.impressions
o ad_group.id
).
Per un elenco dei campi interrogabili, consulta il GoogleAdsField
documentazione.
Esempi di codice
Le librerie client contengono esempi di utilizzo dei
Linguaggio di query Google Ads in GoogleAdsService
. La cartella operazioni di base contiene
esempi come GetCampaigns
, GetKeywords
e SearchForGoogleAdsFields
.
La cartella reporting ha un esempio di GetKeywordStats
.