Perubahan untuk mendukung Peraturan Iklan Politik Uni Eropa di Google Ads API dan skrip Google Ads

Kamis, 7 Agustus 2025

Apa yang berubah?

Seperti yang telah diumumkan tahun lalu, Google akan berhenti menayangkan iklan politik di Uni Eropa sebelum peraturan baru mulai berlaku pada Oktober 2025. Pada 3 September 2025, Google Ads API dan skrip Google Ads akan meluncurkan penegakan terkait perubahan ini. Jika Anda menggunakan salah satu produk ini untuk membuat atau mengelola kampanye, Anda mungkin perlu mengupdate aplikasi untuk menangani penegakan ini sebelum 3 September 2025.

Dukungan API untuk pernyataan mandiri iklan politik Uni Eropa

Google Ads API dan skrip Google Ads telah menambahkan dukungan untuk pernyataan mandiri terkait apakah kampanye memiliki iklan politik Uni Eropa. Pelajari cara iklan politik Uni Eropa didefinisikan di sini. Versi v19.2, v20.1, dan v21 API berisi kolom baru bernama contains_eu_political_advertising di objek Campaign. Nilai yang mungkin dan artinya ditampilkan dalam tabel di bawah.

Nilai	Arti
CONTAINS_EU_POLITICAL_ADVERTISING	Kampanye memiliki iklan politik Uni Eropa.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING	Kampanye tidak memiliki iklan politik Uni Eropa.
UNSPECIFIED	Kampanye tidak memiliki pernyataan mandiri tentang iklan politik Uni Eropa.

Anda dapat mengambil status pernyataan mandiri kampanye di Google Ads API dengan menjalankan kueri berikut menggunakan metode Search atau SearchStream dari GoogleAdsService. Untuk Skrip Google Ads, gunakan metode AdsApp.search atau AdsApp.report.

select campaign.id, campaign.contains_eu_political_advertising from campaign

Jika menggunakan library klien Google Ads API, Anda mungkin perlu mendownload versi library terbaru untuk menggunakan fungsi ini di API versi v19 dan v20.

Perubahan validasi & penerapan API

Pada 3 September 2025, Google Ads API dan skrip Google Ads akan mulai menerapkan pemeriksaan berikut di API versi v19 dan v20.

• Semua kampanye baru yang dibuat melalui Google Ads API atau skrip Google Ads harus menetapkan kolom contains_eu_political_advertising. Panggilan API untuk membuat kampanye baru menggunakan CampaignService.MutateCampaigns akan gagal dengan error FieldError.REQUIRED jika kolom ini tidak ditetapkan. Skrip Google Ads akan menerapkan pemeriksaan ini saat membuat kampanye menggunakan metode AdsApp.mutate atau AdsApp.mutateAll.
• Semua kampanye yang ada harus menetapkan kolom contains_eu_political_advertising sebelum mencoba mengubah penargetan proximity, location, atau location_group di tingkat kampanye atau grup iklan. Panggilan API untuk membuat atau memperbarui kriteria kampanye ini menggunakan metode CampaignCriterionService.MutateCampaignCriteria untuk kampanye yang ada akan gagal dengan error CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION jika kampanye belum menyelesaikan pernyataan mandiri. Panggilan API untuk membuat atau memperbarui kriteria grup iklan ini menggunakan AdGroupCriterionService.MutateAdGroupCriteria juga akan gagal dengan cara yang sama jika kampanye belum menyelesaikan pernyataan mandiri. Skrip Google Ads akan menerapkan pemeriksaan ini saat mencoba mengubah penargetan menggunakan metode AdsApp.mutate, AdsApp.mutateAll, AdsApp.Campaign.addProximity, dan AdsApp.Campaign.addLocation.
• Penegakan ini juga berlaku untuk mekanisme lain yang dapat Anda gunakan untuk membuat kampanye, seperti menjalankan Tugas Batch dan menggunakan metode GoogleAdsService.Mutate untuk membuat dan memperbarui entity.
• Upaya untuk menjadwalkan eksperimen baru menggunakan metode ExperimentService.ScheduleExperiment akan menampilkan error ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION jika contains_eu_political_advertising declaration tidak ada di kampanye draf perlakuan.
• Jika Anda menggunakan fitur upload massal di skrip Google Ads, lihat dokumentasi produk untuk mempelajari lebih lanjut perubahan template spreadsheet yang diperlukan sebagai bagian dari perubahan ini.

Pemeriksaan ini sudah diterapkan di Google Ads API versi v21.

Bagaimana pengaruhnya terhadap penayangan kampanye saya?

Semua kampanye yang telah menyatakan iklan politik Uni Eropa dengan menetapkan contains_eu_political_advertising ke true akan berhenti menayangkan iklan di Uni Eropa pada 22 September 2025. Lihat Pusat Bantuan kami untuk mempelajari lebih lanjut.

Kampanye yang ada tanpa pernyataan tidak akan terpengaruh untuk saat ini. Sebaiknya perbarui kampanye yang ada di akun Anda dengan pernyataan yang sesuai sesegera mungkin. Anda dapat mengambil kampanye tanpa pernyataan menggunakan kueri GAQL berikut menggunakan metode Search atau SearchStream dari GoogleAdsService.

select campaign.id, campaign.contains_eu_political_advertising
  from
    campaign
  where
    campaign.contains_eu_political_advertising NOT IN
    (
       'CONTAINS_EU_POLITICAL_ADVERTISING',
       'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING'
    )

Apa yang harus saya lakukan?

Jika aplikasi Anda menggunakan Google Ads API atau skrip Google Ads untuk membuat atau mengelola kampanye, pastikan untuk memperbarui aplikasi Anda agar dapat menangani penegakan ini sebelum 3 September 2025.

Bagaimana cara mendapatkan bantuan?

Hubungi saluran dukungan Google Ads API atau dukungan skrip Google Ads jika ada pertanyaan lebih lanjut tentang perubahan ini.

 - Anash P. Oommen, Tim Google Ads API

Label: campaign, google-ads-api, google-ads-scripts