Catatan rilis

v23.1 (25-02-2026)

Fitur dan update baru berikut ditambahkan di v23.1.

Lihat Mengupgrade ke versi terbaru untuk mendapatkan panduan.

Pengelolaan akun

  • Menambahkan advertising_partner_properties.allowed_domain ke resource ProductLinkInvitation dan ProductLink. Partner iklan hanya dapat beriklan di domain ini.
  • Menambahkan kolom contains_eu_political_advertising ke resource Customer. Kolom ini mengambil status pernyataan tingkat akun apakah berisi iklan politik yang ditargetkan ke Uni Eropa, dan menampilkan EuPoliticalAdvertisingStatusEnum.

Kampanye

  • Menambahkan dukungan untuk panduan teks, yang dapat digunakan dengan kampanye Performa Maksimal dan Penelusuran untuk mengontrol aset teks yang dibuat AI secara terprogram.
  • Menambahkan CampaignPrimaryStatusReason.CAMPAIGN_NOT_BOOKED, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRING, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRED, dan CampaignPrimaryStatusReason.BOOKING_CANCELLED untuk memberikan alasan status utama untuk kampanye dengan strategi bidding FIXED_CPM.
  • Menambahkan Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure dan Campaign.VideoCampaignSettings.booking_details(hanya baca).
  • Menambahkan Campaign.missing_eu_political_advertising_declaration untuk mendukung kueri dan pemfilteran kampanye yang tidak memiliki pernyataan tentang apakah kampanye tersebut berisi iklan politik yang ditargetkan ke Uni Eropa.

Konversi

  • Menambahkan ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS untuk mendukung pelacakan pengguna yang menonton iklan dan kemudian menonton video dari channel yang sama.

Umum

  • Menambahkan CANNOT_TARGET_ONLY_UNDETERMINED ke CriterionErrorEnum. Error ini ditampilkan saat mencoba menargetkan hanya kategori yang tidak ditentukan dalam dimensi demografi.

Insentif

  • Menambahkan dua kode error baru ke IncentiveErrorEnum: MAX_INCENTIVES_REDEEMED dan ACCOUNT_TOO_OLD. Error ini dapat ditampilkan untuk permintaan yang dibuat pada atau setelah 11 Maret 2026.

Perencanaan

Laporan

  • Menambahkan metrik baru yang melaporkan jumlah pengguna yang melihat iklan Anda setidaknya dua, tiga, empat, lima, atau sepuluh kali: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus, dan unique_users_ten_plus.
  • Menambahkan VERTICAL_ADS_DATA_FEED ke SearchTermMatchSourceEnum untuk mendukung feed data iklan vertikal (misalnya, Penargetan entitas Iklan Perjalanan).

YouTubeVideoUpload

  • Menambahkan layanan YouTubeVideoUpload untuk mendukung penguploadan dan pengelolaan video di YouTube, serta resource YouTubeVideoUpload untuk mendukung pengambilan status dan metadata upload. Fitur ini hanya didukung untuk REST dan library klien Python.

v23 (28-01-2026)

Fitur dan update baru berikut ditambahkan di v23.

Iklan

Aset

Penagihan

Kampanye

Konversi

  • Menambahkan YOUTUBE_FOLLOW_ON_VIEWS ke ConversionActionCategory untuk mendukung pelacakan pengguna yang menonton iklan dan kemudian menonton video dari channel yang sama.

Peningkat Permintaan

Insentif

  • Menambahkan dukungan untuk insentif Pilih Sendiri (CYO), yang memungkinkan partner mengambil dan menerapkan insentif Google Ads secara terprogram untuk pelanggan mereka:

  • Untuk memfasilitasi penanganan kegagalan secara terprogram yang lebih terperinci, kami akan menambahkan kode error tambahan ke IncentivesService dalam rilis mendatang. Sebaiknya pantau pengumuman mendatang dan catatan rilis untuk kode error baru ini guna memastikan aplikasi Anda dapat mengelola mode kegagalan baru ini.

Perencanaan

Rekomendasi

  • Menambahkan kolom is_new_customer ke GenerateRecommendationsRequest. Jika disetel ke true untuk rekomendasi jenis CAMPAIGN_BUDGET, rekomendasi akan dibuat menggunakan model untuk pelanggan baru. Opsi ini hanya direkomendasikan untuk pelanggan yang tidak memiliki kampanye.

