Mengumumkan Penghentian

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

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

Penghentian Versi

Versi Display & Video 360 API dirilis, tidak digunakan lagi, dan dihentikan secara rutin. Langkah-langkah ini ditentukan sebagai berikut:

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

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

Versi API Release Date Tanggal Penghentian Penggunaan Tanggal Penghentian Panduan Migrasi
v3 31 Oktober 2023
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 Fitur

Ikuti blog developer Google Ads untuk mengetahui pengumuman penghentian fitur signifikan yang akan datang.

Tabel di bawah mencantumkan semua penghentian fitur yang diumumkan, yang memberikan tanggal mulai berlaku dan deskripsi penghentian 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, diluncurkan secara bertahap dari 25 Maret 2023 hingga awal Mei 2023. Perubahan yang relevan pada perilaku Display & Video 360 API dan File Data Terstruktur serta tindakan yang disarankan 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 untuk layanan ini atau ke 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 lagi dapat menetapkan resource GoogleAudience dengan GoogleAudienceType GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS atau GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES ke penargetan audiens pesanan pemasangan iklan atau item baris. Permintaan yang menetapkan audiens ini ke penargetan audiens item baris akan menampilkan error. 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 perjanjian pemasangan iklan, serta dari semua audiens gabungan. Jika item baris tidak dapat menayangkan iklan saat audiens ini dihapus, audiens tersebut akan dijeda. Pada tanggal ini, audiens tersebut juga tidak lagi dapat diambil menggunakan layanan googleAudiences.

Tugas yang Direkomendasikan:

  • Sebaiknya segera hentikan penggunaan audiens yang terpengaruh saat melakukan perubahan berikutnya pada penargetan item baris Anda.
  • Hapus semua audiens yang terpengaruh dari penargetan pesanan pemasangan iklan dan item baris yang sudah ada. Baca cara memperbarui penargetan audiens di panduan Audiens Target.
Jenis Berbasis Aktivitas dan Batas Frekuensi FirstAndThirdPartyAudience 20 Mei 2023

Linimasa:

  • 20 Mei 2023: Anda tidak akan lagi dapat menetapkan resource FirstAndThirdPartyAudience dengan AudienceType ACTIVITY_BASED atau FREQUENCY_CAP ke penargetan audiens pesanan pemasangan iklan atau item baris. Permintaan yang menetapkan audiens ini ke penargetan audiens item baris akan menampilkan error. 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 perjanjian pemasangan iklan, serta dari semua audiens gabungan. Jika item baris tidak dapat menayangkan iklan saat audiens ini dihapus, audiens tersebut akan dijeda. Pada tanggal ini, audiens tersebut juga tidak lagi dapat diambil menggunakan layanan firstAndThirdPartyAudiences.

Tugas yang Direkomendasikan:

  • Sebaiknya segera hentikan penggunaan audiens yang terpengaruh saat melakukan perubahan berikutnya pada penargetan item baris Anda.
  • Hapus semua audiens yang terpengaruh dari penargetan pesanan pemasangan iklan dan item baris yang sudah ada. Baca cara memperbarui penargetan audiens di panduan Audiens Target.
Batas Kuota API yang Ada 30 Mei 2023

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

  1. Mengurangi kuota permintaan per hari per project.
  2. Menyiapkan 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 paralelisasi permintaan di seluruh pengiklan. Detail perubahan ini ada di dokumentasi batas kuota yang ada.

Penggunaan operator OR di antara batasan kolom yang berbeda dalam filter LIST

21 Juni 2023

Mulai 21 Juni 2023, LIST meminta parameter filter tidak akan lagi mengizinkan operator logika OR digunakan 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 logika.

Tinjau parameter kueri filter dari semua panggilan LIST yang ada dan pastikan operator 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, kolom budget.budget_segments.date_range.end_date dan flight.dateRange.endDate tidak akan lagi diterima di parameter kueri advertisers.insertionOrders.list dan advertisers.lineItems.list filter serta orderBy. Setelah tanggal ini, permintaan yang menggunakan kolom ini di parameter kueri filter dan orderBy akan menampilkan error.

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

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

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

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Hapus semua logika filter yang 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 sebesar BILLABLE_OUTCOME_PAY_PER_CLICK atau BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, dan item baris turunannya akan diarsipkan.

Perubahan ini akan memengaruhi permintaan berikut: