Modello Google Ads a BigQuery

Il modello Google Ads to BigQuery è una pipeline batch che legge i report 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

Parametri obbligatori

Parametri facoltativi

Esegui il modello

Console

  1. Vai alla pagina Crea job da modello di Dataflow.
  2. Vai a Crea job da modello
  3. Nel campo Nome job, inserisci un nome univoco per il job.
  4. (Facoltativo) Per Endpoint a livello di regione, seleziona un valore dal menu a discesa. Il valore predefinito è us-central1.

    Per un elenco delle regioni in cui puoi eseguire un job Dataflow, consulta Località di Dataflow.

  5. Dal menu a discesa Modello Dataflow, seleziona the Google Ads to BigQuery template.
  6. Inserisci i valori parametro negli appositi campi.
  7. 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 di tua scelta
  • VERSION: la versione del modello che vuoi utilizzare

    Puoi utilizzare i seguenti valori:

  • REGION_NAME: la regione in cui vuoi di eseguire il deployment del job Dataflow, ad esempio us-central1
  • CUSTOMER_IDS: gli ID account Google Ads
  • QUERY: la query in linguaggio di query di Google Ads
  • QPS_PER_WORKER: la tariffa di richieste Google Ads richiesta per worker
  • GOOGLE_ADS_CLIENT_ID: l'ID client OAuth 2.0 che identifica l'applicazione
  • GOOGLE_ADS_CLIENT_SECRET: il client secret OAuth 2.0 che corrisponde all'ID client specificato
  • GOOGLE_ADS_REFRESH_TOKEN: il token di aggiornamento OAuth 2.0 da utilizzare per connettersi all'API Google Ads
  • GOOGLE_ADS_DEVELOPER_TOKEN: il token sviluppatore Google Ads da utilizzare per connettersi all'API Google Ads
  • OUTPUT_TABLE_SPEC: la tabella di output BigQuery

API

Per eseguire il modello utilizzando l'API REST, invia una richiesta POST HTTP. Per ulteriori informazioni sul API e i 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 progetto Google Cloud in cui vuoi eseguire il job Dataflow
  • JOB_NAME: un nome job univoco di tua scelta
  • VERSION: la versione del modello che vuoi utilizzare

    Puoi utilizzare i seguenti valori:

  • LOCATION: la regione in cui vuoi eseguire il deployment del job Dataflow, ad esempio us-central1
  • CUSTOMER_IDS: gli ID account Google Ads
  • QUERY: la query in linguaggio di query di Google Ads
  • QPS_PER_WORKER: la tariffa di richieste Google Ads richiesta per worker
  • GOOGLE_ADS_CLIENT_ID: l'ID client OAuth 2.0 che identifica l'applicazione
  • GOOGLE_ADS_CLIENT_SECRET: il client secret OAuth 2.0 che corrisponde all'ID client specificato
  • GOOGLE_ADS_REFRESH_TOKEN: il token di aggiornamento OAuth 2.0 da utilizzare per connettersi all'API Google Ads
  • GOOGLE_ADS_DEVELOPER_TOKEN: il token sviluppatore Google Ads da utilizzare per connettersi all'API Google Ads
  • OUTPUT_TABLE_SPEC: la tabella di output BigQuery

Passaggi successivi