Laporan

Belanja

  • ShoppingPerformanceView kini mendukung metrik berikut yang disegmentasikan menurut tanggal konversi: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.
  • ShoppingPerformanceView kini mendukung metrik kompetitif berikut: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share.
  • Menambahkan product_image_uri ke ShoppingProduct.

Iklan vertikal

  • Menambahkan vertical_ads_format_setting ke AdGroup untuk kampanye Penelusuran yang menggunakan feed perjalanan, sehingga memungkinkan kontrol atas format iklan yang dapat ditayangkan.
  • Menambahkan jenis kriteria vertical_ads_item_group_rule_list ke AdGroupCriterion. Menambahkan vertical_ads_item_group_rule ke SharedCriterion. Kriteria ini memungkinkan penargetan grup item di Kampanye Penelusuran dengan feed perjalanan.
  • Sekarang Anda dapat menghubungkan feed data iklan vertikal ke kampanye penelusuran yang menjalankan AI Maksimal sehingga kampanye tersebut menampilkan iklan perjalanan link pemesanan dan promosi properti bersama iklan teks Anda. Di tingkat grup iklan, Anda dapat mengontrol format yang akan ditampilkan dengan vertical_ads_format_setting dan menentukan serangkaian aturan kelompok item untuk menargetkan sebagian kecil entitas dari Feed Data Iklan Vertikal. Selain itu, pelaporan kini dapat disegmentasikan menurut AdFormatType dan dimensi dari feed data iklan vertikal.

Video

v22.1 (25-02-2026)

Fitur baru berikut ditambahkan di v22.1.

Pengelolaan akun

  • Menambahkan kolom contains_eu_political_advertising ke resource Customer. Kolom ini mengambil status pernyataan tingkat akun apakah berisi iklan politik yang ditargetkan ke Uni Eropa, dan menampilkan EuPoliticalAdvertisingStatusEnum.

Kampanye

  • Menambahkan Campaign.missing_eu_political_advertising_declaration untuk mendukung kueri dan pemfilteran kampanye yang tidak memiliki pernyataan tentang apakah kampanye tersebut berisi iklan politik yang ditargetkan ke Uni Eropa.

v22 (15-10-2025)

Fitur dan update baru berikut ditambahkan di v22.

Aset

  • Menambahkan LANDING_PAGE_PREVIEW sebagai jenis kolom aset gambar baru.
  • Memperkenalkan AssetGenerationService (Beta):
    • Layanan ini memungkinkan pembuatan aset teks dan gambar menggunakan AI generatif. Layanan ini awalnya hanya tersedia untuk sejumlah kecil peserta beta tertutup.
    • GenerateText: Membuat teks berdasarkan input seperti URL final, perintah bentuk bebas, kata kunci, dan konteks kampanye yang ada.
    • GenerateImages: Membuat gambar berdasarkan input seperti URL final, perintah bentuk bebas, konteks kampanye yang ada, atau dengan merekontekstualisasi gambar produk yang ada.
    • Error selama pembuatan aset ditampilkan dengan kode dari AssetGenerationErrorEnum.

Kampanye

Peningkat Permintaan

Umum

  • Menambahkan batas 10.000 operasi per permintaan AddBatchJobOperations.
  • Penanganan yang diperbarui untuk kolom page_size di ListBatchJobResultsRequest:
    • Jika page_size tidak disetel atau 0, nilai defaultnya kini adalah maksimum 1.000 (sebelumnya menampilkan INVALID_PAGE_SIZE).
    • Jika page_size melebihi 1.000, API kini akan menampilkan error INVALID_PAGE_SIZE (sebelumnya dibatasi secara diam-diam hingga 1.000).
  • Menambahkan kode error baru: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED untuk menunjukkan kapan batas rasio aktivasi profil pembayaran telah terlampaui.

Performa Maks

Perencanaan

Laporan

Sasaran terpadu

  • Menambahkan dukungan untuk sasaran retensi pelanggan guna mengoptimalkan interaksi ulang dengan pelanggan lama.

Video

v21.1 (25-02-2026)

Fitur baru berikut telah ditambahkan di v21.1.

