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
- Buka halaman Create job from template Dataflow. Buka Buat tugas dari template
- Di kolom Job name, masukkan nama pekerjaan yang unik.
- 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.
- Dari menu drop-down Dataflow template, pilih the Google Ads to BigQuery template.
- Di kolom parameter yang disediakan, masukkan parameter value Anda.
- 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 AndaVERSION
: versi template yang ingin Anda gunakanAnda dapat menggunakan nilai berikut:
latest
untuk menggunakan versi terbaru template, yang tersedia di folder induk tidak bertanggal di bucket— gs://dataflow-templates-REGION_NAME/latest/- nama versi, seperti
2023-09-12-00_RC00
, untuk menggunakan versi template tertentu, yang dapat ditemukan bertingkat di folder induk bertanggal masing-masing dalam bucket— gs://dataflow-templates-REGION_NAME/
REGION_NAME
: region tempat Anda ingin men-deploy tugas Dataflow, misalnyaus-central1
CUSTOMER_IDS
: ID akun Google AdsQUERY
: kueri Bahasa Kueri Google AdsQPS_PER_WORKER
: rasio permintaan Google Ads yang diperlukan per pekerjaGOOGLE_ADS_CLIENT_ID
: client ID OAuth 2.0 yang mengidentifikasi aplikasiGOOGLE_ADS_CLIENT_SECRET
: rahasia klien OAuth 2.0 yang sesuai dengan client ID tertentuGOOGLE_ADS_REFRESH_TOKEN
: token pembaruan OAuth 2.0 yang akan digunakan untuk terhubung ke Google Ads APIGOOGLE_ADS_DEVELOPER_TOKEN
: token developer Google Ads yang akan digunakan untuk menghubungkan ke Google Ads APIOUTPUT_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 DataflowJOB_NAME
: nama pekerjaan unik pilihan AndaVERSION
: versi template yang ingin Anda gunakanAnda dapat menggunakan nilai berikut:
latest
untuk menggunakan versi terbaru template, yang tersedia di folder induk tidak bertanggal di bucket— gs://dataflow-templates-REGION_NAME/latest/- nama versi, seperti
2023-09-12-00_RC00
, untuk menggunakan versi template tertentu, yang dapat ditemukan bertingkat di folder induk bertanggal masing-masing dalam bucket— gs://dataflow-templates-REGION_NAME/
LOCATION
: region tempat Anda ingin men-deploy tugas Dataflow, misalnyaus-central1
CUSTOMER_IDS
: ID akun Google AdsQUERY
: kueri Bahasa Kueri Google AdsQPS_PER_WORKER
: rasio permintaan Google Ads yang diperlukan per pekerjaGOOGLE_ADS_CLIENT_ID
: client ID OAuth 2.0 yang mengidentifikasi aplikasiGOOGLE_ADS_CLIENT_SECRET
: rahasia klien OAuth 2.0 yang sesuai dengan client ID tertentuGOOGLE_ADS_REFRESH_TOKEN
: token pembaruan OAuth 2.0 yang akan digunakan untuk terhubung ke Google Ads APIGOOGLE_ADS_DEVELOPER_TOKEN
: token developer Google Ads yang akan digunakan untuk menghubungkan ke Google Ads APIOUTPUT_TABLE_SPEC
: tabel output BigQuery
Langkah selanjutnya
- Pelajari Template Dataflow.
- Lihat daftar template yang disediakan Google.