Il modello da Google Ads a BigQuery è una pipeline batch che legge i report di Google Ads e scrive in BigQuery.
Requisiti della pipeline
- Gli ID account Google Ads da utilizzare.
- La query nel linguaggio di query di Google Ads per ottenere i dati.
- Credenziali OAuth per l'API Google Ads.
Parametri del modello
Parametro | Descrizione |
---|---|
customerIds |
Un elenco di ID account Google Ads da utilizzare per eseguire la query. Ad esempio: 12345,67890 . |
query |
La query da utilizzare per ottenere i dati. Vedi Linguaggio di query di Google Ads. Ad esempio: SELECT campaign.id, campaign.name FROM campaign . |
qpsPerWorker |
La frequenza di richieste di query al secondo (QPS) da inviare a Google Ads. Dividi il valore QPS della pipeline desiderato per il numero massimo di worker. Evita di superare i limiti di token per account o sviluppatore. Consulta Limiti di frequenza. |
googleAdsClientId |
L'ID client OAuth 2.0 che identifica l'applicazione. Vedi Creare un ID client e un client secret. |
googleAdsClientSecret |
Il client secret OAuth 2.0 che corrisponde all'ID client specificato. Vedi Creare un ID client e un client secret. |
googleAdsRefreshToken |
Il token di aggiornamento OAuth 2.0 da utilizzare per la connessione all'API Google Ads. Vedi Verifica in due passaggi. |
googleAdsDeveloperToken |
Il token sviluppatore Google Ads da utilizzare per la connessione all'API Google Ads. Vedi Ottenere un token sviluppatore. |
outputTableSpec |
La posizione della tabella BigQuery in cui scrivere l'output. Il nome deve essere nel formato
<project>:<dataset>.<table_name> . Lo schema della tabella deve corrispondere agli oggetti di input. |
loginCustomerId |
(Facoltativo) Un ID account amministratore Google Ads da utilizzare per accedere agli ID account. Ad esempio: 12345 . |
bigQueryTableSchemaPath |
(Facoltativo) Percorso Cloud Storage del file JSON dello schema BigQuery. Se questo valore non viene impostato, lo schema viene dedotto dallo schema Proto. Ad esempio: gs://MyBucket/bq_schema.json . |
writeDisposition |
(Facoltativo) Il valore BigQuery WriteDisposition . Ad esempio, WRITE_APPEND , WRITE_EMPTY o WRITE_TRUNCATE . Il valore predefinito è:
WRITE_APPEND . |
createDisposition |
(Facoltativo) Il valore BigQuery CreateDisposition . Ad esempio, CREATE_IF_NEEDED , CREATE_NEVER . Il valore predefinito è:
CREATE_IF_NEEDED . |
Esegui il modello
Console
- Vai alla pagina Crea job da modello di Dataflow. Vai a Crea job da modello
- Nel campo Nome job, inserisci un nome univoco per il job.
- (Facoltativo) Per Endpoint a livello di regione, seleziona un valore dal menu a discesa. La regione predefinita è
us-central1
.Per un elenco delle regioni in cui puoi eseguire un job Dataflow, vedi Località Dataflow.
- Nel menu a discesa Modello Dataflow, seleziona the Google Ads to BigQuery template.
- Nei campi dei parametri forniti, inserisci i valori dei parametri.
- Fai clic su Esegui job.
gcloud
Nella shell o nel terminale, esegui il modello:
gcloud dataflow flex-template run JOB_NAME \ --template-file-gcs-location=gs://dataflow-templates-REGION_NAME/VERSION/flex/Google_Ads_to_BigQuery \ --project=PROJECT_ID \ --region=REGION_NAME \ --parameters \ customerIds=CUSTOMER_IDS,\ query=QUERY,\ qpsPerWorker=QPS_PER_WORKER,\ googleAdsClientId=GOOGLE_ADS_CLIENT_ID,\ googleAdsClientSecret=GOOGLE_ADS_CLIENT_SECRET,\ googleAdsRefreshToken=GOOGLE_ADS_REFRESH_TOKEN,\ googleAdsDeveloperToken=GOOGLE_ADS_DEVELOPER_TOKEN,\ outputTableSpec=OUTPUT_TABLE_SPEC,\
Sostituisci quanto segue:
JOB_NAME
: un nome job univoco a tua sceltaVERSION
: la versione del modello che vuoi utilizzarePuoi utilizzare i seguenti valori:
latest
per utilizzare la versione più recente del modello, disponibile nella cartella padre senza data del bucket: gs://dataflow-templates-REGION_NAME/latest/- il nome della versione, come
2023-09-12-00_RC00
, per utilizzare una versione specifica del modello, che si trova nidificata nella rispettiva cartella padre con data all'interno del bucket: gs://dataflow-templates-REGION_NAME/
REGION_NAME
: la regione in cui vuoi eseguire il deployment del job Dataflow, ad esempious-central1
CUSTOMER_IDS
: gli ID account Google AdsQUERY
: la query nel linguaggio di query di Google AdsQPS_PER_WORKER
: il tasso di richieste Google Ads richiesto per workerGOOGLE_ADS_CLIENT_ID
: l'ID client OAuth 2.0 che identifica l'applicazioneGOOGLE_ADS_CLIENT_SECRET
: il client secret OAuth 2.0 che corrisponde all'ID client specificatoGOOGLE_ADS_REFRESH_TOKEN
: il token di aggiornamento OAuth 2.0 da utilizzare per la connessione all'API Google Ads.GOOGLE_ADS_DEVELOPER_TOKEN
: il token sviluppatore Google Ads da utilizzare per la connessione all'API Google Ads.OUTPUT_TABLE_SPEC
: la tabella di output di BigQuery
API
Per eseguire il modello utilizzando l'API REST, invia una richiesta POST HTTP. Per maggiori informazioni sull'API e sui relativi ambiti di autorizzazione, consulta projects.templates.launch
.
POST https://dataflow.googleapis.com/v1b3/projects/PROJECT_ID/locations/LOCATION/flexTemplates:launch { "launchParameter": { "jobName": "JOB_NAME", "parameters": { "customerIds": "CUSTOMER_IDS", "query": "QUERY", "qpsPerWorker": "QPS_PER_WORKER", "googleAdsClientId": "GOOGLE_ADS_CLIENT_ID", "googleAdsClientSecret": "GOOGLE_ADS_CLIENT_SECRET", "googleAdsRefreshToken": "GOOGLE_ADS_REFRESH_TOKEN", "googleAdsDeveloperToken": "GOOGLE_ADS_DEVELOPER_TOKEN", "outputTableSpec": "OUTPUT_TABLE_SPEC", }, "containerSpecGcsPath": "gs://dataflow-templates-LOCATION/VERSION/flex/Google_Ads_to_BigQuery", "environment": { "maxWorkers": "10" } } }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google Cloud in cui vuoi eseguire il job DataflowJOB_NAME
: un nome job univoco a tua sceltaVERSION
: la versione del modello che vuoi utilizzarePuoi utilizzare i seguenti valori:
latest
per utilizzare la versione più recente del modello, disponibile nella cartella padre senza data del bucket: gs://dataflow-templates-REGION_NAME/latest/- il nome della versione, come
2023-09-12-00_RC00
, per utilizzare una versione specifica del modello, che si trova nidificata nella rispettiva cartella padre con data all'interno del bucket: gs://dataflow-templates-REGION_NAME/
LOCATION
: la regione in cui vuoi eseguire il deployment del job Dataflow, ad esempious-central1
CUSTOMER_IDS
: gli ID account Google AdsQUERY
: la query nel linguaggio di query di Google AdsQPS_PER_WORKER
: il tasso di richieste Google Ads richiesto per workerGOOGLE_ADS_CLIENT_ID
: l'ID client OAuth 2.0 che identifica l'applicazioneGOOGLE_ADS_CLIENT_SECRET
: il client secret OAuth 2.0 che corrisponde all'ID client specificatoGOOGLE_ADS_REFRESH_TOKEN
: il token di aggiornamento OAuth 2.0 da utilizzare per la connessione all'API Google Ads.GOOGLE_ADS_DEVELOPER_TOKEN
: il token sviluppatore Google Ads da utilizzare per la connessione all'API Google Ads.OUTPUT_TABLE_SPEC
: la tabella di output di BigQuery
Passaggi successivi
- Scopri di più sui modelli Dataflow.
- Consulta l'elenco dei modelli forniti da Google.