Pengelolaan akun

  • Menambahkan kolom contains_eu_political_advertising ke resource Customer. Kolom ini mengambil status pernyataan tingkat akun apakah berisi iklan politik yang ditargetkan ke Uni Eropa, dan menampilkan EuPoliticalAdvertisingStatusEnum.

Kampanye

  • Menambahkan Campaign.missing_eu_political_advertising_declaration untuk mendukung kueri dan pemfilteran kampanye yang tidak memiliki pernyataan tentang apakah kampanye tersebut berisi iklan politik yang ditargetkan ke Uni Eropa.

v21 (06-08-2025)

Lihat Mengupgrade ke versi terbaru untuk mendapatkan panduan.

AI Maksimal untuk kampanye Penelusuran

  • Sekarang Anda dapat menggunakan kolom ai_max_setting.enable_ai_max dari Campaign untuk mengaktifkan AI Maksimal untuk kampanye Penelusuran. AI Maksimal untuk kampanye Penelusuran memperluas jangkauan kampanye Penelusuran melalui pencocokan istilah penelusuran dan memungkinkan kontrol apakah penargetan dan kontrol materi iklan ditayangkan saat disetel. Otomatisasi aset teks dan kontrol daftar merek yang ditetapkan dalam permintaan versi sebelumnya akan tetap dipatuhi hingga AI Maksimal untuk kampanye Penelusuran diaktifkan dan dinonaktifkan secara eksplisit. Campaign.ai_max_setting.bundling_required dapat digunakan untuk menentukan apakah AI Maksimal untuk kampanye Penelusuran harus diaktifkan untuk mematuhi atau mengubah otomatisasi aset teks dan kontrol daftar merek. AdGroup.ai_max_ad_group_setting.disable_search_term_matching dapat digunakan untuk menonaktifkan pencocokan istilah penelusuran saat kampanye induk telah mengaktifkan AI Maksimal untuk kampanye Penelusuran. Lihat postingan blog kami Dapatkan performa yang lebih optimal dengan AI Maksimal untuk kampanye Penelusuran.

  • Menambahkan CampaignError.AI_MAX_MUST_BE_ENABLED, yang ditampilkan untuk kampanye Penelusuran saat Anda memilih untuk menggunakan FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION tanpa mengaktifkan AI Maksimal untuk kampanye Penelusuran di kampanye.

  • Menambahkan dukungan untuk menerapkan kontrol penargetan di tingkat grup iklan dalam kampanye AI Maksimal untuk Penelusuran. Anda kini dapat menambahkan kriteria berikut ke grup iklan:

    • Daftar merek
    • Lokasi
    • Halaman web (aturan URL)
  • Menambahkan ai_max_search_term_ad_combination_view untuk melaporkan performa kombinasi istilah penelusuran, judul, dan halaman landing. Tampilan ini menunjukkan kueri penelusuran yang memicu iklan Anda dan performa kombinasi spesifik tersebut. Rilis mendatang akan menyertakan tampilan tambahan yang juga menyertakan data Performa Maksimal. Jika Anda ingin menghindari migrasi penerapan untuk mendapatkan data Performa Maksimal, sebaiknya tunggu rilis tersebut.

  • Menambahkan AI_MAX sebagai nilai baru untuk segmen search_term_match_type.

Aset

Kampanye

Konversi

Peningkat Permintaan

Perubahan pada iklan politik Uni Eropa

Perubahan iklan politik Uni Eropa ini juga telah dilakukan dalam rilis v19.2 dan v20.1.

  • Campaign.contains_eu_political_advertising ditambahkan. Kolom ini menunjukkan apakah kampanye Anda berisi konten iklan politik yang ditargetkan ke Uni Eropa. Jika kolom ini disetel ke CONTAINS_EU_POLITICAL_ADVERTISING, kampanye tidak akan lagi ditayangkan di Uni Eropa mulai 22 September 2025. Panggilan API untuk membuat kampanye baru akan gagal dengan error FieldError.REQUIRED jika kolom ini tidak disetel.

    Untuk kampanye yang ada, Anda harus menetapkan kolom contains_eu_political_advertising sebelum mencoba mengubah penargetan kedekatan, lokasi, atau grup lokasi di tingkat kampanye atau grup iklan. Panggilan API untuk membuat atau memperbarui kriteria kampanye atau grup iklan ini untuk kampanye yang ada akan gagal dengan error CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION jika kampanye belum menyelesaikan pernyataan mandiri.

    Untuk versi v19.x dan 20.x, persyaratan untuk menyetel kolom ini belum diterapkan, tetapi akan diterapkan pada masa mendatang. Perubahan ini akan diumumkan terlebih dahulu.

  • Uji Coba dan Eksperimen akan menampilkan ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION jika kampanye eksperimen belum menyatakan sendiri apakah berisi iklan politik yang menargetkan Uni Eropa atau tidak.

