Sürüm Notları

Bu sayfada Display & Video 360 API'si için sürüm notları sağlanmaktadır.

En son API sürümü: v3

17 Haziran 2024

Yeni Özellikler

Reklamveren düzeyinde atanan anahtar kelime hedeflemeyi yönetme desteği eklendi.

Kampanya siparişi kaynağına yeni optimizationObjective alanı eklendi. optimizationObjective, yalnızca izin verilenler listesindeki müşteriler tarafından kullanılabilir.

v3

v2

30 Mayıs 2024

Yeni Özellikler

Yapılandırılmış Veri Dosyaları (SDF) 7.1 sürümü için destek eklendi.

v3

  • Aşağıdaki enum değerleri eklendi:

    EnumDeğerler
    SdfVersion

    SDF_VERSION_7_1

v2

  • Aşağıdaki enum değerleri eklendi:

    EnumDeğerler
    SdfVersion

    SDF_VERSION_7_1

23 Nisan 2024

Yeni Özellikler

Yeni TPG türleri, exchange'ler ve uygulama platformları için destek eklendi.

v3

  • Aşağıdaki alanlar eklendi:

    KaynakAlanlar
    Kpi

    kpiAlgorithmId

  • Aşağıdaki enum değerleri eklendi:

    EnumDeğerler
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV

    Exchange

    EXCHANGE_DRAX

    KpiType

    KPI_TYPE_CPCL

    KPI_TYPE_CPCV

    KPI_TYPE_CPV

    KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST

    KPI_TYPE_MAXIMIZE_PACING

    KPI_TYPE_TOS10

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

28 Şubat 2024

Yeni Özellikler

Üyeleri Müşteri Eşleştirme kitlelerinden açıkça kaldırma özelliği eklendi.

Yeni exchange'leri hedefleme desteği eklendi.

v3

v2

29 Ocak 2024

Yeni Özellikler

Floodlight etkinliklerini yeni bir floodlightGroups.floodlightActivities hizmeti aracılığıyla alma özelliği eklendi.

YouTube ve İş Ortakları satır öğesinin, hedeflemesine Google TV envanterini dahil edip etmediğini bildiren yeni bir alan eklendi.

Bir Display & Video 360 kullanıcısının son giriş zamanını geçirmek için yeni bir alan eklendi.

v3

v2

14 Kasım 2023

Yeni Özellikler

Tüm canlı sürümlerde Müşteri Eşleştirme kitle üyelerini yüklerken son kullanıcı iznini iletme desteği eklendi.

v3

v2

31 Ekim 2023

Yeni Özellikler

v3 herkese açık betadan çıkarılıp genel kullanıma sunuldu.

v3'teki bir AdGroupFormat sıralama değeri, ilgili biçimi daha doğru şekilde yansıtmak için yeniden adlandırıldı.

v2 ve v3'te SDF_VERSION_7 sıralama değerinin eklenmesiyle Yapılandırılmış Veri Dosyaları v7 desteği eklendi.

v3

  • Aşağıdaki enum değerleri kaldırıldı:

    EnumDeğerler
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • Aşağıdaki enum değerleri eklendi:

    EnumDeğerler
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • Aşağıdaki enum değerleri eklendi:

    EnumDeğerler
    SdfVersion

    SDF_VERSION_7

2 Ekim 2023

Yeni Özellikler

Aşağıdaki değişiklikleri içeren v3 herkese açık beta olarak yayınlandı:

v2'den v3'e geçiş yapmak için taşıma rehberimizdeki adımları uygulayın.

v2 ve v3'te 3 yeni LineItemType değeri, bir yeni YoutubeAndPartnersBiddingStrategyType ve bir yeni PartnerCostType için destek eklendi.

v3

v2

25 Ağustos 2023

Yeni Özellikler

İki exchange ve iki yeni YouTube ve İş Ortakları teklif stratejisi türü için destek eklendi.

Hem reklamveren hem de satır öğesi seviyesinde atanan değerler göz önünde bulundurulduğunda satır öğesi tarafından kullanılan YoutubeAndPartnersContentCategory'in gösterilmesi için YouTube ve İş Ortakları satır öğelerine yeni bir effectiveContentCategory alanı eklendi.

v2

5 Haziran 2023

Yeni Özellikler

