Kullanımdan Kaldırılanlar Özelliğinin Duyurusu

Bu sayfada, Display & Video 360 API'deki API sürümlerinin ve tekil özelliklerin desteğinin sonlandırılma ve kullanımdan kaldırılma tarihleri listelenmiştir.

API'nin desteğinin sonlandırılması ve kullanımdan kaldırılma tarihleri Google Ads geliştirici blogunda da duyurulacaktır.

Kullanımdan Kaldırılan Sürümler

Display & Video 360 API sürümleri düzenli olarak yayınlanır, desteği sonlandırılır ve kullanımdan kaldırılır. Bu adımlar aşağıdaki şekilde tanımlanır:

  • Sürüm: Sürüm, alfa veya beta durumundan çıkar ve kararlı olarak kabul edilir. Sürüm için yeni özellikler eklenmeye devam edebilir.
  • Desteğin sonlandırılması: Sürüm kullanımdan kaldırılıyor ve desteğin sonlandırılacağı (sonlandırma) tarih duyurulur. Kullanıcıların, desteğin sonlandırılacağı tarihten önce daha yeni bir sürüme geçmesi gerekir. Bu sürüm için artık özellik eklenmeyecek.
  • Sonlandırıldı: Sürüm artık desteklenmiyor. Sürüme yapılan istekler hata döndürür.

Aşağıdaki tabloda, mevcut tüm temel Display & Video 360 API sürümleri, sürüm tarihleri ve kullanımdan kaldırılma tarihleri (duyurulmuşsa) listelenmiştir.

API Sürümü Yayın Tarihi Kullanımdan Kaldırma Tarihi Kullanımdan kaldırma tarihi Taşıma Rehberi
v3 31 Ekim 2023
v2 6 Aralık 2022 15 Şubat 2024 3 Eylül 2024 v2'den v3'e taşıma
v1 9 Mart 2020 13 Mart 2023 14 Eylül 2023 v1'den v2'ye taşıma

Özellik Kullanımdan Kaldırma İşlemleri

Önemli özelliklerin kullanımdan kaldırılmasıyla ilgili duyurular için Google Ads geliştirici blogumuzu takip edin.

Aşağıdaki tabloda, kullanımdan kaldırıldığı duyurulan tüm özellikler listelenmiştir. İlk geçerlilik tarihi ve kullanımdan kaldırılmayla ilgili açıklama, önerilen işlemler ve ilgili dokümanların bağlantıları da tabloda yer almaktadır:

Özellik İlk Geçerlilik Tarihi Açıklama
Hedefleme Genişletmesi 25 Mart 2023 Hedefleme genişletmesi özelliğinin optimize hedefleme ile değiştirilmesi, 25 Mart 2023'ten Mayıs 2023'ün başlarına kadar kademeli olarak kullanıma sunulacak. Display & Video 360 API ve Yapılandırılmış Veri Dosyaları davranışıyla ilgili değişikliklerin yanı sıra önerilen işlemler bir blog yayınında duyuruldu.
Manuel Tetikleyiciler 17 Mayıs 2023

Zaman çizelgesi:

  • 17 Mayıs 2023: Manuel tetikleyiciler kullanan satır öğelerinin Display & Video 360'ta yayınlanması durdurulacak. Etkin bir satır öğesine bağlı manuel bir tetikleyiciyi bu tarihten sonra etkinleştirirseniz satır öğesi reklam yayınlamaz.
  • 1 Ağustos 2023: DV360 API v1 ve v2'deki advertisers.manualTriggers hizmeti, DV360 API v1'deki LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER enum değeri ve DV360 API v1'deki LineItemFlight.triggerId alanı kullanımdan kaldırılacak. Bu tarihten sonra bu hizmetlere veya alanlara yapılan istekler hata döndürür.

Önerilen işlemler:

Yüklü Uygulama ve Yeni Mobil Cihaz GoogleAudience Türleri 20 Mayıs 2023

