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

Bu sayfada, Display & Video 360 API'deki API sürümleri ve bağımsız özellikler için kullanımdan kaldırma ve kullanımdan kaldırılma tarihleri listelenmektedir.

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

Sürüm Kullanımdan Kaldırma İşlemleri

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

  • Sürüm: Sürüm, herhangi bir alfa veya beta durumundan çıkar ve kararlı olarak kabul edilir. Sürüm için özellik eklemeleri yine de kullanıma sunulabilir.
  • Kullanımdan kaldırma: Sürüm kullanımdan kaldırılmaktadır ve desteğin sona erme (kullanımdan kaldırılma) tarihi duyurulur. Kullanıcıların, kullanımdan kaldırılma tarihinden önce daha yeni bir sürüme geçmeleri gerekmektedir. Sürüm için artık özellik eklemeleri sunulmayacak.
  • Kullanımdan kaldırma: 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, bunların kullanıma sunulma tarihleri ve duyurulduysa kullanımdan kaldırılma ve sonlandırılma tarihleri listelenmektedir.

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

Özellik Kullanımdan Kaldırma İşlemleri

Yakında gerçekleşecek önemli kullanımdan kaldırma işlemleriyle ilgili duyurular için Google Ads geliştirici blogumuzu takip edin.

Aşağıdaki tabloda, duyurulan tüm özellik kullanımdan kaldırma işlemleri listelenmiştir. Bu listede ilk geçerlilik tarihi, kullanımdan kaldırmayla ilgili açıklama, önerilen işlemler ve ilgili belgelerin bağlantıları yer almaktadır:

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

Zaman çizelgesi:

  • 17 Mayıs 2023: Display & Video 360'ta, manuel tetikleyici kullanan satır öğelerinin yayını durdurulacaktır. Bu tarihten sonra etkin bir satır öğesine bağlı manuel bir tetikleyiciyi etkinleştirirseniz satır öğesi reklam yayınlamaz.
  • 1 Ağustos 2023: DV360 API v1 ve v2'de 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ılacaktır. Bu tarihten sonra bu hizmetlere veya bu alanlara yapılan istekler hata döndürecektir.

Önerilen işlem:

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

Zaman çizelgesi:

  • 20 Mayıs 2023: GoogleAudienceType veya GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES değerindeki GoogleAudience kaynaklarını satır öğesine ya da kampanya siparişi kitle hedeflemesine atayamayacaksınız.GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS Bu kitleleri 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çerecekse advertisers.lineItems.duplicate ve advertisers.lineItems.generateDefault istekleri buna dahildir.
  • 8 Haziran 2023: Etkilenen kitleler, tüm satır öğesi ve kampanya siparişi hedeflemelerinden ve birleştirilmiş kitlelerden kaldırılacaktır. Bu kitleler kaldırıldığında bir satır öğesi reklam yayınlayamazsa bunlar duraklatılır. Bu tarihten itibaren bu kitlelere googleAudiences hizmeti kullanılarak da erişilemeyecek.

Önerilen Görevler:

  • Satır öğesi hedeflemenizde gelecekte güncelleme yaparken etkilenen kitleleri kullanmayı hemen durdurmanı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 rehberimizi inceleyebilirsiniz.
Etkinliğe Dayalı ve Sıklık Sınırı FirstAndThirdPartyAudience Türleri 20 Mayıs 2023

Zaman çizelgesi:

  • 20 Mayıs 2023: AudienceType veya FREQUENCY_CAP değerindeki FirstAndThirdPartyAudience kaynaklarını satır öğesine ya da kampanya siparişi kitle hedeflemesine atayamayacaksınız.ACTIVITY_BASED Bu kitleleri 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çerecekse advertisers.lineItems.duplicate ve advertisers.lineItems.generateDefault istekleri buna dahildir.
  • 8 Haziran 2023: Etkilenen kitleler, tüm satır öğesi ve kampanya siparişi hedeflemelerinden ve birleştirilmiş kitlelerden kaldırılacaktır. Bu kitleler kaldırıldığında bir satır öğesi reklam yayınlayamazsa bunlar duraklatılır. Bu tarihten itibaren bu kitlelere firstAndThirdPartyAudiences hizmeti kullanılarak da erişilemeyecek.

Önerilen Görevler:

  • Satır öğesi hedeflemenizde gelecekte güncelleme yaparken etkilenen kitleleri kullanmayı hemen durdurmanı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 rehberimizi inceleyebilirsiniz.
Mevcut API Kota Sınırları 30 Mayıs 2023

30 Mayıs 2023'te mevcut kullanım sınırları, aşağıdaki işlemleri gerçekleştiren bir karma kota yapısıyla değiştirilecek:

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

Bu yeni sınırlar, API kullanımında daha fazla esneklik sağlayacak ve reklamverenler arasında isteklerin paralel hale getirilmesine imkan tanıyacak. Bu değişikliğin ayrıntılarını mevcut kota sınırı belgelerimizde bulabilirsiniz.

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

21 Haziran 2023

21 Haziran 2023'ten itibaren, LIST filter isteği parametreleri, farklı alanlardaki kısıtlamalar arasında OR mantıksal operatörlerinin kullanılmasına izin vermeyecek.

Örneğin, lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" filtre dizesiyle tanımlanan kaynaklar aşağıdaki filtre dizelerine sahip 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 ayrıntı için LIST isteklerini filtrelemeyle ilgili "nasıl yapılır" kılavuzumuza bakın.

Hizmet kesintisi yaşamamak için 21 Haziran 2023'ten önce mevcut tüm LIST çağrılarınızın filter sorgu parametrelerini gözden geçirin ve OR mantıksal operatörünü doğru şekilde kullandıklarını doğrulayın.

İstekleri budget.budget_segments.date_range.end_date ve flight.dateRange.endDate alanlarına göre filtreleme veya sıralama olanağı

İ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 parametrelerindeki alanlar olarak kabul edilmeyecektir. 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ı kullanarak tüm filtre ve sipariş mantığını kaldırın.

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

advertisers.lineItems.list, 21 Haziran 2023'ten itibaren 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ı kullanarak tüm filtre mantığını kaldırın.

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

1 Ağustos 2023'te, billableOutcome alanı değeri BILLABLE_OUTCOME_PAY_PER_CLICK veya BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION ile tanımlanan, sonuca dayalı satın alma kullanan kampanya siparişleri ve alt satır öğeleri arşivlenecektir.

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