Pengumuman Google Ads API v24

Rabu, 22 April 2026

Hari ini, kami mengumumkan rilis v24 Google Ads API. Untuk menggunakan fitur v24 baru, Anda harus mengupgrade library klien dan kode klien. Semua library klien dan contoh kode yang diperbarui telah dipublikasikan.

Bergabunglah bersama kami untuk mengikuti panduan live rilis ini di acara "Sorotan Rilis Google Ads API" di Discord, YouTube Live Developer Google Ads, atau Acara Live LinkedIn besok (23 April pukul 10.00 ET). Acara ini juga akan direkam dan diposting di YouTube bagi mereka yang tidak dapat menghadiri acara live. Jika ada pertanyaan atau ingin mendiskusikan postingan ini, hubungi kami di saluran #ads-api di Discord.

Fitur baru

Dukungan untuk Konversi dengan Data Keranjang: Konversi dengan data keranjang adalah ekstensi untuk tracking konversi di situs atau aplikasi Anda. Melalui konversi dengan data keranjang, Anda dapat memberikan detail produk yang terjual untuk setiap transaksi, yang membantu Anda mendapatkan insight dan pelaporan lanjutan terkait penjualan dan laba untuk akun dan kampanye Google Ads Anda, seperti jumlah pesanan, ukuran keranjang rata-rata, pendapatan, dan laba kotor.

Google Ads API v24 menambahkan dukungan untuk fitur ini sebagai berikut:

  • Menambahkan resource baru CartDataSalesView yang memungkinkan segmentasi metrik konversi tidak hanya berdasarkan klik produk, tetapi juga berdasarkan produk yang terjual, dengan segmen seperti product_sold_brand. Kolom ini memungkinkan pengiklan melihat statistik produk yang benar-benar dibeli pelanggan setelah mengklik iklan, meskipun iklan tersebut ditujukan untuk produk yang berbeda.
  • Menambahkan beberapa metrik "semua" yang tidak dapat di-bid, yang merupakan metrik yang juga menyertakan konversi yang tidak dioptimalkan secara aktif oleh kampanye Anda, misalnya all_cost_of_goods_sold_micros. Metrik baru ditambahkan ke semua resource yang mendukung metrik yang dapat di-bid yang sesuai.
  • Menambahkan segmen conversion_attribution_event_type ke resource ShoppingPerformanceView, sehingga dapat dipilih dengan data keranjang dan metrik konversi lainnya. Segmen ini menunjukkan apakah konversi diatribusikan ke klik atau ke penayangan dan diperlukan untuk mengenali statistik data keranjang yang dihasilkan oleh konversi lihat-tayang.

Fitur terupdate

Versi v24 memperkenalkan update pada fitur yang ada yang memerlukan perubahan kode saat mengupgrade. Kami membahas perubahan yang paling penting di sini; lihat catatan rilis untuk mengetahui daftar lengkap perubahan.

Setelan pengecualian konten video di kampanye: Kami menyederhanakan kemampuan untuk menetapkan setelan pengecualian konten video di masing-masing kampanye. Setelan ini tersedia di tingkat pelanggan, dan berlaku untuk semua kampanye. Setelan pengecualian konten ini dimaksudkan untuk memberi Anda kontrol tambahan dan membantu Anda mengecualikan jenis konten yang, meskipun mematuhi kebijakan kami, mungkin tidak sesuai dengan merek atau bisnis Anda. Lihat https://support.google.com/google-ads/answer/7515513 untuk mempelajari lebih lanjut setelan pengecualian konten video.

Perubahan pada AudienceInsightsService: Sebagai bagian dari refaktorisasi kode, kami memindahkan kolom permintaan InsightsAudience.topic_audience_combinations ke namespace common. Anda mungkin perlu memperbarui perintah impor dalam beberapa bahasa pemrograman.

Perubahan pada ReachPlanService: Sebagai bagian dari refaktorisasi kode, kami memindahkan kolom youtube_select_lineups dari layanan ReachPlanService.ListPlannableProducts. Grup channel kini tersedia dalam kolom youtube_select_lineup_targeting. Grup Channel YouTube Select adalah produk reservasi bagi klien yang memenuhi syarat untuk menarget 1% channel populer teratas di YouTube yang memiliki audiens paling aktif di pasar tertentu. Pelajari lebih lanjut.

Perubahan pada ContentCreatorInsightsService: Sebagai bagian dari refaktorisasi kode, kami menghapus kolom is_brand_connect_creator dari layanan ContentCreatorInsightsService.GenerateCreatorInsights dan ContentCreatorInsightsService.GenerateTrendingInsights.
Sebagai gantinya, pengguna harus mencari kreator agar opsi CREATOR_PARTNERSHIPS tersedia di partnership_opportunities. Kemitraan Kreator YouTube di Google Ads adalah tempat Anda dapat menemukan kreator YouTube untuk diajak berkolaborasi dalam konten bersponsor dan membantu Anda mengelola kemitraan kreator secara efisien. Pelajari lebih lanjut.

Perubahan pada KeywordPlanIdeaService: Untuk memberikan pengalaman yang lebih efisien dan andal, kami telah menyatukan infrastruktur perkiraan kami. Google Ads API v24 memperkenalkan metode GenerateKeywordForecastMetrics yang diperbarui untuk menyederhanakan proses perencanaan dengan berfokus pada metrik yang paling berdampak langsung pada performa Anda. Kami akan membagikan postingan blog yang lebih mendetail tentang perubahan ini dalam beberapa hari mendatang.

Perubahan pada resource campaign_budget: Kami menghapus segmen ad_sub_network_type untuk resource campaign_budget karena tidak kompatibel dengan tampilan ini.

Perubahan pada tampilan aset: Kami menghapus segmen click_type dari tampilan ad_group_asset, campaign_asset, dan customer_asset. Perubahan ini sejalan dengan perubahan produk baru-baru ini yang menghapus segmen ini dari Google Ads untuk menghindari kesalahan penyajian data. Anda dapat menggunakan segmentasi click_type dari resource ad_group_ad untuk mendapatkan detail tentang performa iklan dan aset yang ditayangkan bersamanya.

Perubahan pada iklan responsif video: VideoResponsiveAdInfo kini dapat diubah. Sebagai bagian dari perubahan ini, kami telah menandai videos, business_name, dan logo_images sebagai kolom wajib diisi dalam objek DemandGenVideoResponsiveAdInfo dan VideoResponsiveAdInfo.

Perubahan pada ShareablePreviewService: ShareablePreviewService.GenerateShareablePreviews diperbarui agar tidak lagi menggunakan kegagalan sebagian. Permintaan akan menampilkan error jika gagal untuk ID apa pun. Pelajari lebih lanjut.

Referensi berikut dapat membantu Anda memulai:

Untuk masalah dukungan teknis, hubungi https://support.google.com/google-ads/contact/google_ads_api

Potret penulis - , Tim Google Ads API

Label: google-ads-api, release