Zaman çizelgesi:

  • 20 Mayıs 2023: Satır öğesi veya kampanya siparişi kitle hedeflemesine GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS veya GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES GoogleAudienceType değerine sahip GoogleAudience kaynakları atayamayacaksınız. Bu kitleleri bir satır öğesinin kitle hedeflemesine atayan istekler hata döndürür. Oluşturulan satır öğesi, kitle hedeflemesinde desteği sonlandırılmış kitleleri içeriyorsa advertisers.lineItems.duplicate ve advertisers.lineItems.generateDefault istekleri de buna dahildir.
  • 8 Haziran 2023: Etkilenen kitleler tüm satır öğesi ve kampanya siparişi hedeflemesinden ve tüm birleştirilmiş kitlelerden kaldırılacak. Bu kitleler kaldırıldığında bir satır öğesi reklam yayınlayamıyorsa duraklatılır. Bu tarihten itibaren bu kitleler googleAudiences hizmeti kullanılarak da alınamayacak.

Önerilen Görevler:

  • Satır öğesi hedeflemenizde gelecekte güncelleme yaparken etkilenen kitleleri hemen kullanmayı bırakmanızı öneririz.
  • Etkilenen tüm kitleleri mevcut satır öğesi ve kampanya siparişi hedeflemesinden kaldırın. Kitle hedeflemeyi güncelleme hakkında bilgi edinmek için Hedef Kitleler kılavuzumuzu inceleyin.
Etkinliğe Dayalı ve Sıklık Sınırı FirstAndThirdPartyAudience Türleri 20 Mayıs 2023

Zaman çizelgesi:

  • 20 Mayıs 2023: Satır öğesi veya kampanya siparişi kitle hedeflemesine ACTIVITY_BASED veya FREQUENCY_CAP AudienceType değerine sahip FirstAndThirdPartyAudience kaynakları atayamayacaksınız. Bu kitleleri bir satır öğesinin kitle hedeflemesine atayan istekler hata döndürür. Oluşturulan satır öğesi, kitle hedeflemesinde desteği sonlandırılmış kitleleri içeriyorsa advertisers.lineItems.duplicate ve advertisers.lineItems.generateDefault istekleri de buna dahildir.
  • 8 Haziran 2023: Etkilenen kitleler tüm satır öğesi ve kampanya siparişi hedeflemesinden ve tüm birleştirilmiş kitlelerden kaldırılacak. Bu kitleler kaldırıldığında bir satır öğesi reklam yayınlayamıyorsa duraklatılır. Bu tarihten itibaren bu kitleler firstAndThirdPartyAudiences hizmeti kullanılarak da alınamayacak.

Önerilen Görevler:

  • Satır öğesi hedeflemenizde gelecekte güncelleme yaparken etkilenen kitleleri hemen kullanmayı bırakmanızı öneririz.
  • Etkilenen tüm kitleleri mevcut satır öğesi ve kampanya siparişi hedeflemesinden kaldırın. Kitle hedeflemeyi güncelleme hakkında bilgi edinmek için Hedef Kitleler kılavuzumuzu inceleyin.
Mevcut API Kotası Sınırları 30 Mayıs 2023

Mevcut kullanım sınırları 30 Mayıs 2023'te aşağıdakileri yapan karma bir kota yapısıyla değiştirilecek:

  1. Proje başına günlük istek kotasını ortadan kaldırır.
  2. Uygun yöntemler için proje başına reklamveren başına dakikada istek sayısı kotası belirler.

Bu yeni sınırlar, API kullanımında daha fazla esneklik sağlayacak ve reklamverenler arasında isteklerin paralelleştirilmesini mümkün kılacaktır. Bu değişikliğin ayrıntıları mevcut kota sınırı belgemizde verilmiştir.

LIST filtrelerindeki farklı alanların kısıtlamaları arasında OR operatör kullanımı

21 Haziran 2023

21 Haziran 2023'ten itibaren LIST istek filter parametreleri, farklı alanların kısıtlamaları arasında OR mantıksal operatörlerin kullanılmasına izin vermeyecektir.

