Menyalin data dari Google Ads menggunakan Azure Data Factory atau Synapse Analytics

Azure Data Factory Azure Synapse Analytics

Petunjuk

Data Factory di Microsoft Fabric adalah generasi Azure Data Factory berikutnya, dengan arsitektur yang lebih sederhana, AI bawaan, dan fitur baru. Jika Anda baru menggunakan integrasi data, mulailah dengan Fabric Data Factory. Beban kerja ADF yang ada dapat ditingkatkan ke Fabric untuk mengakses kemampuan baru di seluruh ilmu data, analitik real time, dan pelaporan.

Artikel ini menguraikan cara menggunakan Aktivitas Salin di alur Azure Data Factory atau Synapse Analytics untuk menyalin data dari Google Ads. Artikel tersebut dibuat berdasarkan artikel gambaran umum aktivitas salin yang menyajikan gambaran umum aktivitas salin.

Penting

Harap tingkatkan versi driver Google Ads Anda sebelum 18 Februari 2024. Jika tidak, koneksi akan mulai gagal dengan kesalahan karena penghentian driver lama.

Kemampuan yang didukung

Konektor Google Ads ini didukung untuk kemampuan berikut:

Kemampuan yang didukung	IR
Aktivitas menyalin (sumber/-)	(1) (2)
Aktivitas pencarian	(1) (2)

(1) Azure runtime integrasi (2) Runtime integrasi yang dihost sendiri

Untuk daftar penyimpanan data yang didukung sebagai sumber/sink, lihat tabel Penyimpanan data yang didukung.

Layanan ini menyediakan driver bawaan untuk mengaktifkan konektivitas, oleh karena itu Anda tidak perlu memasang driver apa pun secara manual menggunakan konektor ini.

Memulai

Untuk melakukan aktivitas salin dengan alur, Anda dapat menggunakan salah satu alat atau SDK berikut:

Membuat layanan tertaut ke Google Ads menggunakan UI

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke Google Ads di UI portal Azure.

Telusuri ke tab Kelola di ruang kerja Azure Data Factory atau Synapse Anda dan pilih Layanan Tertaut, lalu klik Baru:
- Azure Data Factory
- Azure Synapse
Telusuri Google Ads dan pilih konektor Google Ads.
Konfigurasikan detail layanan, uji koneksi, dan buat layanan tertaut baru.

Detail konfigurasi konektor

Bagian berikut memberikan detail tentang properti yang digunakan untuk menentukan entitas Data Factory khusus untuk konektor Google Ads.

Properti layanan terhubung

Properti berikut ini didukung untuk layanan tertaut Google Ads:

