Mengumumkan Penghentian

Halaman ini mencantumkan tanggal penghentian dan penghentian penggunaan untuk versi API dan fitur individual di Display & Video 360 API.

Penghentian penggunaan dan tanggal penghentian API juga akan diumumkan di blog developer Google Ads.

Penghentian Penggunaan Versi

Versi Display & Video 360 API dirilis, dihentikan, dan dihentikan penggunaannya secara rutin. Langkah-langkah ini didefinisikan sebagai berikut:

  • Rilis: Versi keluar dari status alfa atau beta dan dianggap stabil. Penambahan fitur mungkin masih dirilis untuk versi tersebut.
  • Penghentian penggunaan: Versi dihentikan dan tanggal akhir dukungan (penghentian) diumumkan. Pengguna harus bermigrasi ke versi yang lebih baru sebelum tanggal penghentian. Penambahan fitur tidak akan lagi dirilis untuk versi tersebut.
  • Penghentian: Versi tidak lagi didukung. Permintaan yang dibuat ke versi akan menampilkan error.

Tabel ini mencantumkan semua versi API inti Display & Video 360 yang ada, tanggal rilisnya, serta tanggal penghentian dan penonaktifannya, jika diumumkan.

Versi API Tanggal Rilis Tanggal Penghentian Tanggal Penghentian Panduan Migrasi
v4 27 Maret 2025
v3 31 Oktober 2023 2 April 2025 7 Oktober 2025 Bermigrasi dari v3 ke v4
v2 6 Desember 2022 15 Februari 2024 3 September 2024 Bermigrasi dari v2 ke v3
v1 9 Maret 2020 13 Maret 2023 14 September 2023 Bermigrasi dari v1 ke v2

Penghentian Penggunaan Fitur

Ikuti blog developer Google Ads kami untuk mengetahui pengumuman penghentian penggunaan fitur penting yang akan datang.

Tabel di bawah mencantumkan semua penghentian penggunaan fitur yang diumumkan, yang memberikan tanggal berlaku awal dan deskripsi penghentian penggunaan dengan tindakan yang direkomendasikan dan link ke dokumentasi yang relevan:

Fitur Tanggal Mulai Berlaku Awal Deskripsi
Perluasan Penargetan 25 Maret 2023 Penggantian fitur perluasan penargetan dengan penargetan yang dioptimalkan, yang diluncurkan secara bertahap dari 25 Maret 2023 hingga awal Mei 2023. Perubahan yang relevan pada perilaku API Display & Video 360 dan File Data Terstruktur serta tindakan yang direkomendasikan diumumkan dalam postingan blog.
Pemicu Manual 17 Mei 2023

Linimasa:

  • 17 Mei 2023: Item baris yang menggunakan pemicu manual akan berhenti ditayangkan di Display & Video 360. Jika Anda mengaktifkan pemicu manual yang ditautkan ke item baris aktif setelah tanggal ini, item baris tidak akan menayangkan iklan.
  • 1 Agustus 2023: Layanan advertisers.manualTriggers di DV360 API v1 dan v2, nilai enum LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER di DV360 API v1, dan kolom LineItemFlight.triggerId di DV360 API v1 akan dihentikan. Setelah tanggal ini, permintaan yang dibuat ke layanan atau kolom ini akan menampilkan error.

Tindakan yang disarankan:

Jenis Aplikasi Terinstal dan Perangkat Seluler Baru GoogleAudience 20 Mei 2023