Örneğin, lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" filtre dizesiyle tanımlanan kaynaklar, aşağıdaki filtre dizelerini içeren iki LIST isteği kullanılarak alınmalıdır:

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

Mantıksal operatörlerin kısıtlamaları hakkında daha fazla bilgi için LIST isteklerini filtrelemeyle ilgili kullanım kılavuzumuza göz atın.

Hizmet kesintisi yaşamamak için mevcut tüm LIST çağrılarınızın filter sorgu parametrelerini inceleyin ve 21 Haziran 2023'ten önce VEYA mantıksal operatörünün doğru şekilde kullanıldığını doğrulayın.

Liste isteklerini budget.budget_segments.date_range.end_date ve flight.dateRange.endDate alanlarına göre filtreleme veya sıralama

İlk Geçerlilik Tarihi güncellendi

21 Haziran 2023

21 Haziran 2023'ten itibaren budget.budget_segments.date_range.end_date ve flight.dateRange.endDate, sırasıyla advertisers.insertionOrders.list ve advertisers.lineItems.list filter ve orderBy sorgu parametrelerinde kabul edilen alanlar olmayacak. Bu tarihten sonra, filter ve orderBy sorgu parametrelerinde bu alanları kullanan istekler hata döndürecektir.

Hizmet kesintisi yaşamamak için 21 Haziran 2023'ten önce bu iki alanı kullanan tüm filtre ve sıralama mantığını kaldırın.

advertisers.lineItems.list isteklerini dört ek alana göre filtreleme olanağı 21 Haziran 2023

21 Haziran 2023'ten itibaren advertisers.lineItems.list, aşağıdaki alanlara göre filtrelemeyi desteklemeyecektir:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Hizmet kesintisi yaşamamak için 21 Haziran 2023'ten önce bu dört alanı kullanan tüm filtre mantığını kaldırın.

Sonuca dayalı satın alma 1 Ağustos 2023

1 Ağustos 2023'te, BILLABLE_OUTCOME_PAY_PER_CLICK veya BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION değerine sahip bir billableOutcome alan değeriyle tanımlanan ve sonuça dayalı satın alma özelliğini kullanan kampanya siparişleri ile alt satır öğeleri arşivlenecek.

Bu değişiklik aşağıdaki istekleri etkileyecektir:

Reklam öğesi kaynaklarındaki publisherReviewStatuses alanı 26 Haziran 2024

26 Haziran 2024'ten itibaren publisherReviewStatuses alanı kullanımdan kaldırılacak ve Creative kaynakları alınırken boş olacaktır.

YouTube ve iş ortakları satır öğeleri için içerik hedefleme 30 Eylül 2024

30 Eylül 2024'te, tanımlanan hedefleme türleri için aşağıdaki değerler YouTube ve İş Ortakları satır öğelerinde kullanımdan kaldırılacaktır:

Kullanımdan kaldırılan hedefleme seçenekleri, mevcut satır öğesi hedeflemesinden otomatik olarak kaldırılacaktır. Bu değerler, reklamveren düzeyinde hedeflemede kullanılmaya devam edecektir.

Hizmet kesintisi olmaması için bu hedeflemeyi kullanımdan kaldırma tarihinden önce mevcut YouTube ve İş Ortakları satır öğelerinden kaldırın.

Oracle birinci ve üçüncü taraf kitleleri 30 Eylül 2024

Oracle'ın FirstAndThirdPartyAudience kaynak kaynakları 30 Eylül 2024'te kullanımdan kaldırılacak. Bu kitleler, kullanımdan kaldırıldıktan sonra mevcut tüm kaynak hedeflemelerinden ve birleşik kitlelerden kaldırılacak. Bir satır öğesi yalnızca desteği sonlandırılmış kitleleri hedefliyorsa veya desteği sonlandırılmış kitleleri negatif olarak hedefliyorsa bu güncelleme, söz konusu satır öğesini otomatik olarak duraklatır.

