Halaman ini diterjemahkan oleh Cloud Translation API.

Integrasi dengan Google Ads

Halaman ini menjelaskan konfigurasi yang diperlukan untuk mengambil data dari Google Ads sebagai sumber data beban kerja pemasaran Cortex Framework Data Foundation.

Google Ads adalah platform periklanan online yang memungkinkan bisnis mengiklankan produk atau layanan mereka di berbagai properti Google. Framework Cortex menggabungkan data Google Ads Anda dengan saluran pemasaran lainnya, menganalisisnya secara komprehensif, dan menggunakan AI untuk meningkatkan hasil kampanye Anda.

Diagram berikut menjelaskan cara data Google Ads tersedia melalui beban kerja pemasaran Cortex Framework Data Foundation:

Sumber data Google Ads

Gambar 1. Sumber data Google Ads.

File konfigurasi

File config.json mengonfigurasi setelan yang diperlukan untuk mentransfer data dari sumber data apa pun, termasuk Google Ads. File ini berisi parameter berikut untuk Google Ads:

  "marketing": {
          "deployGoogleAds": true,
          "GoogleAds": {
              "deployCDC": true,
              "lookbackDays": 180,
              "datasets": {
                  "cdc": "",
                  "raw": "",
                  "reporting": "REPORTING_GoogleAds"
                    }
                  }
                 }

Tabel berikut menjelaskan nilai untuk setiap parameter pemasaran Google Ads:

Parameter	Arti	Nilai Default	Deskripsi
`marketing.deployGoogleAds`	Men-deploy Google Ads	`true`	Jalankan deployment untuk sumber data Google Ads.
`marketing.GoogleAds.deployCDC`	Men-deploy CDC untuk Google Ads	`true`	Buat skrip pemrosesan CDC Google Ads untuk dijalankan sebagai DAG di Cloud Composer.
`marketing.GoogleAds.lookbackDays`	Hari lihat balik untuk Google Ads	`180`	Jumlah hari untuk mulai mengambil data dari Google Ads API.
`marketing.GoogleAds.datasets.cdc`	Set data CDC untuk Google Ads		Set data CDC untuk Google Ads.
`marketing.GoogleAds.datasets.raw`	Set data mentah untuk Google Ads		Set data mentah untuk Google Ads.
`marketing.GoogleAds.datasets.reporting`	Set data pelaporan untuk Google Ads	`"REPORTING_GoogleAds"`	Set data pelaporan untuk Google Ads.

Model Data

Bagian ini menjelaskan Model Data Google Ads menggunakan Diagram Hubungan Entitas (ERD).

Gambar 2. Google Ads: Diagram Hubungan Entitas.

Tampilan dasar

Ini adalah objek biru di ERD dan merupakan tampilan pada tabel CDC tanpa transformasi selain beberapa alias nama kolom. Lihat skrip di src/marketing/src/GoogleAds/src/reporting/ddls.

Tampilan pelaporan

Ini adalah objek hijau di ERD dan merupakan tampilan pelaporan yang berisi metrik gabungan. Lihat skrip di src/marketing/src/GoogleAds/src/reporting/ddls.

Koneksi API

Template penyerapan Cortex Framework menggunakan Google Ads API untuk mengambil atribut dan metrik pelaporan dari Google Ads. Template Cortex Framework saat ini menggunakan Google Ads API versi 17.1. Pertimbangkan batasan Google Ads API:

Operasi akses dasar per hari: 15.000 (permintaan yang di-paging yang berisi next_page_token yang valid tidak dihitung).
Ukuran halaman maksimum: 10.000 baris per halaman.
Parameter default yang direkomendasikan: Ukuran halaman sama dengan 10.000 baris per halaman.

Untuk informasi selengkapnya tentang koneksi API, lihat dokumentasi Google Ads API..

Autentikasi akun

Ikuti langkah-langkah berikut untuk menyiapkan autentikasi akun:

Di konsol Google Cloud, klik Navigation menu > API & Services > Credentials > Create credentials.
Buat kredensial Client ID OAuth dengan karakteristik berikut. Untuk informasi selengkapnya, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.
```
Application type: "Web Application"
Name: CHOSEN_NAME #(For example,"Cortex Authentication Client").
Authorized redirect URIs: http://127.0.0.1
```
Ganti CHOSEN_NAME dengan nama yang dipilih untuk akun kredensial Client ID OAuth.
Simpan Client ID dan Client secret setelah kredensial dikonfigurasi. Anda akan memerlukannya nanti.
Buat token baru menggunakan OAuth 2.0 Access Google API. Cortex Data Foundation otomatis mendeteksi dan menyerap data dari semua pelanggan (akun) yang dapat diakses oleh kredensial yang digunakan untuk membuat token.
Buat secret menggunakan Secret Manager:
- Di konsol Google Cloud, klik Secret Manager.
- Buat secret bernama cortex-framework-google-ads-yaml menggunakan format berikut dan ubah nilai sesuai dengan setelan Anda:
```
{"developer_token": "DEVELOPER_TOKEN_VALUE", "refresh_token": "REFRESH_TOKEN_VALUE", "client_id": "CLIENT_ID_VALUE", "client_secret": "CLIENT_SECRET_VALUE", "use_proto_plus": False}
```

Ganti kode berikut:

DEVELOPER_TOKEN_VALUE dengan nilai token developer yang tersedia di akun Google Ads.
REFRESH_TOKEN_VALUE dengan nilai token refresh yang diperoleh pada langkah 4.
CLIENT_ID_VALUE dengan nilai client ID yang diperoleh dalam penyiapan OAuth di langkah 2.
CLIENT_SECRET_VALUE dengan nilai secret klien yang diperoleh dari penyiapan OAuth di langkah 2.