Linimasa:

  • 20 Mei 2023: Anda tidak akan dapat lagi menetapkan resource GoogleAudience dengan GoogleAudienceType GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS atau GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES ke penargetan audiens item baris atau perintah penyisipan. Permintaan yang menetapkan audiens ini ke penargetan audiens item baris akan menampilkan error. Hal ini mencakup permintaan advertisers.lineItems.duplicate dan advertisers.lineItems.generateDefault, jika item baris yang dibuat akan menyertakan audiens yang tidak digunakan lagi dalam penargetan audiensnya.
  • 8 Juni 2023: Audiens yang terpengaruh akan dihapus dari semua penargetan item baris dan perintah penyisipan serta dari semua audiens gabungan. Jika item baris tidak dapat menayangkan iklan saat audiens ini dihapus, item baris tersebut akan dijeda. Pada tanggal ini, audiens tersebut juga tidak akan dapat diambil lagi menggunakan layanan googleAudiences.

Tugas yang Direkomendasikan:

  • Sebaiknya segera hentikan penggunaan audiens yang terpengaruh saat melakukan pembaruan penargetan item baris pada masa mendatang.
  • Hapus semua audiens yang terpengaruh dari penargetan item baris dan perjanjian pemasangan iklan yang ada. Baca tentang cara memperbarui penargetan audiens dalam panduan Target Audiens kami.
Jenis FirstAndThirdPartyAudience Berbasis Aktivitas dan Pembatasan Frekuensi 20 Mei 2023

Linimasa:

  • 20 Mei 2023: Anda tidak akan dapat lagi menetapkan resource FirstAndThirdPartyAudience dengan AudienceType ACTIVITY_BASED atau FREQUENCY_CAP ke penargetan audiens item baris atau perintah penyisipan. Permintaan yang menetapkan audiens ini ke penargetan audiens item baris akan menampilkan error. Hal ini mencakup permintaan advertisers.lineItems.duplicate dan advertisers.lineItems.generateDefault, jika item baris yang dibuat akan menyertakan audiens yang tidak digunakan lagi dalam penargetan audiensnya.
  • 8 Juni 2023: Audiens yang terpengaruh akan dihapus dari semua penargetan item baris dan perintah penyisipan serta dari semua audiens gabungan. Jika item baris tidak dapat menayangkan iklan saat audiens ini dihapus, item baris tersebut akan dijeda. Pada tanggal ini, audiens tersebut juga tidak akan dapat diambil lagi menggunakan layanan firstAndThirdPartyAudiences.

Tugas yang Direkomendasikan:

  • Sebaiknya segera hentikan penggunaan audiens yang terpengaruh saat melakukan pembaruan penargetan item baris pada masa mendatang.
  • Hapus semua audiens yang terpengaruh dari penargetan item baris dan perjanjian pemasangan iklan yang ada. Baca tentang cara memperbarui penargetan audiens dalam panduan Target Audiens kami.
Batas Kuota API yang Ada 30 Mei 2023

Pada 30 Mei 2023, batas penggunaan yang ada akan diganti dengan struktur kuota hybrid yang melakukan hal berikut:

  1. Menghilangkan kuota permintaan per hari per project.
  2. Menetapkan kuota permintaan per menit per pengiklan per project untuk metode yang memenuhi syarat.

Batas baru ini akan memberikan fleksibilitas yang lebih besar dalam penggunaan API dan memungkinkan paralelisme permintaan di seluruh pengiklan. Detail perubahan ini ada dalam dokumentasi batas kuota yang ada.

Penggunaan operator OR antara batasan kolom yang berbeda dalam filter LIST

21 Juni 2023

Mulai 21 Juni 2023, parameter permintaan LIST filter tidak akan lagi mengizinkan penggunaan operator logika OR di antara batasan kolom yang berbeda.

Misalnya, resource yang diidentifikasi dengan string filter lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" harus diambil menggunakan dua permintaan LIST dengan string filter berikut:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

Lihat panduan cara memfilter permintaan LIST kami untuk mengetahui detail selengkapnya tentang batasan operator logis.

Tinjau parameter kueri filter dari semua panggilan LIST yang ada dan pastikan parameter tersebut menggunakan operator logika OR dengan benar sebelum 21 Juni 2023 untuk menghindari gangguan layanan.