v1 ve v2'de Yapılandırılmış Veri Dosyaları (SDF) v6 için yeni bir SdfVersion değeri eklendi.

v2

  • Aşağıdaki enum değerleri eklendi:

    EnumDeğerler
    SdfVersion

    SDF_VERSION_6

v1

  • Aşağıdaki enum değerleri eklendi:

    EnumDeğerler
    SdfVersion

    SDF_VERSION_6

9 Mart 2023

Yeni Özellikler

Kullanımdan kaldırılan excludeFirstPartyAudience alanının true olarak ayarlanması durumunda satır öğesinin warningMessages alanına atanacak yeni bir LineItemWarningMessage değeri eklendi. excludeFirstPartyAudience alanı, 25 Mart 2023'ten sonra kullanımdan kaldırılacak ve false olarak ayarlanacak.

v2

  • Aşağıdaki enum değerleri eklendi:

    EnumDeğerler
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • Aşağıdaki enum değerleri eklendi:

    EnumDeğerler
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 Şubat 2023

Yeni Özellikler

YouTubeAdGroup ve YouTubeAdGroupAd kaynaklarını alma özelliğinin yanı sıra YouTube Reklam Grubu kaynak hedefleme özelliği eklendi. Ayrıca YouTube Reklam Grupları düzeyinde kullanılan yeni uygulanabilir hedefleme türleri de ekledik. Daha fazla bilgi için YouTube ve İş Ortakları kaynaklarına ulaşma konulu yeni kılavuz sayfamızı okuyun.

v1 ve v2'de dört ek exchange için destek eklendi.

v2

v1

  • Aşağıdaki enum değerleri eklendi:

    EnumDeğerler
    Exchange

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 Aralık 2022

Yeni Özellikler

v2 herkese açık betadan çıkarılıp genel kullanıma sunuldu.

AssignedTargetingOption kaynağına, hedefleme alınırken ve silinirken assignedTargetingOptionId öğesinin yerine kullanılabilecek yeni bir assignedTargetingOptionIdAlias alanı eklendi. Bu alan, yalnızca sıralama aracılığıyla atanan hedefleme türlerinin atanmış hedefleme seçenekleri için ayarlanır. Takma ad değeri, dize olarak ilgili enum değeridir.

Advertiser kaynağına yeni bir billingConfig alanı eklendi.

Üç yeni LineItemType değeriyle tanımlanan YouTube ve İş Ortakları baypas satır öğelerini alma desteği eklendi.

v1 ve v2'de çok sayıda list yöntemi için maksimum sayfa boyutu 200'e yükseltildi. Varsayılan sayfa boyutu değişmez.

v2

v1

Bilinen sorunlar

Bu güncelleme, v2'de bilinen aşağıdaki bilinen sorunları düzeltir:

27 Ekim 2022

Üst InsertionOrder içindeki mevcut bir satır öğesini kopyalama özelliği eklendi.

advertisers.insertionOrders.targetingTypes.assignedTargetingOptions hizmetine create ve delete yöntemlerinin eklenmesiyle birlikte hedefleme türlerinin bir alt kümesi için kısmi kampanya siparişi hedefleme yazma desteği kullanıma sunuldu.

Yeni Özellikler

v2

v1

v1'e yeni özellik eklenmedi.

20 Eylül 2022

Aşağıdaki değişiklikleri içeren v2 herkese açık beta olarak yayınlandı:

v1'den v2'ye geçiş yapmak için taşıma rehberimizdeki adımları uygulayın.

v1'de üç yeni exchange için destek eklendi.

Yeni Özellikler

v2

Aşağıda, v1 ve v2 arasındaki değişikliklerin bir listesi verilmiştir:

v1

  • v1'e aşağıdaki sıralama değerleri eklendi:

    EnumDeğerler
    Exchange

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 Mayıs 2022

Yeni inventorySources hizmeti yazma yöntemleri ve yeni guaranteedOrders hizmetiyle InventorySource kaynakları oluşturma ve GuaranteedOrder kaynaklarını yönetme özelliği eklendi.

CustomBiddingAlgorithm kaynağında modelReadiness alanı kullanıma sunuldu. Bu alanda, algoritmanın modeline erişebilen her reklamveren için modelin hazırlık durumu listelenir.