Properti	Deskripsi	Wajib
jenis	Properti jenis harus diatur ke: GoogleAdWords	Ya
googleAdsApiVersion	Versi GOOGLE Ads API yang Anda gunakan saat memilih versi driver yang direkomendasikan. Anda dapat merujuk artikel ini untuk informasi versi API.	Ya
clientCustomerID	ID pelanggan klien dari akun Ads yang ingin Anda ambil data laporannya.	Ya
IDPelangganMasuk	ID pelanggan akun manajer Google Ads tempat Anda ingin mengambil data laporan pelanggan tertentu.	Tidak
developerToken	Token pengembang yang terkait dengan akun manajer yang Anda gunakan untuk memberikan akses ke ADS API. Anda dapat memilih untuk menandai kolom ini sebagai SecureString untuk menyimpannya dengan aman, atau menyimpan kata sandi di Azure Key Vault dan membiarkan aktivitas penyalinan mengambil dari sana saat menyalin data - pelajari lebih lanjut di Menyimpan Kredensial di Key Vault.	Ya
jenisOtentikasi	Mekanisme autentikasi OAuth 2.0 yang digunakan untuk autentikasi. Nilai yang diizinkan adalah: ServiceAuthentication, UserAuthentication. ServiceAuthentication hanya dapat digunakan pada IR yang dihost sendiri.	Ya
Untuk UserAuthentication:
refreshToken	Token refresh diperoleh dari Google untuk mengotorisasi akses ke Ads for UserAuthentication. Anda dapat memilih untuk menandai kolom ini sebagai SecureString untuk menyimpannya dengan aman, atau menyimpan kata sandi di Azure Key Vault dan membiarkan aktivitas penyalinan mengambil dari sana saat menyalin data - pelajari lebih lanjut di Menyimpan Kredensial di Key Vault.	Tidak
clientId	ID klien aplikasi Google yang digunakan untuk memperoleh token refresh. Anda dapat memilih untuk menandai kolom ini sebagai SecureString untuk menyimpannya dengan aman, atau menyimpan kata sandi di Azure Key Vault dan membiarkan aktivitas penyalinan mengambil dari sana saat menyalin data - pelajari lebih lanjut di Menyimpan Kredensial di Key Vault.	Tidak
clientSecret	Rahasia klien dari aplikasi Google yang digunakan untuk memperoleh token penyegaran. Anda dapat memilih untuk menandai kolom ini sebagai SecureString untuk menyimpannya dengan aman, atau menyimpan kata sandi di Azure Key Vault dan membiarkan aktivitas penyalinan mengambil dari sana saat menyalin data - pelajari lebih lanjut di Menyimpan Kredensial di Key Vault.	Tidak
Untuk ServiceAuthentication:
email	ID email akun layanan yang digunakan untuk ServiceAuthentication dan hanya dapat digunakan pada IR yang dihost sendiri.	Tidak
privateKey	Kunci privat layanan yang digunakan untuk ServiceAuthentication untuk versi driver yang direkomendasikan dan hanya dapat digunakan pada IR yang dihost sendiri. Anda dapat memilih untuk menandai kolom ini sebagai SecureString untuk menyimpannya dengan aman, atau menyimpan kata sandi di Azure Key Vault dan membiarkan aktivitas penyalinan mengambil dari sana saat menyalin data - pelajari lebih lanjut di Menyimpan Kredensial di Key Vault.	Tidak
Untuk ServiceAuthentication menggunakan versi driver lama:
email	ID email akun layanan yang digunakan untuk ServiceAuthentication dan hanya dapat digunakan pada IR yang dihost sendiri.	Tidak
keyFilePath	Jalur lengkap ke file kunci `.p12` atau `.json` yang digunakan untuk mengautentikasi alamat email akun layanan dan hanya dapat digunakan pada IR yang dihosting secara mandiri.	Tidak
Jalur Sertifikasi Terpercaya	Jalur lengkap file .pem yang berisi sertifikat CA tepercaya untuk memverifikasi server saat menyambungkan melalui TLS. Properti ini hanya dapat dikonfigurasi saat menggunakan TLS pada IR yang dihosting sendiri. Nilai defaultnya adalah file cacerts.pem yang diinstal dengan IR.	Tidak
useSystemTrustStore	Menentukan apakah akan menggunakan sertifikat OS dari penyimpanan kepercayaan sistem atau dari file PEM yang ditentukan. Nilai defaultnya adalah false.	Tidak

Contoh:

{
    "name": "GoogleAdsLinkedService",
    "properties": {
        "type": "GoogleAdWords",
        "typeProperties": {
            "clientCustomerID": "<clientCustomerID>",
            "loginCustomerID": "<loginCustomerID>",
            "developerToken": {
                "type": "SecureString",
                "value": "<developerToken>"
            },
            "authenticationType": "UserAuthentication",
            "refreshToken": {
                "type": "SecureString",
                "value": "<refreshToken>"
            },
            "clientId": {
                "type": "SecureString",
                "value": "<clientId>"
            },
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            },
            "googleAdsApiVersion": "v14"
        }
    }
}