Kemampuan untuk memfilter atau mengurutkan permintaan daftar berdasarkan kolom budget.budget_segments.date_range.end_date dan flight.dateRange.endDate

Tanggal Mulai Berlaku Awal diperbarui

21 Juni 2023

Pada 21 Juni 2023, budget.budget_segments.date_range.end_date dan flight.dateRange.endDate tidak akan lagi menjadi kolom yang diterima di parameter kueri filter dan orderBy advertisers.insertionOrders.list dan advertisers.lineItems.list. Setelah tanggal ini, permintaan yang menggunakan kolom ini dalam parameter kueri filter dan orderBy akan menampilkan error.

Hapus semua logika filter dan urutan menggunakan dua kolom ini sebelum 21 Juni 2023 untuk menghindari gangguan layanan.

Kemampuan untuk memfilter permintaan advertisers.lineItems.list berdasarkan empat kolom tambahan 21 Juni 2023

Pada 21 Juni 2023, advertisers.lineItems.list tidak lagi mendukung pemfilteran menurut kolom berikut:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Hapus semua logika filter menggunakan keempat kolom ini sebelum 21 Juni 2023 untuk menghindari gangguan layanan.

Pembelian berbasis hasil 1 Agustus 2023

Pada 1 Agustus 2023, pesanan pemasangan iklan yang menggunakan pembelian berbasis hasil, yang ditentukan oleh nilai kolom billableOutcome BILLABLE_OUTCOME_PAY_PER_CLICK atau BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, dan item baris turunannya akan diarsipkan.

Perubahan ini akan memengaruhi permintaan berikut:

Kolom publisherReviewStatuses di referensi materi iklan 26 Juni 2024

Mulai 26 Juni 2024, kolom publisherReviewStatuses akan dihentikan dan akan kosong saat mengambil resource Creative.

Penargetan konten untuk item baris YouTube & Partner 30 September 2024

Pada 30 September 2024, nilai berikut untuk jenis penargetan yang diidentifikasi tidak akan tersedia lagi untuk item baris YouTube & Partner:

Opsi penargetan yang tidak digunakan lagi akan otomatis dihapus dari penargetan item baris yang ada. Nilai ini akan tetap tersedia untuk digunakan dalam penargetan tingkat pengiklan.

Untuk menghindari gangguan layanan, hapus penargetan ini dari item baris YouTube & Partner yang ada sebelum tanggal penghentian.

Audiens pihak pertama dan ketiga Oracle 30 September 2024

Pada 30 September 2024, sumber daya FirstAndThirdPartyAudience yang bersumber dari Oracle akan dihentikan. Setelah penghentian, audiens ini akan dihapus dari penargetan resource dan audiens gabungan yang ada. Jika item baris hanya menargetkan audiens yang tidak lagi didukung atau menargetkan audiens yang tidak lagi didukung secara negatif, item baris tersebut akan otomatis dijeda.

Untuk menghindari gangguan layanan, identifikasi dan hapus semua audiens Oracle dari penargetan audiens item baris dan audiens gabungan yang ada sebelum tanggal penghentian.

Penargetan yang dioptimalkan item baris untuk subkumpulan strategi bidding 30 September 2024

Pada 30 September 2024, aset LineItem yang menggunakan sebagian strategi bidding tidak akan lagi kompatibel dengan penargetan yang dioptimalkan. Dengan perubahan ini, resource LineItem dengan targetingExpansion.enableOptimizedTargeting yang ditetapkan ke True dan bidStrategy.maximizeSpendAutoBid.performanceGoalType yang ditetapkan ke BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN, atau BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED atau bidStrategy.performanceGoalAutoBid.performanceGoalType yang ditetapkan ke BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM akan diperbarui untuk menetapkan targetingExpansion.enableOptimizedTargeting ke False.

Untuk menghindari gangguan layanan, perbarui dan pastikan item baris Anda yang menggunakan strategi bidding ini tidak mengaktifkan penargetan yang dioptimalkan.