Hizmette kesinti yaşanmaması için Oracle kitlelerini kullanımdan kaldırma tarihinden önce tanımlayıp mevcut satır öğesi kitle hedeflemesinden ve birleştirilmiş kitlelerden kaldırın.

Teklif stratejilerinin bir alt kümesi için satır öğesi optimize hedefleme 30 Eylül 2024

30 Eylül 2024'ten itibaren, teklif stratejilerinin bir alt kümesini kullanan LineItem kaynakları optimize hedeflemeyle uyumlu olmayacaktır. Bu değişiklikle, targetingExpansion.enableOptimizedTargeting True, bidStrategy.maximizeSpendAutoBid.performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN veya BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED, bidStrategy.performanceGoalAutoBid.performanceGoalType ise BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM olarak ayarlanmış LineItem kaynakları targetingExpansion.enableOptimizedTargeting False olarak ayarlanacak şekilde güncellenecek.

Hizmette kesinti yaşanmaması için bu teklif stratejilerini kullanan satır öğelerinizi güncelleyin ve optimize hedeflemenin etkin olmadığından emin olun.

Kampanya siparişleri için Aralıklarla Reklam Yayını En Kısa Sürede Pacing 5 Kasım 2024

5 Kasım 2024'ten itibaren kampanya siparişi pacing alanı ayarlanırken PACING_TYPE_ASAP, PACING_PERIOD_FLIGHT ile uyumlu olmayacaktır. Bu yapılandırmaya sahip tüm mevcut kampanya siparişleri için pacingType, PACING_TYPE_AHEAD olarak güncellenecek.

Hizmet kesintisi yaşamamak için PACING_TYPE_ASAP ve PACING_PERIOD_FLIGHT'i kullanarak mevcut kampanya siparişlerinin pacing değerini güncelleyin.

30 günden uzun sıklık sınırı dönemi 28 Şubat 2025

28 Şubat 2025'te:

  • LineItem, InsertionOrder ve Campaign kaynaklarını, timeUnit alanı TIME_UNIT_LIFETIME olarak ayarlanmış veya timeUnit alanı TIME_UNIT_MONTH olarak ayarlanmış ve timeUnitCount alanı 2 olarak ayarlanmış bir FrequencyCap nesnesi kullanacak şekilde oluşturma veya güncelleme istekleri 400 hatası döndürür.
  • Satır Öğesi, Giriş Siparişi ve Kampanya Yapılandırılmış Veri Dosyalarında "Sıklık Dönemi" sütun değeri "Ömür Boyu" veya "Sıklık Dönemi" sütun değeri "Aylar" ve "Sıklık Miktarı" sütun değeri "2" olan girişler, dosya yüklendiğinde oluşturulamaz veya güncellenemez.
  • Mevcut kampanyalar, kampanya siparişleri ve satır öğeleri, 30 gün veya daha kısa bir sıklık sınırı dönemi kullanacak şekilde güncellenecek.

Hizmette kesinti yaşamamak için:

  • 30 günden uzun bir sıklık sınırı dönemi kullanan mevcut kampanya, kampanya siparişi ve satır öğesi kaynaklarını 30 gün veya daha kısa olacak şekilde güncelleyin.
  • Entegrasyonunuzun, Display & Video 360 API'yi veya Yapılandırılmış Veri Dosyalarını kullanarak kampanya, kampanya siparişi ya da satır öğesi kaynakları oluştururken 30 günden uzun bir sıklık sınırı dönemi ayarlamadığını doğrulayın.
Sabit teklif verme kullanan satır öğeleri için optimize hedefleme 6 Mart 2025

6 Mart 2025'te:

  • BiddingStrategy alanını fixedBid ve TargetingExpansionConfig alanını enableOptimizedTargeting true olarak ayarlamak için LineItem kaynakları oluşturan veya güncelleyen istekler 400 hatası döndürür.
  • Satır Öğesi Yapılandırılmış Veri Dosyalarında "Teklif Stratejisi Türü" sütun değeri "Sabit" ve "Optimize Hedefleme" sütun değeri "Doğru" olan girişler, dosya yüklendiğinde oluşturulamaz veya güncellenemez.
  • Sabit teklif kullanılan mevcut satır öğeleri, optimize hedeflemenin devre dışı bırakılacak şekilde güncellenecektir.