Performa Maks

  • Untuk kampanye PMax baru, nilai default Campaign.brand_guidelines_enabled kini adalah true.

  • Menambahkan laporan campaign_search_term_view. Tampilan ini menawarkan metrik istilah penelusuran yang digabungkan di tingkat kampanye. Tampilan ini juga memperkenalkan dukungan kampanye Performa Maksimal untuk istilah penelusuran.

  • Menambahkan PERFORMANCE_MAX sebagai nilai baru untuk segmen search_term_match_type.

Perencanaan

Laporan

Video

v20.2 (25-02-2026)

Fitur baru berikut ditambahkan di v20.2.

Pengelolaan akun

  • Menambahkan kolom contains_eu_political_advertising ke resource Customer. Kolom ini mengambil status pernyataan tingkat akun apakah berisi iklan politik yang ditargetkan ke Uni Eropa, dan menampilkan EuPoliticalAdvertisingStatusEnum.

Kampanye

  • Menambahkan Campaign.missing_eu_political_advertising_declaration untuk mendukung kueri dan pemfilteran kampanye yang tidak memiliki pernyataan tentang apakah kampanye tersebut berisi iklan politik yang ditargetkan ke Uni Eropa.

v20.1 (06-08-2025)

Perubahan iklan politik Uni Eropa ini juga telah dilakukan dalam rilis v19.2 dan v21.

Perubahan pada iklan politik Uni Eropa

  • Campaign.contains_eu_political_advertising ditambahkan. Kolom ini menunjukkan apakah kampanye Anda berisi konten iklan politik yang ditargetkan ke Uni Eropa. Jika kolom ini disetel ke CONTAINS_EU_POLITICAL_ADVERTISING, kampanye tidak akan lagi ditayangkan di Uni Eropa mulai 22 September 2025.

    Untuk kampanye yang ada, Anda harus menetapkan kolom contains_eu_political_advertising sebelum mencoba mengubah penargetan kedekatan, lokasi, atau grup lokasi di tingkat kampanye atau grup iklan. Panggilan API untuk membuat atau memperbarui kriteria kampanye atau grup iklan ini untuk kampanye yang ada akan gagal dengan error CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION jika kampanye belum menyelesaikan pernyataan mandiri.

    Untuk versi v19.x dan 20.x, persyaratan untuk menyetel kolom ini belum diterapkan, tetapi akan diterapkan pada masa mendatang. Perubahan ini akan diumumkan terlebih dahulu.

  • Uji Coba dan Eksperimen akan menampilkan ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION jika kampanye eksperimen belum menyatakan sendiri apakah berisi iklan politik yang menargetkan Uni Eropa atau tidak.

v20 (04-06-2025)

Fitur dan update baru berikut ditambahkan di v20.

Lihat Mengupgrade ke versi terbaru untuk mendapatkan panduan.

Aset

Menambahkan beberapa kolom metrik dan segmen baru untuk laporan asset_group.

Kolom metrik

Kolom segmen

Kampanye

Konversi

  • Sekarang Anda dapat memperbarui kolom google_ads_conversion_customer pada pelanggan lama untuk memilih ikut serta dalam tracking konversi lintas-akun, atau mengubah induk tracking konversi yang ada ke akun pengelola lain.

  • Menambahkan kolom ClickConversion.user_ip_address. Google Ads tidak mendukung pencocokan alamat IP untuk pengguna akhir di Wilayah Ekonomi Eropa (EEA), Inggris Raya (UK), atau Swiss (CH). Tambahkan logika untuk mengecualikan alamat IP secara bersyarat dari pengguna di wilayah ini. Pastikan Anda memberi pengguna informasi yang jelas dan komprehensif tentang data yang Anda kumpulkan di situs, aplikasi, dan properti Anda lainnya, serta mendapatkan izin jika diwajibkan oleh hukum atau kebijakan Google yang berlaku. Lihat halaman Tentang impor konversi offline untuk mengetahui detail selengkapnya.