Segera tayang Pacing untuk pesanan pemasangan iklan 5 November 2024

Pada 5 November 2024, PACING_TYPE_ASAP tidak akan lagi kompatibel dengan PACING_PERIOD_FLIGHT saat menyetel kolom urutan penyisipan pacing. pacingType untuk semua pesanan pemasangan yang ada dengan konfigurasi ini akan diperbarui menjadi PACING_TYPE_AHEAD.

Untuk menghindari gangguan layanan, perbarui pacing dari semua perintah penyisipan yang ada menggunakan PACING_TYPE_ASAP dan PACING_PERIOD_FLIGHT.

Periode pembatasan frekuensi lebih dari 30 hari 28 Februari 2025

Pada 28 Februari 2025:

  • Permintaan yang membuat atau memperbarui resource LineItem, InsertionOrder, dan Campaign untuk menggunakan objek FrequencyCap dengan kolom timeUnit yang ditetapkan ke TIME_UNIT_LIFETIME atau kolom timeUnit yang ditetapkan ke TIME_UNIT_MONTH dan kolom timeUnitCount yang ditetapkan ke 2 akan menampilkan error 400.
  • Entri di File Data Terstruktur Item Baris, Perjanjian Pemasangan Iklan, dan Kampanye dengan nilai kolom "Periode Frekuensi" "Seumur Hidup" atau nilai kolom "Periode Frekuensi" "Bulan" dan nilai kolom "Jumlah Frekuensi" "2" tidak akan dapat dibuat atau diperbarui saat upload file.
  • Kampanye, pesanan pemasangan iklan, dan item baris yang ada akan diperbarui untuk menggunakan periode pembatasan frekuensi 30 hari atau kurang.

Untuk menghindari gangguan layanan:

  • Perbarui kampanye, pesanan pemasangan iklan, dan resource item baris yang ada yang menggunakan periode pembatasan frekuensi lebih dari 30 hari menjadi 30 hari atau kurang.
  • Pastikan integrasi Anda tidak menetapkan periode batas frekuensi lebih dari 30 hari saat membuat atau memperbarui resource kampanye, perjanjian pemasangan iklan, atau item baris menggunakan Display & Video 360 API atau File Data Terstruktur.
Penargetan yang dioptimalkan untuk item baris menggunakan bidding tetap 6 Maret 2025

Pada 6 Maret 2025:

  • Permintaan yang membuat atau memperbarui resource LineItem untuk menyetel kolom BiddingStrategy fixedBid dan kolom TargetingExpansionConfig enableOptimizedTargeting ke benar akan menampilkan error 400.
  • Entri di File Data Terstruktur Item Baris dengan nilai kolom "Jenis Strategi Bidding" "Tetap" dan nilai kolom "Penargetan yang Dioptimalkan" "Benar" akan gagal dibuat atau diperbarui saat upload file.
  • Item baris yang ada yang menggunakan bidding tetap akan diperbarui untuk menonaktifkan penargetan yang dioptimalkan.

Untuk menghindari gangguan layanan:

  • Perbarui resource item baris yang ada yang menggunakan bidding tetap dan penargetan yang dioptimalkan.
  • Pastikan integrasi Anda tidak menetapkan strategi bidding tetap dan penargetan yang dioptimalkan saat membuat atau memperbarui resource item baris menggunakan Display & Video 360 API atau File Data Terstruktur.
Perubahan pada ukuran halaman default firstAndThirdPartyAudiences.list 6 Maret 2025

Pada 6 Maret 2025, ukuran halaman default untuk permintaan firstAndThirdPartyAudiences.list akan diperbarui dari 100 menjadi 5.000.

Agar layanan tidak terganggu, perbarui integrasi Anda untuk menyetel parameter kueri pageSize permintaan firstAndThirdPartyAudiences.list ke ukuran halaman pilihan Anda.

Error ketidakcocokan partner/pengiklan sdfdownloadtasks.create baru 6 Maret 2025