advertisers.creatives.list yöntemi için kullanıcının yalnızca belirli bir zaman damgasından önce veya sonra updateTime içeren reklam öğelerini almasına olanak tanıyan yeni filter sorgu parametresi işlevi etkinleştirildi.

SdfVersion sıralama değeri eklenerek en yeni SDF sürümü v5.5 için destek eklendi.

Yeni Özellikler

31 Mart 2022

İçerik süresi, akış türü ve tür ile ilgili hedeflemeyi alma ve ayarlama desteği eklendi.

billableOutcome alanı InsertionOrder nesnesine eklendi.

raiseBidForDeals alanı MaximizeSpendBidStrategy nesnesine eklendi. Böylece kullanıcılar, teklif verme stratejisinin hedeflenen anlaşmalar için reklamveren taban fiyatları uygulayıp uygulamayacağını ayarlayabilir.

Yeni Özellikler

2 Şubat 2022

Belirli Müşteri Eşleştirme FirstAndThirdPartyAudience kaynaklarının üyelerini oluşturma, güncelleme ve düzenleme için destek eklendi. Yeni Kitleleri kullanma kılavuzumuzdaki Müşteri Eşleştirme kitlelerini yükleme sayfasında bu yeni özelliklerin nasıl kullanılacağı ayrıntılı olarak açıklanmaktadır.

InsertionOrder ve LineItem kaynaklarında, bir kaynağın Etiket Garantili, Programatik Garantili veya garantili olmadığını tanımlayan yeni bir reservationType alanı kullanıma sunuldu.

Bir satır öğesinin yeni bir excludeNewExchanges alanı aracılığıyla yeni exchange'leri otomatik olarak hedefleyip hedeflemeyeceğini alma ve ayarlama özelliği eklendi.

Yeni özelliklerin yanı sıra varsayılan kota sınırları iki katına çıkarılmıştır.

Yeni Özellikler

8 Aralık 2021

TARGETING_TYPE_AUDIO_CONTENT_TYPE hedefleme türü altına işitsel içerik türü hedefleme desteği eklendi.

Yeni Özellikler

8 Kasım 2021

Özel teklif verme algoritmalarını ve komut dosyalarını yönetmek için tam destek eklendi. Bu tür içerikler aşağıdakileri kapsar:

Satır Öğelerini Yönetme kılavuzumuza Özel Teklif Vermeyi Uygulama sayfası eklendi. Bu sayfa; özel teklif verme algoritması oluşturma, komut dosyası yükleme ve özel teklif verme algoritmasını satır öğesinin teklif stratejisi olarak atama süreçlerini açıklar.

SdfVersion sıralama değeri eklenerek en yeni SDF sürümü v5.4 için destek eklendi.

Yeni Özellikler

14 Eylül 2021

TARGETING_TYPE_BUSINESS_CHAIN ve TARGETING_TYPE_POI hedefleme türlerinin altına yakın çevredeki hedef için destek eklendi.

targetingTypes.targetingOptions.get veya targetingTypes.targetingOptions.list yöntemleriyle alınamadığı için targetingTypes.targetingOptions.search ile mevcut TARGETING_TYPE_BUSINESS_CHAIN ve TARGETING_TYPE_POI hedefleme seçeneklerini arama özelliği eklendi.

Özel Teklif Verme Algoritması kaynağına yeni sharedAdvertiserIds ve customBiddingAlgorithmState alanları eklendi ve GOAL_BUILDER_BASED özel teklif verme algoritma türü için destek eklendi.

Exchange sıralamasına iki yeni değer eklendi.

Yeni Özellikler

4 Ağustos 2021

TARGETING_TYPE_OMID hedefleme türü altına Open Measurement'ın etkin envanter hedefleme desteği eklendi.

pageSize yöntem parametresi kullanılarak çeşitli reklamveren, kampanya, kampanya siparişi ve satır öğesi atanmış hedefleme seçeneği listesi yöntemlerinin tek bir sayfasında döndürülebilecek atanmış hedefleme seçeneklerinin maksimum sayısı artırıldı.

Yeni Özellikler

26 Mayıs 2021

Kullanıcıların şunları yapmasına olanak tanıyan advertisers.invoices hizmeti kullanıma sunuldu:

  • Belirli bir ay boyunca bir reklamverene düzenlenen faturaları alma.
  • belirli bir ay boyunca reklamveren tarafından kullanılan para birimi kodunu arama.