Peningkat Permintaan

Rekomendasi

  • Menambahkan dukungan untuk ShoppingSetting selama pembuatan kampanye saat menggunakan GenerateRecommendationsRequest.
    • Menambahkan kolom merchant_center_account_id ke GenerateRecommendationsRequest untuk menunjukkan kapan rekomendasi harus dibuat untuk kampanye retail, bukan kampanye Performa Maksimal standar.

Perencanaan

  • AudienceInsightsDimension.YOUTUBE_LINEUP telah ditambahkan untuk menggantikan AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP di AudienceInsightsService dan ContentCreatorInsightsService. Dimensi baru ini memungkinkan Anda mengambil insight dan metadata untuk Grup Channel YouTube Select (YTS). Objek yang diganti terkait dengan YOUTUBE_DYNAMIC_LINEUP seperti DynamicLineupAttributeMetadata dan AudienceInsightsDynamicLineup agar selaras dengan penghapusan yang lebih luas pada Barisan Dinamis di Google Ads. Fitur ini hanya tersedia untuk akun yang ada dalam daftar yang diizinkan.
  • AdditionalApplicationInfo dan ApplicationInstance telah ditambahkan di AudienceInsightsService, ContentCreatorInsightsService, dan ReachPlanService. Fitur ini hanya tersedia untuk akun yang ada dalam daftar yang diizinkan.
  • Memperbarui AudienceInsightsService dan ContentCreatorInsightsService untuk memberikan insight yang lebih mendetail. Anda kini dapat menyegmentasikan data kreator konten menurut perangkat menggunakan AudienceInsightsDimension.DEVICE dan AudienceInsightsAttribute.device baru di kedua layanan. Fitur ini hanya tersedia untuk akun dalam daftar yang diizinkan.
  • Menambahkan metrik video gabungan tambahan ke GenerateCreatorInsightsResponse untuk analisis kreator konten yang lebih komprehensif: engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count, dan is_brand_connect_creator. Fitur ini hanya tersedia untuk akun yang ada dalam daftar yang diizinkan.
  • Menambahkan sub_country_locations ke GenerateCreatorInsightsRequest untuk ContentCreatorInsightsService. Hal ini memungkinkan penentuan lokasi geografis sub-negara untuk mempersempit penelusuran insight kreator. Kolom sub_country_locations hanya didukung saat menggunakan oneof search_attributes di kolom criteria. Jika sub_country_locations diberikan dengan jenis kriteria lain, permintaan akan tidak valid. Hal ini memungkinkan penargetan dan analisis geografis yang lebih terperinci untuk insight kreator konten. Fitur ini hanya tersedia untuk akun dalam daftar yang diizinkan.
  • Menambahkan ReachPlanService.ListPlannableUserLists, yang menampilkan daftar pengguna pihak pertama yang dimiliki oleh pelanggan, dan menambahkan UserListInfo ke opsi penargetan audiens di GenerateReachForecastRequest. Dengan begitu, Anda dapat mengambil daftar pengguna yang dapat direncanakan untuk pelanggan tertentu, lalu membuat perkiraan jangkauan untuk kampanye yang menargetkan audiens tertentu tersebut. Peningkatan ini meningkatkan perencanaan jangkauan yang disesuaikan dengan menyertakan data audiens pihak pertama Anda langsung ke dalam perkiraan. Perkiraan jangkauan hanya tersedia untuk akun yang diizinkan.

Video

  • Menambahkan iklan AdFormatType.PAUSE yang ditayangkan di video YouTube organik di layar TV, yang disertakan dalam pelaporan. Iklan ini ditampilkan langsung di samping frame video statis di layar jeda. Hal ini tidak mencakup iklan video Peningkat Permintaan yang ditampilkan di panel iklan di bawah atau di atas video organik yang dijeda, yang dilaporkan dalam AdFormatType.INFEED.

Arsip catatan rilis

Lihat Versi yang dihentikan untuk catatan rilis yang diarsipkan.