Pada 6 Maret 2025, permintaan sdfdownloadtasks.create yang menggunakan filter entity induk untuk memfilter menurut pengiklan yang bukan turunan dari partnerId yang ditetapkan akan mulai menampilkan error 400.

Pembatasan item baris Jangkauan YouTube di SDF 24 Maret 2025

Pada 24 Maret 2025, File Data Terstruktur akan mewajibkan penggunaan format iklan yang lebih luas saat membuat atau memperbarui item baris. Itu artinya:

  • SDF v6 dan v7 tidak lagi mendukung pembuatan entri file Item Baris baru dengan nilai Subtype "Jangkauan".
  • Entri baru dalam file Item Baris SDF dengan nilai Subtype "Jangkauan" harus menggunakan nilai "Responsif" di kolom TrueView Video Ad Formats. Entri yang sudah ada dengan nilai Subtype "Jangkauan" tidak dapat memperbarui nilai kolom TrueView Video Ad Formats.
  • Entri baru dalam file Item Baris SDF dengan nilai Subtype "Jangkauan" memerlukan pengisian kolom TrueView Video Ad Inventory Control.
Algoritma bidding kustom dan aktivitas Floodlight tidak cocok 1 April 2025

Pada 1 April 2025:

Untuk menghindari gangguan layanan, perbarui integrasi Anda ke:

  • Verifikasi bahwa aktivitas Floodlight yang relevan ditetapkan ke item baris sebelum atau pada saat yang sama dengan penetapan algoritma bidding kustom.
  • Algoritma bidding kustom yang ada tidak ditetapkan dari semua item baris sebelum mencoba diperbarui.

Durasi keanggotaan tanpa batas untuk audiens pihak pertama 7 April 2025

Pada 7 April 2025, resource FirstAndThirdPartyAudience tidak akan lagi mengizinkan durasi keanggotaan audiens yang tidak terbatas. Permintaan firstAndThirdPartyAudiences.create dan firstAndThirdPartyAudiences.patch yang menyetel nilai kolom membershipDurationDays menjadi 10.000 akan menampilkan error 400. Audiens lama dengan nilai kolom membershipDurationDays sebesar 10.000 akan diperbarui menjadi 540 dan durasi keanggotaan baru akan diterapkan secara surut ke keanggotaan lama. Tindakan ini akan mengakhiri semua keanggotaan yang sudah lebih dari 540 hari.

Untuk menghindari gangguan layanan:

  • Pastikan integrasi Anda tidak menyetel nilai kolom membershipDurationDays audiens baru atau yang sudah ada ke 10.000.
  • Perbarui keanggotaan audiens Customer Match yang ada menggunakan firstAndThirdPartyAudiences.editCustomerMatchMembers.
  • Perbarui keanggotaan audiens Customer Match Anda secara rutin untuk memastikan ukuran daftar audiens Anda tidak berkurang secara tidak sengaja.

Di v4, perubahan ini tercermin dalam resource FirstPartyAndPartnerAudience.

Kampanye tindakan video dalam File Data Terstruktur 22 April 2025

Mulai 22 April 2025, Anda tidak akan dapat lagi membuat Item baris untuk kampanye tindakan video menggunakan File Data Terstruktur, karena kampanye tersebut akan diupgrade ke Peningkat Permintaan. Entri Item baris yang mencoba diupload dengan nilai kolom Subtype "Tindakan" dan nilai kolom Type "TrueView" akan gagal.

Untuk menghindari gangguan layanan, perbarui integrasi Anda agar menggunakan Peningkat Permintaan, bukan kampanye tindakan video.

Mewajibkan sumber inventaris partner video untuk Item baris Peningkat Permintaan dalam File Data Terstruktur 22 April 2025