campaignBudgets alanı kampanya kaynağına eklendi. Kampanya siparişi bütçe segmentleri bir kampanya bütçesine bağlanabilir. Bu durum, ilişkili segmentlerin toplam bütçesini toplam kampanya bütçe tutarıyla kısıtlar.

Yeni hedefleme türü TARGETING_TYPE_NATIVE_CONTENT_POSITION altına yerel içerik konumu hedefleme desteği eklendi.

Reklamveren kaynağına yeni bir prismaEnabled alanı eklendi. Bu sayede kullanıcılar, Mediaocean'ın Prisma aracıyla entegrasyonu etkinleştirdi.

Reklamverenin entityStatus alanı için ENTITY_STATUS_PAUSED sıralama değeri desteği etkinleştirildi.

Yeni Özellikler

29 Nisan 2021

Kanal ve Negatif Anahtar Kelime Listesi kaynaklarına, hedefleme için kaynağı kullanan satır öğelerinin sayısını döndüren yeni alanlar eklendi. Satır öğesi listesi yöntemi için kullanıcıların hedeflemelerinde yalnızca belirli kanalları veya negatif anahtar kelime listelerini kullanan satır öğelerini almasına olanak tanıyan yeni filter özellikleri etkinleştirildi.

Yeni Özellikler

30 Mart 2021

Satır öğesi hizmetine, varsayılan yapılandırmalarla satır öğesi oluşturan yeni bir yöntem eklendi. Bu varsayılan değerler belirtilen satır öğesi türüne ve üst kampanya siparişinin ayarlarına ve atanan hedeflemesine dayanır.

Yeni bir kampanya hedefleme hizmeti ve ek toplu liste yöntemi aracılığıyla kampanya hedeflemenin alınmasını etkinleştirmiş olmanız gerekir.

Uygulamaların daha fazla platformda hedeflenmesine olanak tanımak için uygulama hedefleme genişletildi.

Kanal ve negatif anahtar kelime listesi içeriklerinin daha kolay yönetilmesini sağlamak için advertisers.channels.sites, partners.channels.sites ve advertisers.negativeKeywordLists.negativeKeywords hizmetlerinde birden çok değişiklik yapıldı. Bu değişiklikler şunlardır:

  • Kullanıcının bir kanal veya negatif anahtar kelime listesinin mevcut içeriklerinin üzerine tamamen yazmasını sağlayan replace yöntemlerinin eklenmesi.
  • Toplu düzenleme isteklerinin createdSites veya createdNegativeKeywords alanlarına mevcut hiçbir öğenin dahil edilmeme şartının kaldırılması.
  • Bir siteleri listeleme veya negatif anahtar kelimeleri listeleme yanıtının tek bir sayfasında döndürülebilecek maksimum öğe sayısındaki artış.

Yeni Özellikler

Kullanımdan kaldırmalar

24 Şubat 2021

Kampanya siparişlerine atanan hedeflemenin alınmasını sağlayan yeni bir kampanya siparişi hedefleme hizmeti ve ek toplu liste yöntemi kullanıma sunuldu. Üçüncü taraf işitsel reklam öğeleri tarafından kullanılacak yalnızca çıkışla ilgili reklam öğesi alanları ekleyerek reklam öğesi kaynağı genişletildi. Kampanya siparişi ve kampanya kaynakları tarafından kullanılacak yeni performans hedefi türleri eklendi.

Yeni Özellikler

27 Ocak 2021

Yeni Campaign OrderType alanı ve yeni LineItemType sıralama değerinin kullanıma sunulmasıyla TV kampanya siparişlerinin ve baypas satır öğelerinin alınmasını ve yönetilmesini sağladı. mobileApp satır öğesi alanı aracılığıyla mobil uygulama satır öğeleri için destek eklendi. Ek enum değerleriyle genişletilmiş exchange, google Audience ve SDF desteği. advertisers.list değerlerini son güncelleme zamanına göre filtreleme ve sıralama özelliği kullanıma sunuldu.

Yeni Özellikler

4 Aralık 2020

Coğrafi Bölge hedefleme seçeneklerini arama ve birden fazla kaynak listesi yöntemi sonucunu son güncelleme zamanına göre filtreleme özelliği eklendi. Bir satır öğesinin desteği sonlandırılmış coğrafi hedefleme kullandığında kullanıcıları bilgilendirmek amacıyla yeni bir LineItemAlertMessage öğesini kullanıma sunduk.

