Template Google Ads ke BigQuery

Template Google Ads ke BigQuery adalah pipeline batch yang membaca laporan Google Ads dan menulis ke BigQuery.

Persyaratan pipeline

  • ID akun Google Ads yang akan digunakan.
  • Kueri Bahasa Kueri Google Ads untuk mendapatkan data.
  • Kredensial OAuth untuk Google Ads API.

Parameter template

Parameter Deskripsi
customerIds Daftar ID akun Google Ads yang akan digunakan untuk menjalankan kueri. Misalnya: 12345,67890.
query Kueri yang akan digunakan untuk mendapatkan data. Lihat Bahasa Kueri Google Ads. Contoh: SELECT campaign.id, campaign.name FROM campaign.
qpsPerWorker Rasio permintaan kueri per detik (QPS) yang akan dikirim ke Google Ads. Bagi QPS per pipeline yang diinginkan dengan jumlah maksimum pekerja. Hindari melampaui batas token developer atau per akun. Lihat Batas Kapasitas.
googleAdsClientId Client ID OAuth 2.0 yang mengidentifikasi aplikasi. Lihat Membuat client ID dan rahasia klien.
googleAdsClientSecret Rahasia klien OAuth 2.0 yang sesuai dengan client ID yang ditentukan. Lihat Membuat client ID dan rahasia klien.
googleAdsRefreshToken Token refresh OAuth 2.0 yang akan digunakan untuk terhubung ke Google Ads API. Lihat Verifikasi 2 Langkah.
googleAdsDeveloperToken Token developer Google Ads yang akan digunakan untuk menghubungkan ke Google Ads API. Baca bagian Mendapatkan token developer.
outputTableSpec Lokasi tabel BigQuery yang akan menjadi tujuan penulisan output. Nama harus dalam format <project>:<dataset>.<table_name>. Skema tabel harus cocok dengan objek input.
loginCustomerId Opsional: ID akun pengelola Google Ads yang akan digunakan untuk mengakses ID akun. Misalnya: 12345.
bigQueryTableSchemaPath Opsional: Jalur Cloud Storage ke file JSON skema BigQuery. Jika nilai ini tidak ditetapkan, skema akan disimpulkan dari skema Proto. Misalnya: gs://MyBucket/bq_schema.json.
writeDisposition Opsional: Nilai WriteDisposition BigQuery. Misalnya, WRITE_APPEND, WRITE_EMPTY, atau WRITE_TRUNCATE. Nilai defaultnya adalah: WRITE_APPEND.
createDisposition Opsional: Nilai CreateDisposition BigQuery. Contoh, CREATE_IF_NEEDED, CREATE_NEVER. Nilai defaultnya adalah: CREATE_IF_NEEDED.

Menjalankan template

Konsol

  1. Buka halaman Create job from template Dataflow.
  2. Buka Buat tugas dari template
  3. Di kolom Job name, masukkan nama pekerjaan yang unik.
  4. Opsional: Untuk Endpoint regional, pilih nilai dari menu drop-down. Region default-nya adalah us-central1.

    Untuk daftar region tempat Anda dapat menjalankan tugas Dataflow, lihat Lokasi Dataflow.

  5. Dari menu drop-down Dataflow template, pilih the Google Ads to BigQuery template.
  6. Di kolom parameter yang disediakan, masukkan parameter value Anda.
  7. Klik Run job.

gcloud

Di shell atau terminal Anda, jalankan template:

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,\

Ganti kode berikut:

  • JOB_NAME: nama pekerjaan unik pilihan Anda
  • VERSION: versi template yang ingin Anda gunakan

    Anda dapat menggunakan nilai berikut:

  • REGION_NAME: region tempat Anda ingin men-deploy tugas Dataflow, misalnya us-central1
  • CUSTOMER_IDS: ID akun Google Ads
  • QUERY: kueri Bahasa Kueri Google Ads
  • QPS_PER_WORKER: rasio permintaan Google Ads yang diperlukan per pekerja
  • GOOGLE_ADS_CLIENT_ID: client ID OAuth 2.0 yang mengidentifikasi aplikasi
  • GOOGLE_ADS_CLIENT_SECRET: rahasia klien OAuth 2.0 yang sesuai dengan client ID tertentu
  • GOOGLE_ADS_REFRESH_TOKEN: token pembaruan OAuth 2.0 yang akan digunakan untuk terhubung ke Google Ads API
  • GOOGLE_ADS_DEVELOPER_TOKEN: token developer Google Ads yang akan digunakan untuk menghubungkan ke Google Ads API
  • OUTPUT_TABLE_SPEC: tabel output BigQuery

API

Untuk menjalankan template menggunakan REST API, kirim permintaan HTTP POST. Untuk informasi selengkapnya tentang API dan cakupan otorisasinya, lihat 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" }
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud tempat Anda ingin menjalankan tugas Dataflow
  • JOB_NAME: nama pekerjaan unik pilihan Anda
  • VERSION: versi template yang ingin Anda gunakan

    Anda dapat menggunakan nilai berikut:

  • LOCATION: region tempat Anda ingin men-deploy tugas Dataflow, misalnya us-central1
  • CUSTOMER_IDS: ID akun Google Ads
  • QUERY: kueri Bahasa Kueri Google Ads
  • QPS_PER_WORKER: rasio permintaan Google Ads yang diperlukan per pekerja
  • GOOGLE_ADS_CLIENT_ID: client ID OAuth 2.0 yang mengidentifikasi aplikasi
  • GOOGLE_ADS_CLIENT_SECRET: rahasia klien OAuth 2.0 yang sesuai dengan client ID tertentu
  • GOOGLE_ADS_REFRESH_TOKEN: token pembaruan OAuth 2.0 yang akan digunakan untuk terhubung ke Google Ads API
  • GOOGLE_ADS_DEVELOPER_TOKEN: token developer Google Ads yang akan digunakan untuk menghubungkan ke Google Ads API
  • OUTPUT_TABLE_SPEC: tabel output BigQuery

Langkah selanjutnya