Mulai 22 April 2025, Anda akan diwajibkan untuk menyertakan nilai "Partner Video" di kolom TrueView Inventory Source Targeting pada entri item baris yang memiliki nilai kolom Type "Peningkat Permintaan". Setelah pemberlakuan ini dimulai, nilai akan diisi ulang untuk item baris yang ada dan disertakan saat mendownload File Data Terstruktur baru.

Untuk menghindari gangguan layanan:

  • Perbarui integrasi Anda untuk menyertakan nilai "Partner Video" di semua entri item baris Peningkat Permintaan.
  • Perbarui integrasi Anda untuk mengelola sumber inventaris Peningkat Permintaan di tingkat Grup Iklan menggunakan kolom Grup Iklan SDF v8.1 Demand Gen Inventory Source Strategy dan Demand Gen Enabled Inventory Sources.
Kolom "Pengali Bid" dalam File Data Terstruktur Item Baris 1 Mei 2025

Pada 1 Mei 2025, entri di File Data Terstruktur Item Baris yang mencoba menyetel kolom "Pengali Bid" akan gagal membuat atau memperbarui resource saat mengupload file.

Setelan Kategori Konten untuk Item Baris YouTube & partner 12 Juni 2025

Pada 12 Juni 2025, konfigurasi kategori konten untuk setiap item baris YouTube & partner tidak akan dapat diubah lagi sebagai bagian dari update pada pengalaman kesesuaian merek. Setelan kategori konten akan dikontrol sepenuhnya di tingkat pengiklan. Untuk mengakomodasi perubahan ini, perubahan berikut akan dilakukan pada API Display & Video 360 dan File Data Terstruktur:

Untuk menghindari gangguan layanan:
Pembaruan anggaran item baris dengan pengoptimalan perjanjian pemasangan iklan 12 Juni 2025

Mulai 12 Juni 2025, Anda tidak akan dapat lagi memperbarui setelan anggaran untuk item baris dengan pesanan pemasangan induk yang ditetapkan untuk dioptimalkan menggunakan strategi bidding otomatis.

Untuk menghindari gangguan layanan:
Batasan situs untuk File Data Terstruktur 12 Juni 2025

Mulai 12 Juni 2025, kami akan menghapus pembatasan yang ada untuk URL yang ditargetkan dalam entri SDF yang membatasi situs yang lebih baru agar tidak disertakan. Sebagai gantinya, SDF akan mencocokkan perilaku API dan UI serta memungkinkan penargetan URL selama URL tersebut diformat dengan benar.

Hal ini relevan dengan kolom Site Targeting - Include dan Site Targeting - Exclude dalam file Perjanjian Pemasangan Iklan dan Item Baris.
Nyatakan apakah item baris menayangkan iklan politik Uni Eropa 8 September 2025

Mulai 8 September 2025, Anda akan diwajibkan untuk menyatakan apakah item baris akan menayangkan iklan politik Uni Eropa atau tidak saat membuat item baris baru menggunakan Display & Video 360 API atau SDF. Pernyataan ini dapat dibuat dengan cara berikut:

Jika pengiklan induk Anda tidak akan berisi item baris yang menayangkan iklan politik Uni Eropa, Anda dapat menyatakan di tingkat pengiklan menggunakan kolom containsEuPoliticalAds di resource Advertiser Display & Video 360 API. Jika kolom ini disetel ke DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, semua item baris baru di bawah pengiklan akan diberi nilai yang sama jika tidak ditentukan lain dan semua item baris yang ada di bawah pengiklan akan diperbarui untuk menggunakan nilai yang sama jika nilai belum ditetapkan. Pernyataan item baris dapat diperbarui kapan saja setelah dibuat menggunakan UI, API, atau SDF.

Jika Anda tidak dapat mendeklarasikan di tingkat pengiklan atau telah menyatakan bahwa iklan politik Uni Eropa dapat ditayangkan di bawah pengiklan Anda, perbarui integrasi SDF dan API Display & Video 360 sebelum 8 September 2025 untuk menghindari gangguan layanan: