Sürüm Notları

Bu sayfada, Display & Video 360 API'si için sürüm notları sunulmaktadır.

En son API sürümü: v3

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

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

YouTube ve İş Ortakları satır öğesinin, hedeflemesinde Google TV envanteri olup olmadığını belirten yeni bir alan eklendi.

Display & Video 360 kullanıcısı için son giriş zamanını aktarmak amacıyla yeni bir alan eklendi.

v3

v2

14 Kasım 2023

Yeni Özellikler

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

v3

v2

31 Ekim 2023

Yeni Özellikler

v3 herkese açık beta sürümünden çıkarılıp genel kullanıma sunuldu.

İlgili biçimi daha doğru yansıtmak için v3'te bir AdGroupFormat enum değeri yeniden adlandırıldı.

v2 ve v3'te SDF_VERSION_7 sıralama değerinin eklenmesiyle birlikte 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 sürümünde yayınlanmıştır:

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

v2 ve v3'e 3 yeni LineItemType değeri, bir yeni YoutubeAndPartnersBiddingStrategyType ve bir yeni PartnerCostType değeri 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ğerleri göz önünde bulundururken satır öğesi tarafından kullanılan YoutubeAndPartnersContentCategory alanını göstermek 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ı true olarak ayarlanmışsa satır öğesinin warningMessages alanına atanacak yeni bir LineItemWarningMessage değeri eklendi. 25 Mart 2023'ten sonra excludeFirstPartyAudience alanı 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 geri alınabilir hedefleme türleri de ekledik. Daha fazla bilgi için YouTube ve İş Ortakları kaynaklarını almayla ilgili 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 beta sürümünden çıkarılıp genel kullanıma sunuldu.

AssignedTargetingOption kaynağına yeni bir assignedTargetingOptionIdAlias alanı eklendi. Bu alan, hedefleme alınırken ve silinirken assignedTargetingOptionId yerine kullanılabilir. Bu alan, yalnızca numaralandırma aracılığıyla atanan hedefleme türlerinin atanan 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.

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

v1 ve v2'de çeşitli list yöntemleri için maksimum sayfa boyutu 200'e yükseltildi. Varsayılan sayfa boyutu değiştirilmez.

v2

v1

Bilinen sorunlar

Bu güncellemeyle v2'de aşağıdaki bilinen sorunlar giderilmiştir:

27 Ekim 2022

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

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

Yeni Özellikler

v2

v1

Sürüm 1'e yeni özellik eklenmedi.

20 Eylül 2022

Aşağıdaki değişiklikleri içeren v2 herkese açık beta sürümünde yayınlanmıştır:

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

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

Yeni Özellikler

v2

Aşağıda, v1 ile v2 arasındaki değişikliklerin bir listesi bulunmaktadır:

v1

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

    EnumDeğerler
    Exchange

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 Mayıs 2022

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

CustomBiddingAlgorithm kaynağında modelReadiness alanı kullanıma sunuldu. Bu alanda, algoritmaya erişebilen her reklamveren için algoritma modelinin hazır olma durumu listelenir.

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

SdfVersion enum değerinin eklenmesiyle 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 için hedefleme alma ve ayarlama desteği eklendi.

billableOutcome alanı InsertionOrder nesnesine eklendi.

MaximizeSpendBidStrategy nesnesine raiseBidForDeals alanı kullanılmaya başlandı ve kullanıcıların, teklif stratejisinin hedeflenen anlaşmalar için reklamveren taban fiyatları uygulanıp uygulanmayacağını ayarlamasına olanak sağlandı.

Yeni Özellikler

2 Şubat 2022

Belirli Müşteri Eşleştirme FirstAndThirdPartyAudience kaynaklarının üyelerini oluşturma, güncelleme ve düzenleme desteği eklendi. Yeni Kitleleri Kullanma kılavuzumuzdaki Müşteri Eşleştirme Kitlelerini Yükleme sayfasında, bu yeni özelliklerin nasıl kullanılacağı açıklanmaktadır.

InsertionOrder ve LineItem kaynaklarında, bir kaynağın Etiket Garantili, Programatik Garantili veya garantili olup olmadığını belirleyen 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 özelliklere ek olarak, varsayılan kota sınırları da iki katına çıkarılmıştır.

Yeni Özellikler

8 Aralık 2021

TARGETING_TYPE_AUDIO_CONTENT_TYPE hedefleme türünün altında ses içeriği türü hedefleme için destek eklendi.

Yeni Özellikler

8 Kasım 2021

Özel teklif verme algoritmalarını ve komut dosyalarını yönetmek için tam destek eklendi. Bu hizmet ve özellikler arasında aşağıdakiler bulunmaktadır:

Satır Öğelerini Yönetme rehberimize, özel teklif verme algoritması oluşturma, komut dosyası yükleme ve özel teklif verme algoritmasını bir satır öğesinin teklif stratejisi olarak atama işlemlerini açıklayan yeni bir Özel Teklif Verme Uygula sayfası eklendi.