Yeni Özellikler

5 Kasım 2020

İlişkili satır öğelerinin harcamalarını başlatan manuel tetikleyiciler oluşturma, atama ve etkinleştirme özelliği eklendi. Ayarlandığında satır öğesinin hedeflemesini, hedeflenen kitlelerdekilere benzer kullanıcıları içerecek şekilde genişletebilen hedefleme genişletme seçenekleri kullanıma sunuldu. Üçüncü taraf doğrulama hedeflemesinde kullanılan DoubleVerify ve Integral Ad Science nesnelerine özel segment kimliği alanları eklendi.

Yeni Özellikler

12 Ekim 2020

Satır öğesi kaynağına alınabilir uyarı mesajları ve tıklama oranı (TO) performans hedefi türü eklendi. Satır öğeleri listelenirken filtrelenebilir alan olarak warningMessages eklendi.

Yeni özelliklere ek olarak, yeni kota sınırları artık uygulanmaktadır ve toplu isteklerin kullanımı ile ilgili yeni belgeler mevcuttur.

Yeni Özellikler

28 Ağustos 2020

Reklamveren denetim yönteminin yanıtına yeni alanlar ve çeşitli liste yöntemlerine yeni filtrelenebilir alanlar eklendi.

Yeni Özellikler

4 Ağustos 2020

Yeni kullanıcı yönetimi, iş ortağı ve iş ortağı hedefleme hizmetleri kullanıma sunuldu. Kullanıcıların hesap varlık sınırlarına ulaşmaktan proaktif olarak kaçınmasına yardımcı olacak araçlar kullanıma sunuldu. İşitsel satır öğeleri için destek eklendi. Ayrıca, satır öğeleri ve kampanya siparişi teklif stratejilerinde özel teklif verme algoritmaları kullanımı eklendi.

Yeni Özellikler

24 Haziran 2020

İş ortağı ve reklamveren kanalları için oluşturma yöntemi, yeni FirstAndThirdPartyAudience alanları ve ek exchange sıralama değerleri ekleyerek küçük bir güncelleme kullanıma sunuldu.

Yeni Özellikler

2 Haziran 2020

Hedeflenebilir varlıkların alt kümesini oluşturma, yama uygulama ve doldurma özelliği kullanıma sunuldu. Ayrıca üç hedefleme türü için reklamveren düzeyinde hedeflemeyi değiştirme özelliği eklendi: kanal, dijital içerik etiketi hariç tutma ve hassas kategori hariç tutma.

Yeni Özellikler

27 Nisan 2020

Bir dizi yeni özelliği kullanıma sunarak API'nin kapsamını SDF'nin ötesine taşıdık. Reklamverenler, kampanyalar, kampanya siparişleri, satır öğeleri ve reklam öğeleri gibi varlıkları oluşturmanıza, almanıza, güncellemenize ve silmenize olanak tanıyan temel kaynak yönetimi eklendi. Yeni özellikler, hedeflemenin satır öğesi düzeyinde düzenlenmesine de olanak tanır.

Yeni Özellikler

Aşağıdaki hizmetler eklendi:

HizmetYöntemler
reklamverenler

oluştur

sil

indir

liste

yama

advertisers.assets

yükle

advertisers.campaigns

oluştur

sil

indir

liste

yama

advertisers.channels

indir

liste

advertisers.creatives

oluştur

sil

indir

liste

yama

advertisers.insertionOrders

oluştur

sil

indir

liste

yama

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

oluştur

sil

indir

liste

yama

advertisers.lineItems.targetingTypes.assignedTargetingOptions

oluştur

sil

indir

liste

advertisers.locationLists

indir

liste

advertisers.negativeKeywordLists

indir

liste

combinedAudiences

indir

liste

customLists

indir

liste

firstAndThirdPartyAudiences

indir

liste

floodlightGroups

indir

yama

googleAudiences

indir

liste

inventorySourceGroups

indir

liste

inventorySources

indir

liste

partners.channels

indir

liste

partners.channels

indir

liste

9 Mart 2020

Display & Video 360 API v1 kullanıma sunuldu. Bu, API'nin ilk sürümüdür.

Bilinen sorunlar

Yok.