Keaktualan dan Penundaan Data

Sebagai aturan umum, keaktualan data untuk sumber data Cortex Framework dibatasi oleh apa yang diizinkan oleh koneksi upstream, serta frekuensi eksekusi DAG Anda. Sesuaikan frekuensi eksekusi DAG agar selaras dengan frekuensi upstream, batasan resource, dan kebutuhan bisnis Anda.

Data yang diambil menggunakan Google Ads API umumnya tersedia dengan latensi lebih dari 3 jam. Setelah itu, nilai tersebut dapat disesuaikan karena konversi dan deteksi traffic tidak valid. Untuk informasi selengkapnya, lihat artikel Tentang keaktualan data berikut di Pusat Bantuan Google Ads.

Izin koneksi Cloud Composer

Buat koneksi berikut di Cloud Composer. Lihat detail selengkapnya di dokumentasi Mengelola koneksi Airflow.

Nama Koneksi	Tujuan
`googleads_raw_dataflow`	Untuk Google Ads API > BigQuery Raw Dataset.
`googleads_cdc_bq`	Untuk Set data mentah > Transfer set data CDC.
`googleads_reporting_bq`	Untuk set data CDC > Transfer set data pelaporan.

Izin akun layanan Cloud Composer

Berikan izin Dataflow ke akun layanan yang digunakan di Cloud Composer (seperti yang dikonfigurasi dalam koneksi googleads_raw_dataflow). Lihat petunjuk di dokumentasi Dataflow.

Setelan proses transfer

Kontrol pipeline data Source to Raw dan Raw to CDC melalui setelan dalam file src/GoogleAds/config/ingestion_settings.yaml. Bagian ini menjelaskan parameter setiap pipeline data.

Sumber ke tabel mentah

Bagian ini menjelaskan entity yang diambil oleh API dan caranya. Setiap entri sesuai dengan satu entitas Google Ads. Berdasarkan konfigurasi ini, Cortex membuat DAG Airflow yang menjalankan pipeline Dataflow untuk mengambil data menggunakan Google Ads API.

Parameter berikut mengontrol setelan untuk Source to Raw untuk setiap entri:

Parameter	Deskripsi
`load_frequency`	Seberapa sering DAG untuk entity ini berjalan untuk mengambil data dari Google Ads. Untuk mengetahui informasi selengkapnya tentang kemungkinan nilai, lihat dokumentasi Airflow.
`api_name`	Nama Resource API (misalnya, `customer`).
`table_name`	Tabel dalam set data Mentah tempat data yang diambil disimpan (misalnya, `customer`).
`schema_file`	File skema di direktori `src/table_schema` yang memetakan kolom respons API ke nama kolom tabel tujuan.
`key`	Kolom (dipisahkan koma) yang membentuk data unik untuk tabel ini.
`is_metrics_table`	Menunjukkan apakah entri tertentu ditujukan untuk entitas metrik (di Google Ads API). Sistem memperlakukan tabel tersebut sedikit berbeda karena sifat gabungan tabel tersebut.
`partition_details`	Opsional: Jika Anda ingin tabel ini dipartisi untuk pertimbangan performa. Untuk mengetahui informasi selengkapnya, lihat Partisi Tabel.
`cluster_details`	Opsional: Jika Anda ingin tabel ini dikelompokkan untuk pertimbangan performa. Untuk informasi selengkapnya, lihat Setelan Cluster.

Tabel mentah ke CDC

Bagian ini menjelaskan entri yang mengontrol cara data dipindahkan dari tabel mentah ke tabel CDC. Setiap entri sesuai dengan tabel mentah (yang pada gilirannya sesuai dengan entity Google Ads API seperti yang disebutkan).

Parameter berikut mengontrol setelan untuk Raw to CDC untuk setiap entri:

Parameter	Deskripsi
`table_name`	Tabel dalam set data CDC tempat data mentah setelah transformasi CDC disimpan (misalnya, `customer`).
`raw_table`	Tabel tempat data mentah telah direplikasi.
`key`	Kolom (dipisahkan koma) yang membentuk data unik untuk tabel ini.
`load_frequency`	Seberapa sering DAG untuk entity ini berjalan untuk mengisi tabel CDC. Untuk mengetahui informasi selengkapnya tentang kemungkinan nilai, lihat dokumentasi Airflow.
`schema_file`	File skema di direktori `src/table_schema` yang memetakan kolom mentah ke kolom CDC dan jenis data kolom CDC. Ini adalah file skema yang sama dengan yang dirujuk di bagian sebelumnya.
`partition_details`	Opsional: Jika Anda ingin tabel ini dipartisi untuk pertimbangan performa. Untuk mengetahui informasi selengkapnya, lihat Partisi Tabel.
`cluster_details`	Opsional: Jika Anda ingin tabel ini dikelompokkan untuk pertimbangan performa. Untuk mengetahui informasi selengkapnya, lihat Setelan Cluster.

Setelan pelaporan

Anda dapat mengonfigurasi dan mengontrol cara Cortex Framework membuat data untuk lapisan pelaporan akhir Google Ads menggunakan file setelan pelaporan src/GoogleAds/config/reporting_settings.yaml. File ini mengontrol cara objek BigQuery lapisan pelaporan (tabel, tampilan, fungsi, atau prosedur tersimpan) dibuat.

Untuk mengetahui informasi selengkapnya, lihat Menyesuaikan file setelan pelaporan.

Apa langkah selanjutnya?

Untuk informasi selengkapnya tentang sumber data dan workload lainnya, lihat Sumber data dan workload.
Untuk informasi selengkapnya tentang langkah-langkah deployment di lingkungan produksi, lihat Prasyarat deployment Data Foundation Framework Cortex.