Mengumumkan Penghentian

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 tersebut 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 ini atau ke kolom ini akan menampilkan error.

Tindakan yang disarankan:

• Segera hentikan penggunaan pemicu manual untuk memulai dan menghentikan penayangan item baris.
• Berhenti membuat permintaan ke layanan advertisers.manualTriggers.
• Perbarui kolom flight.flightDateType dan flight.triggerId untuk semua item baris menggunakan pemicu manual.

Linimasa:

• 20 Mei 2023: Anda tidak 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 pesanan pemasangan iklan. 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 pesanan pemasangan iklan 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 ini juga tidak akan dapat diambil lagi menggunakan layanan googleAudiences.

Tugas yang Direkomendasikan:

• Sebaiknya segera hentikan penggunaan audiens yang terpengaruh saat melakukan pembaruan pada penargetan item baris di masa mendatang.
• Hapus semua audiens yang terpengaruh dari penargetan item baris dan perjanjian pemasangan iklan yang ada. Baca cara memperbarui penargetan audiens di panduan Target Audiens.

Linimasa:

• 20 Mei 2023: Anda tidak dapat lagi menetapkan resource FirstAndThirdPartyAudience dengan AudienceType ACTIVITY_BASED atau FREQUENCY_CAP ke penargetan audiens item baris atau pesanan pemasangan iklan. 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 pesanan pemasangan iklan 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 ini juga tidak akan dapat diambil lagi menggunakan layanan firstAndThirdPartyAudiences.

Tugas yang Direkomendasikan:

• Sebaiknya segera hentikan penggunaan audiens yang terpengaruh saat melakukan pembaruan pada penargetan item baris di masa mendatang.
• Hapus semua audiens yang terpengaruh dari penargetan item baris dan perjanjian pemasangan iklan yang ada. Baca cara memperbarui penargetan audiens di panduan Target Audiens.

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

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

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

Pada 21 Juni 2023, parameter filter permintaan LIST tidak akan lagi mengizinkan operator logika OR digunakan di antara batasan berbagai kolom.

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 untuk mengetahui detail selengkapnya tentang batasan operator logika.

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.

Tanggal Mulai Berlaku Awal diperbarui

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 di 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.

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

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

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

Pada 1 Agustus 2023, pesanan penyesuaian 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:

• Mencoba menggunakan advertisers.insertionOrders.create untuk membuat pesanan pemasangan menggunakan pembelian berbasis hasil akan menampilkan error 400
• Mencoba menggunakan advertisers.lineItems.create, advertisers.lineItems.duplicate, atau advertisers.lineItems.generateDefault untuk membuat item baris dalam perjanjian pemasangan iklan menggunakan pembelian berbasis hasil akan menampilkan error 400
• Mengingat resource yang diarsipkan tidak disertakan dalam permintaan LIST secara default, resource yang terpengaruh tidak akan ditampilkan lagi oleh metode advertisers.insertionOrders.list dan advertisers.lineItems.list secara default.

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

Pada 30 September 2024, nilai berikut untuk jenis penargetan yang diidentifikasi akan dihentikan untuk item baris YouTube & Partners:

• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION:
• CONTENT_RATING_TIER_UNRATED
• CONTENT_RATING_TIER_GENERAL
• CONTENT_RATING_TIER_PARENTAL_GUIDANCE
• CONTENT_RATING_TIER_TEENS
• CONTENT_RATING_TIER_MATURE
• CONTENT_RATING_TIER_FAMILIES
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

Opsi penargetan penghentian penggunaan 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.

Pada 30 September 2024, sumber resource FirstAndThirdPartyAudience 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 dihentikan atau menargetkan audiens yang dihentikan secara negatif, pembaruan ini akan otomatis menjeda item baris tersebut.

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

Pada 30 September 2024, resource LineItem yang menggunakan sebagian strategi bidding tidak akan lagi kompatibel dengan penargetan yang dioptimalkan. Dengan perubahan ini, resource LineItem dengan targetingExpansion.enableOptimizedTargeting ditetapkan ke True dan bidStrategy.maximizeSpendAutoBid.performanceGoalType 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 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.

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