Hizmette kesinti yaşamamak için:

  • Hem sabit teklifi hem de optimize hedeflemeyi kullanan mevcut satır öğesi kaynaklarını güncelleyin.
  • Entegrasyonunuzun, Display & Video 360 API'yi veya yapılandırılmış veri dosyalarını kullanarak satır öğesi kaynakları oluştururken veya güncellerken sabit bir teklif stratejisi ve optimize edilmiş hedefleme ayarlamadığını doğrulayın.
firstAndThirdPartyAudiences.list varsayılan sayfa boyutuna güncelleme 6 Mart 2025

6 Mart 2025'te firstAndThirdPartyAudiences.list istekleri için varsayılan sayfa boyutu 100'den 5.000'e güncellenecek.

Hizmet kesintisi yaşamamak için entegrasyonunuzu, firstAndThirdPartyAudiences.list isteklerinizin pageSize sorgu parametresini tercih ettiğiniz sayfa boyutuna ayarlayacak şekilde güncelleyin.

Yeni sdfdownloadtasks.create iş ortağı/reklamveren uyuşmazlığı hatası 6 Mart 2025

6 Mart 2025'te, partnerId kümesinin alt öğesi olmayan reklamverenlere göre filtrelemek için üst öğe filtresi kullanan sdfdownloadtasks.create istekleri 400 hatası döndürmeye başlayacak.

Özel teklif verme algoritması ile Floodlight etkinlikleri eşleşmiyor 1 Nisan 2025

1 Nisan 2025'te:

Hizmette kesinti yaşamamak için entegrasyonunuzu şu şekilde güncelleyin:

  • İlgili Floodlight etkinliklerinin, özel teklif verme algoritmasının atanmasından önce veya aynı anda bir satır öğesine atandığından emin olun.
  • Mevcut özel teklif verme algoritmaları, güncellenmeye çalışılmadan önce tüm satır öğelerinden kaldırılır.

Birinci taraf kitleler için sonsuz üyelik süresi 7 Nisan 2025

7 Nisan 2025'ten itibaren FirstAndThirdPartyAudience kaynakları artık sonsuz kitle üyeliği süresine izin vermeyecek. membershipDurationDays alan değerini 10.000 olarak ayarlayan firstAndThirdPartyAudiences.create ve firstAndThirdPartyAudiences.patch istekleri 400 hatası döndürür. membershipDurationDays alanı değeri 10.000 olan mevcut kitleler 540 olarak güncellenecek ve yeni üyelik süresi mevcut üyeliklere geriye dönük olarak uygulanacak. Bu işlemle, 540 günden eski tüm üyeliklerin süresi dolacaktır.

Hizmette kesinti yaşamamak için:

  • Entegrasyonunuzun yeni veya mevcut kitlelerin membershipDurationDays alan değerini 10.000 olarak ayarlamadığını doğrulayın.
  • firstAndThirdPartyAudiences.editCustomerMatchMembers seçeneğini kullanarak mevcut Müşteri Eşleştirme kitlelerinizin üyeliklerini yenileyin.
  • Kitlelerinizin liste boyutunun istemeden küçülmemesini sağlamak için Müşteri Eşleştirme kitle üyeliklerinizi düzenli olarak yenileyin.
Satır Öğesi Yapılandırılmış Veri Dosyalarındaki "Teklif Çarpanları" sütunu 1 Mayıs 2025

1 Mayıs 2025'te, satır öğesi yapılandırılmış veri dosyalarında "Teklif Çarpanları" sütununu ayarlamaya çalışan girişler, dosya yüklendiğinde kaynak oluşturmayı veya güncellemeyi başaramayacaktır.