SdfVersion sıralama değerinin eklenmesiyle 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 kullanarak 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 algoritması 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ünün altında Open Measurement'ın etkin olduğu envanter hedefleme için destek 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 aşağıdaki işlemleri yapmasına olanak tanıyan advertisers.invoices hizmeti kullanıma sunuldu:

  • Belirli bir ay içinde bir reklamverene düzenlenen faturaları almak.
  • belirli bir ayda reklamverenin kullandığı para birimi kodunu arayabilir.

Kampanya kaynağına campaignBudgets alanı eklendi. Kampanya siparişi bütçe segmentleri bir kampanya bütçesine bağlanabilir. Bu sayede, ilişkili segmentlerin toplam bütçesi toplam kampanya bütçesi tutarıyla sınırlandırılır.

Yeni hedefleme türü TARGETING_TYPE_NATIVE_CONTENT_POSITION altında yerel içerik konumu hedefleme için destek eklendi.

Reklamveren kaynağına, kullanıcıların Mediaocean'ın Prisma aracıyla entegrasyonu etkinleştirmesine olanak tanıyan yeni bir prismaEnabled alanı eklendi.

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

Yeni Özellikler

29 Nisan 2021

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

Yeni Özellikler

30 Mart 2021

Varsayılan yapılandırmalara sahip bir satır öğesi oluşturan satır öğesi hizmetine yeni bir yöntem eklendi. Bu varsayılan değerler, belirtilen satır öğesi türünün yanı sıra üst kampanya siparişinin ayarları ve atanan hedeflemesini temel alır.

Yeni bir kampanya hedefleme hizmeti ve ek toplu liste yöntemi aracılığıyla kampanya hedefleme alındı.

Uygulamaların daha fazla platformda hedeflenebilmesi için genişletilmiş uygulama hedefleme.

Kanal ve negatif anahtar kelime listesi içeriğinin daha kolay yönetilmesini sağlamak için advertisers.channels.sites, partners.channels.sites ve advertisers.negativeKeywordLists.negativeKeywords hizmetlerinde birden fazla değişiklik yapıldı. Bu değişiklikler arasında şunlar yer alır:

  • Kullanıcının bir kanalın veya negatif anahtar kelime listesinin mevcut içeriğinin üzerine tamamen yazmasını sağlayan replace yöntemlerinin eklenmesi.
  • Toplu düzenleme isteklerinin createdSites veya createdNegativeKeywords alanlarına mevcut öğelerin eklenmemesi şartının kaldırılması.
  • Bir site listeleme veya negatif anahtar kelime 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 hizmetinin ve ek toplu listeleme yönteminin kullanıma sunulması. Reklam öğesi kaynağı genişletildi ve üçüncü taraf işitsel reklam öğelerinin kullanımı için yalnızca çıkış sağlayan reklam öğesi alanları eklendi. Kampanya siparişi ve kampanya kaynakları tarafından kullanılmak üzere yeni performans hedefi türleri eklendi.

Yeni Özellikler

27 Ocak 2021

Kullanıma sunulan yeni InsertOrderType alanının ve yeni LineItemType enum değerinin kullanıma sunulmasıyla TV kampanya siparişlerinin ve baypas satır öğelerinin alınıp yönetilmesini sağladık. mobileApp satır öğesi alanı ile mobil uygulama satır öğeleri için destek eklendi. Ek enum değerleri ile exchange, google audience ve SDF desteği genişletildi. 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çenekleri için arama ve birden fazla kaynak listesi yöntemi sonucunu son güncellenme zamanına göre filtreleme özelliği eklendi. Bir satır öğesinin desteği sonlandırılmış coğrafi hedeflemeyi kullandığı durumları kullanıcılara bildirmek için yeni bir LineItemWarningMessage kullanıma sunuldu.

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. Özel segment kimliği alanları, üçüncü taraf doğrulama hedeflemesinde kullanılan DoubleVerify ve Integral Ad Science nesnelerine eklendi.

Yeni Özellikler

12 Ekim 2020

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

Yeni özelliklerin yanı sıra artık yeni kota sınırları da uygulanmaya başladı ve toplu isteklerin kullanımıyla ilgili yeni belgeler kullanıma sunuldu.

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. Sesli satır öğeleri için destek ve satır öğeleri ile kampanya siparişi teklif stratejilerinde özel teklif verme algoritmalarının kullanımı eklendi.

Yeni Özellikler

24 Haziran 2020

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

Yeni Özellikler

2 Haziran 2020

Hedeflenebilir öğelerin bir 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 kullanıma sunuldu: kanal, dijital içerik etiketi hariç tutma ve hassas kategori hariç tutma.

Yeni Özellikler

27 Nisan 2020

API'nin kapsamını SDF'nin de ötesine taşıyarak büyük bir özellik grubunu kullanıma sundu. 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, satır öğesi seviyesinde hedeflemenin 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.