Untuk menghindari gangguan layanan, perbarui pacing pesanan penyisipan yang ada menggunakan PACING_TYPE_ASAP dan PACING_PERIOD_FLIGHT.

Pada 28 Februari 2025:

• Permintaan yang membuat atau memperbarui resource LineItem, InsertionOrder, dan Campaign untuk menggunakan objek FrequencyCap dengan kolom timeUnit ditetapkan ke TIME_UNIT_LIFETIME atau kolom timeUnit ditetapkan ke TIME_UNIT_MONTH dan kolom timeUnitCount ditetapkan ke 2 akan menampilkan error 400.
• Entri dalam File Data Terstruktur Item Baris, Pesanan Penempatan Iklan, dan Kampanye dengan nilai kolom "Frequency Period" "Lifetime" atau nilai kolom "Frequency Period" "Months" dan nilai kolom "Frequency Amount" "2" akan gagal dibuat atau diperbarui saat file diupload.
• Kampanye, pesanan pemasangan iklan, dan item baris yang ada akan diperbarui untuk menggunakan periode batas frekuensi 30 hari atau kurang.

Untuk menghindari gangguan layanan:

• Perbarui resource kampanye, pesanan pemasangan iklan, dan item baris yang ada yang menggunakan periode pembatasan frekuensi lebih dari 30 hari menjadi 30 hari atau kurang.
• Pastikan integrasi Anda tidak menetapkan periode pembatasan 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.

Pada 6 Maret 2025:

• Permintaan yang membuat atau memperbarui resource LineItem untuk menetapkan kolom BiddingStrategy fixedBid dan kolom TargetingExpansionConfig enableOptimizedTargeting ke benar akan menampilkan error 400.
• Entri dalam File Data Terstruktur Item Baris dengan nilai kolom "Bid Strategy Type" "Fixed" dan nilai kolom "Optimized Targeting" "True" akan gagal dibuat atau diperbarui saat file diupload.
• 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.

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

Untuk menghindari gangguan layanan, perbarui integrasi Anda untuk menetapkan parameter kueri pageSize dari permintaan firstAndThirdPartyAudiences.list ke ukuran halaman yang Anda inginkan.

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

Pada 1 April 2025:

• Permintaan advertisers.lineItems.create yang mencoba menetapkan kolom floodlightActivityConfigs dari objek ConversionCountingConfig dan kolom customBiddingAlgorithmId dari objek MaximizeSpendBidStrategy atau PerformanceGoalBidStrategy yang tidak menggunakan aktivitas floodlight yang cocok akan menampilkan error 400.
• Permintaan advertisers.lineItems.patch yang mencoba memperbarui kolom floodlightActivityConfigs dari objek ConversionCountingConfig saat kolom customBiddingAlgorithmId dari objek MaximizeSpendBidStrategy atau PerformanceGoalBidStrategy ditetapkan akan menampilkan error 400.
• Entri dalam File Data Terstruktur Item Baris yang mencoba memperbarui kolom "Conversion Floodlight Activity Ids" saat kolom "Algorithm Id" ditetapkan akan gagal diperbarui saat file diupload.
• Permintaan customBiddingAlgorithms.patch, customBiddingAlgorithms.rules.create, customBiddingAlgorithms.scripts.create untuk resource CustomBiddingAlgorithm yang ditetapkan ke item baris akan menampilkan error.

Untuk menghindari gangguan layanan, perbarui integrasi Anda ke:

• Verifikasi bahwa aktivitas floodlight yang relevan ditetapkan ke item baris sebelum atau bersamaan dengan penetapan algoritma bidding kustom.
• Algoritma bidding kustom yang ada akan dibatalkan penetapannya dari semua item baris sebelum mencoba diperbarui.

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

Untuk menghindari gangguan layanan:

• Pastikan integrasi Anda tidak menetapkan 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 secara rutin untuk memastikan ukuran daftar audiens Anda tidak menjadi lebih kecil secara tidak sengaja.

Pada 1 Mei 2025, entri dalam File Data Terstruktur Item Baris yang mencoba menetapkan kolom "Bid Multipliers" akan gagal membuat atau memperbarui resource saat file diupload.