Properti himpunan data

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan himpunan data, lihat artikel himpunan data. Bagian ini menyediakan daftar properti yang didukung oleh himpunan data Google Ads.

Untuk menyalin data dari Google Ads, atur properti jenis himpunan data ke GoogleAdWordsObject. Berikut adalah properti yang didukung:

Properti	Deskripsi	Wajib
jenis	Properti tipe himpunan data harus diatur ke: GoogleAdWordsObject	Ya
tableName	Nama tabel. Tentukan properti ini ketika Anda menggunakan versi driver warisan.	Tidak (jika "kueri" di sumber aktivitas ditentukan)

Contoh

{
    "name": "GoogleAdsDataset",
    "properties": {
        "type": "GoogleAdWordsObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<GoogleAds linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Properti Aktivitas Salin

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan aktivitas, lihat artikel Pipelines. Bagian ini menyediakan daftar properti yang didukung oleh sumber Google Ads.

Google Ads sebagai sumber

Untuk menyalin data dari Google Ads, atur jenis sumber dalam aktivitas salin ke GoogleAdWordsSource. Berikut ini properti yang didukung di bagian sumber aktivitas salin:

Properti	Deskripsi	Wajib
jenis	Properti jenis dari sumber aktivitas salin harus diatur ke: GoogleAdWordsSource	Ya
kueri	Gunakan kueri GAQL untuk membaca data. Misalnya: `SELECT campaign.id FROM campaign`.	Tidak (jika "tableName" dalam dataset ditentukan)

Contoh:

"activities":[
    {
        "name": "CopyFromGoogleAds",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<GoogleAds input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "GoogleAdWordsSource",
                "query": "SELECT campaign.id FROM campaign"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Properti aktivitas pencarian Lookup

Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.

Meningkatkan versi driver Google Ads

Untuk meningkatkan versi driver Google Ads, Anda perlu memperbarui layanan tertaut dan mempelajari cara bermigrasi dari SQL ke Google Ads Query Language (GAQL).

Memperbarui konfigurasi layanan tertaut

Di halaman Edit layanan tertaut, pilih Direkomendasikan di bawah Versi driver dan konfigurasikan layanan tertaut dengan merujuk ke Properti layanan tertaut.

Migrasi dari SQL ke GAQL

Konversikan pernyataan kueri dan nama bidang Anda saat bermigrasi dari SQL ke GAQL.

Pernyataan kueri

Jika Anda menggunakan kueri SQL di sumber aktivitas salin atau aktivitas lookup yang merujuk ke layanan tertaut Google Ads versi lama, Anda perlu memperbaruinya ke kueri GAQL.

Berbeda dengan SQL, kueri di GAQL terdiri dari enam jenis klausa:

SELECT
FROM
WHERE
ORDER BY
LIMIT
PARAMETERS

Kunjungi Google Ads Query Language Grammar untuk pengenalan GAQL.

Ambil pernyataan SQL berikut sebagai contoh:

SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value

Anda dapat mengikuti panduan di bawah ini untuk mengonversi pernyataan SQL ke pernyataan GAQL yang sesuai:

Jika * (tanda bintang) digunakan setelah SELECT klausul, maka Anda perlu menentukan semua bidang yang diperlukan sebagai pengganti tanda bintang karena GAQL tidak mendukung SELECT *. Buka artikel ini untuk melihat semua bidang yang dapat dipilih di sumber daya tertentu.
Jika nama bidang digunakan setelah SELECT klausul, maka Anda perlu mengonversi nama ke nama bidang yang sesuai di GAQL karena memiliki konvensi penamaan yang berbeda. Misalnya, nama campaign_id bidang dalam pernyataan kueri SQL harus dikonversi ke campaign.id di GAQL. Lihat Nama bidang untuk detail lebih lanjut tentang konversi nama bidang.
Nama sumber daya dapat dibiarkan apa adanya kecuali kasusnya tidak konsisten dengan apa yang ditentukan di sini.
WHERE klausul harus diperbarui sesuai dengan tata bahasa GAQL karena operator yang didukung oleh GAQL tidak konsisten dengan SQL, dan nama bidang juga harus dikonversi seperti yang dijelaskan di poin kedua.

Berikut adalah dua alat yang sangat berguna yang ditawarkan oleh Google dan sangat disarankan saat membangun pernyataan kueri GAQL yang sesuai:

Nama bidang

Nama bidang yang digunakan dalam SQL tidak selaras dengan GAQL. Anda juga perlu mempelajari aturan konversi dari nama bidang di SQL ke nama bidang di GAQL. Aturan konversi dapat diringkas sebagai berikut:

Jika nama bidang milik sumber daya, garis bawah (_) di SQL akan diubah menjadi titik (.) di GAQL. Dan untuk kata-kata antara titik, pernyataan jenis camelCase yang digunakan dalam SQL akan diubah menjadi kata terpisah dengan garis bawah tambahan di antaranya. String pertama jenis PascalCase di SQL akan diubah ke nama sumber daya yang sesuai di GAQL.
Jika nama bidang termasuk dalam segmen atau metrik, awalan segments. atau metrics. harus ditambahkan di GAQL, maka ikuti aturan yang sama seperti yang dijelaskan di titik pertama untuk mengonversi nama.

Berikut adalah contoh konkret konversi nama bidang:

Kategori	Nama bidang di SQL	Nama bidang di GAQL
Bidang sumber daya	`Campaign_startDate`	`campaign.start_date`
Bidang sumber daya	`Customer_conversionTrackingSetting_conversionTrackingStatus`	`customer.conversion_tracking_setting.conversion_tracking_status`
Segmen	`DayOfWeek`	`segments.day_of_week`
Metrik	`VideoViews`	`metrics.video_views`

Perbedaan antara Google Ads menggunakan versi driver yang direkomendasikan dan versi lama

Tabel di bawah ini menunjukkan perbedaan fitur antara Google Ads menggunakan versi driver yang direkomendasikan dan lama.

Versi driver yang direkomendasikan	Versi driver lama
Menentukan versi Google Ads API didukung.	Menentukan versi API Google Ads tidak didukung.
ServiceAuthentication mendukung dua properti: • Email • kunci pribadi	ServiceAuthentication mendukung empat properti: • Email • keyFilePath • trustedCertPath (jalur sertifikat tepercaya) • useSystemTrustStore
Memilih tabel dalam himpunan data tidak didukung.	Dukungan memilih tabel dalam himpunan data dan mengkueri tabel dalam aktivitas salin.
Mendukung sintaks GAQL sebagai bahasa kueri.	Mendukung sintaks SQL sebagai bahasa kueri.
Nama kolom output sama dengan nama bidang yang ditentukan di Google Ads.	Nama kolom output tidak cocok dengan nama bidang yang ditentukan di Google Ads.
Pemetaan berikut digunakan dari jenis data Google Ads ke jenis data sementara yang digunakan oleh layanan secara internal. float -> float int32 -> int int64 -> long	Pemetaan berikut digunakan dari jenis data Google Ads ke jenis data sementara yang digunakan oleh layanan secara internal. float -> string (Tipe data: desimal mengambang -> teks) int32 -> string int64 -> string

Meningkatkan konektor Google AdWords ke konektor Google Ads

Tingkatkan layanan tertaut Google AdWords Anda ke layanan tertaut Google Ads terbaru dengan mengikuti langkah-langkah di bawah ini:

Pilih Direkomendasikan sebagai versi driver untuk membuat layanan tertaut Google Ads baru dan konfigurasikan dengan merujuk ke Properti layanan tertaut.

Perbarui pipeline Anda yang merujuk ke layanan yang terhubung dengan Google AdWords versi lama. Mengingat bahwa layanan tertaut Google Ads hanya mendukung penggunaan kueri untuk menyalin data, jadi:

Jika alur Anda langsung mengambil data dari laporan Google AdWords, temukan nama sumber daya Google Ads yang sesuai dalam tabel di bawah ini dan gunakan alat ini untuk membuat kueri.

Laporan Google AdWords	Sumber daya Google Ads
LAPORAN_PERFORMA_AKUN	pelanggan
LAPORAN_KINERJA_IKLAN	iklan_grup_iklan
Laporan_Performa_AdGroup	ad_group
LAPORAN_PERFORMA_RENTANG_USIA	tampilan_rentang_usia
LAPORAN_KINERJA_PEMIRSA	tampilan_audiens_kampanye,tampilan_audiens_grup_iklan
LAPORAN_KINERJA_PENEMPATAN_OTOMATIS	tampilan_penempatan_kelompok
BID_GOAL_PERFORMANCE_REPORT	strategi penawaran
LAPORAN_KINERJA_ANGGARAN	anggaran kampanye
METRIK_PANGGILAN_LAPORAN_DETAIL_PANGGILAN	call_view
Laporan Target Jadwal Iklan Kampanye	tampilan_jadwal_iklan
LAPORAN KRITERIA KAMPANYE	kampanye_kriteria
LAPORAN_KINERJA_KAMPANYE	kampanye
Laporan Setelan Terbagikan Kampanye	set_berbagi_kampanye
LAPORAN_TARGET_LOKASI_KAMPANYE	tampilan lokasi
LAPORAN_KINERJA_KLIK	tampilan_klik
TAMPILKAN_LAPORAN_KINERJA_KATA_KUNCI	tampilkan_tampilan_kata_kunci
LAPORAN_PERFORMA_TOPIK_DISPLAY	tampilan_topik
LAPORAN_KINERJA_GENDER	tampilan_gender
Laporan Kinerja Geo	tampilan_geografis,tampilan_lokasi_pengguna
LAPORAN_KUERI_TANPA_KATA_KUNCI	tampilan istilah pencarian iklan pencarian dinamis
LAPORAN_KINERJA_KATA_KUNCI	kata kunci_tampilan
LABEL_REPORT	label
LAPORAN_HALAMAN_POROS	landing_page_view,expanded_landing_page_view
LAPORAN_PERMINTAAN_BAYAR_ORGANIK	tampilan_istilah_pencarian_berbayar_organik
LAPORAN_PERFORMA_STATUS_ORANG_TUA	tampilan status orang tua
LAPORAN_ITEM_UMPAN_TEMPORER	feed_item,feed_item_target
PLACEHOLDER_REPORT	feed_placeholder_view
LAPORAN_KINERJA_PENEMPATAN	managed_placement_view
LAPORAN_PARTISI_PRODUK	Tampilan Kelompok Produk
LAPORAN_KINERJA_PENELUSURAN_QUERY	tampilan_istilah_pencarian
SHARED_SET_CRITERIA_REPORT	kriteria_bersama
LAPORAN_SET_BERSAMA	shared_set
SHOPPING_PERFORMANCE_REPORT	tampilan_kinerja_belanja
LAPORAN_KINERJA_KONTEN_TERBAIK	Tidak lagi tersedia di Google Ads API.
Laporan Kinerja URL	tampilan_penempatan_detail
USER_AD_DISTANCE_REPORT	tampilan_jarak
LAPORAN_PERFORMA_VIDEO	video

Ketahuilah bahwa ada batasan tertentu dengan peningkatan ini:
1. Tidak semua jenis laporan dari AWQL didukung di GAQL.
2. Tidak semua kueri AWQL diterjemahkan dengan bersih ke kueri GAQL.

Untuk daftar penyimpanan data yang didukung sebagai sumber dan sink oleh aktivitas salin, lihat penyimpanan data yang didukung.

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-04-22