Sürüm Notları

Bu sayfada, Görüntülü Reklam Ağı ve Video 360 API.

En son API sürümü: v3

15 Temmuz 2024

Yeni Özellikler

Satır Öğesi ve Reklam Grubu Yapılandırılmış Veri Dosyalarını indirme desteği eklendi v3'teki QA biçimi.

v3

17 Haziran 2024

Yeni Özellikler

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

Kampanya siparişine yeni optimizationObjective alanı eklendi gösterir. 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 ile ilişkilendirilmiş hizmetler.

YouTube ve Google Cloud Platform'un İş ortakları satır öğesi Hedeflemesine Google TV envanterini dahil eder.

Display & Video 360'a son giriş zamanını geçirmek üzere Video 360 kullanıcı.

v3

v2

14 Kasım 2023

Yeni Özellikler

Müşteri Eşleştirme'yi yüklerken son kullanıcı iznini iletme desteği eklendi tüm canlı versiyonlarda kitle üyelerini kullanın.

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 daha doğru olacak şekilde yeniden adlandırıldı ilgili biçimi yansıttığını unutmayın.

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

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 geçiş yapmak için taşıma rehberimizdeki adımları uygulayın sürüm 3.

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

v3

v2

25 Ağustos 2023

Yeni Özellikler

İki exchange ve iki yeni YouTube ve İş Ortakları teklif stratejisi türlerini inceleyin.

YouTube veeffectiveContentCategory gösterilen iş ortağı satır öğeleriyle Şu durumlarda satır öğesi tarafından kullanılan YoutubeAndPartnersContentCategory hem reklamveren hem de satır öğesi seviyesinde atanan değerler göz önünde bulundurulur.

v2

5 Haziran 2023

Yeni Özellikler

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

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

Şu değere sahip yeni bir LineItemWarningMessage değeri eklendi: bir satır öğesinin warningMessages alanına atanabilir desteği sonlandırılmış excludeFirstPartyAudience alanı true excludeFirstPartyAudience alanı kullanımdan kaldırılacak 25 Mart 2023'ten sonra false olarak ayarlandı.

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ı ve YouTube Reklam Grubu kaynak hedefleme hakkında daha fazla bilgi edinin. Ayrıca, YouTube Reklam Gruplarında kullanılan alınabilir hedefleme türleri seviyesidir. YouTube ve Google Cloud ürünlerine dair İş Ortakları kaynakları inceleyin.

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.

assignedTargetingOptionIdAlias AssignedTargetingOption Hedefleme alınırken ve silerken assignedTargetingOptionId. Bu alan yalnızca şu özellikteki hedefleme türlerinin atanmış hedefleme seçenekleri için: enum aracılığıyla atanır. Takma ad değeri, dize olarak ilgili enum değeridir.

billingConfig Advertiser kaynak.

YouTube ve İş ortakları baypas satır öğeleri, üç yeni LineItemType değeriyle tanımlanır.

v1 ve v2'de çok sayıda list yöntemi için maksimum sayfa boyutu 200'e yükseltildi. İlgili içeriği oluşturmak için kullanılan varsayılan sayfa boyutu değiştirilmez.

v2

v1

Bilinen sorunlar

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

27 Ekim 2022

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

Şunların bir alt kümesi için kısmi kampanya siparişi hedefleme yazma desteği sunuldu: create ve ek hedefleme türleri delete yöntemini advertisers.insertionOrders.targetingTypes.assignedTargetingOptions geliştirmenizi sağlar.

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 sürüm 2.

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

InventorySource kaynakları ve GuaranteedOrder kaynaklarını yeni ve inventorySources hizmet yazma yöntemleri ve yeni guaranteedOrders hizmeti kullanabilirsiniz.

modelReadiness alanı kullanıma sunuldu CustomBiddingAlgorithm kaynak. Bu alanda, programın algoritma modelini kullanır.

Şunun için yeni filter sorgu parametresi işlevi etkinleştirildi kullanıcıya izin veren advertisers.creatives.list yöntemi almak için yalnızca updateTime belirli bir zaman damgasından önce veya sonra.

En yeni SDF sürümü v5.5 için destek eklendi. bir SdfVersion enum değeri eklenmesidir.

Yeni Özellikler

31 Mart 2022

Hedeflemeyi alma ve ayarlama için destek eklendi içerik süresi, akış türü ve ve tür.

billableOutcome alanı InsertionOrder öğesine eklendi nesnesini tanımlayın.

raiseBidForDeals alanı MaximizeSpendBidStrategy nesnesi, kullanıcıların teklifin ayarlanıp yayınlanmayacağını stratejisi, hedeflenen anlaşmalar için reklamveren taban fiyatlarını uygular.

Yeni Özellikler

2 Şubat 2022

Oluşturma, güncelleme ve belirli Müşteri Eşleştirme'nin üyelerini düzenleme FirstAndThirdPartyAudience. İlgili içeriği oluşturmak için kullanılan Müşteri Eşleştirme Kitleleri'ni yükleyin sayfasını Bu yeni özelliklerin nasıl kullanılacağıyla ilgili ayrıntılı bilgi için Kitleler'i kullanın başlıklı makaleyi inceleyin.

Şurada yeni reservationType alanı kullanıma sunuldu: InsertionOrder ve LineItem Bir kaynağın Etiket Garantili mi yoksa Programatik mi olduğunu belirleyen kaynaklar Garantilidir veya garanti edilmez.

Bir satır öğesinin otomatik olarak hedeflenip hedeflenmediğini alma ve ayarlama özelliği eklendi Yeni bir excludeNewExchanges aracılığıyla yeni exchange'ler girin.

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

Yeni Özellikler

8 Aralık 2021

Hedefleme türü altında ses içeriği türü hedefleme desteği eklendi TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Yeni Özellikler

8 Kasım 2021

Özel teklif verme algoritmalarını ve komut dosyalarını yönetmek için tam destek eklendi. Bunlardan bazıları:

URL'ye yeni bir Özel Teklif Vermeyi Uygula sayfası eklendi Satır Öğelerini Yönetme kılavuzumuz özel teklif verme algoritması oluşturma, komut dosyası yükleme ve Özel teklif verme algoritmasını bir satır öğesinin teklif stratejisi olarak atama

En yeni SDF sürümü v5.4 için destek eklendi. bir SdfVersion enum değeri eklenmesidir.

Yeni Özellikler

14 Eylül 2021

Hedefleme türleri altında yakın çevredeki hedef için destek eklendi TARGETING_TYPE_BUSINESS_CHAIN ve TARGETING_TYPE_POI.

Mevcut öğeleri arama özelliği eklendi TARGETING_TYPE_BUSINESS_CHAIN ve TARGETING_TYPE_POI hedefleme seçeneği için targetingTypes.targetingOptions.search, çünkü targetingTypes.targetingOptions.get veya targetingTypes.targetingOptions.list yöntemini kullanabilirsiniz.

Yeni sharedAdvertiserIds ve Özel Teklif'e customBiddingAlgorithmState alan Algoritma kaynağı ve GOAL_BUILDER_BASED özel teklif verme algoritması türü.

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

Yeni Özellikler

4 Ağustos 2021

Open Measurement etkin için destek eklendi Envanter hedeflemeyi TARGETING_TYPE_OMID.

Döndürülebilecek atanmış hedefleme seçeneklerinin maksimum sayısı artırıldı çeşitli reklamverenlere, kampanyaya ait kampanya siparişi ve atanmış satır öğesi hedeflemesi seçenek listesi yöntemlerini kullanın.pageSize

Yeni Özellikler

26 Mayıs 2021

advertisers.invoices hizmeti kullanıma sunuldu. Bu sayede kullanıcılar:

  • 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ı kampanyaya eklendi gösterir. Kampanya siparişi bütçe segmentleri şunlara bağlanabilir: Toplam bütçeyi kısıtlayan bir kampanya bütçesi ilişkilendirilmiş segmentleri toplam kampanya bütçe tutarına ekler.

Şunun için destek eklendi: yerel içerik konumu hedeflemesi hedefleme türü TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Reklamverene yeni bir prismaEnabled alanı kullanıma sunuldu Böylece kullanıcılar Mediaocean'ın Prisma aracıyla entegrasyonu etkinleştirebilir.

ENTITY_STATUS_PAUSED Reklamverenin entityStatus alanı.

Yeni Özellikler

29 Nisan 2021

Kanal'a yeni alanlar eklendi ve Satır sayısını döndüren Negatif Anahtar Kelime Listesi kaynakları hedefleme için kaynağı kullanan öğeleri içerir. Yeni filter etkinleştirildi satır öğesi liste yöntemi için kullanıcının şunları yapmasına olanak tanıyan özellikler: yalnızca belirli kanalları veya negatif anahtar kelimeyi kullanan satır öğelerini alma listelerde yer almasını sağlar.

Yeni Özellikler

30 Mart 2021

Satır öğesi hizmetine satır öğesi için bir değer girin. Bu varsayılan değerler satır öğesi türünün yanı sıra ayarlar ve atanan üst kampanya siparişinin hedeflemesi.

Kampanya hedeflemenin yeni kampanya hedefleme hizmetini ve ek toplu liste yöntemi.

Uygulama hedefleme, uygulamaların hedeflenmesine izin verecek şekilde genişletildi daha fazla platformda kullanılabilir.

advertisers.channels.sites üzerinde birden çok değişiklik yaptım, partners.channels.sites ve advertisers.negativeKeywordLists.negativeKeywords hizmetlerinin Kanal ve negatif anahtar kelime listesi içeriğinin daha kolay yönetilmesini sağlar. Bu değişiklikler şunlardır:

Yeni Özellikler

Kullanımdan kaldırmalar

24 Şubat 2021

Yeni bir kampanya siparişi hedefleme hizmetini kullanıma sundu ve şunların alınmasını sağlayan ek toplu liste yöntemi: hedefleme atanıyor. Reklam öğesi kaynağı genişletildi, tarafından kullanılacak yalnızca çıkış reklam öğesi alanları üçüncü taraf işitsel reklam öğeleridir. Yeni performans hedefi türleri eklendi kampanya siparişi ve kampanya tarafından kullanılmak üzere kaynaklar.

Yeni Özellikler

27 Ocak 2021

TV kampanya siparişlerinin ve baypas satırının alınmasını ve yönetilmesini etkinleştirdi ve projenize dahil olan yeni Kampanya Siparişi Türü alanı ve bir new LineItemType sıralama değeri. Mobil uygulama desteği eklendi satır öğelerini mobileApp satır öğesi alanından değiştirin. Genişletilmiş exchange, google kitlesi ve Ek sıralama değerleriyle SDF desteği. Tanıtılan filtreleme ve sıralama özelliği advertisers.list değerleri son güncelleme zamanına göre görürsünüz.

Yeni Özellikler

4 Aralık 2020

Arama özelliği eklendi Coğrafi Bölge hedefleme seçenekleri ve birden çok kaynağı filtreleme yöntem sonuçlarını son güncelleme zamanlarına göre listeler. Tanıtılan new LineItemAlertMessage'ı kullanın. Örneğin, satır öğesinde desteği sonlandırılmış coğrafi hedefleme kullanılıyor.

Yeni Özellikler

5 Kasım 2020

Oluşturma, atama ve etkinleştirme özelliği eklendi İlişkili satır öğelerini başlatan manuel tetikleyiciler gösterir. Aşağıdaki özelliklere sahip hedefleme genişletme seçeneklerini kullanıma sunduk: ayarlandığında, satır öğesinin hedeflemesini aşağıdakilere benzer kullanıcıları içerecek şekilde genişletebilir: hedeflenen kitlelerde kullanabilirsiniz. Özel segment kimliği alanları eklendi DoubleVerify ve Integral Ad Science şunda kullanılan nesneler: üçüncü taraf doğrulama hedeflemesi.

Yeni Özellikler

12 Ekim 2020

Satır öğesine alınabilir uyarı mesajları eklendi. kaynak ve tıklama oranı (TO) performansı hedef türünü belirtmelidir. Eklenme zamanı warningMessages öğesini, satır öğeleri listelenirken filtrelenebilir bir alan olarak belirleyin.

Yeni özelliklerin yanı sıra yeni kota sınırları da artık uygulanmaktadır ve Toplu isteklerin kullanımı ile ilgili yeni dokümanlar kullanıma sunuldu.

Yeni Özellikler

28 Ağustos 2020

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

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 öğelerin 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. Eklenme zamanı reklamveren, kampanya, kampanya siparişi ve satır öğeleri gibi varlıkları oluşturmanıza, almanıza, güncellemenize ve silmenize olanak tanıyan temel kaynak yönetimi nasıl büyük bir artış yakalayabileceğinizden bahsedeceğim. 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

al

liste

yama

advertisers.assets

yükleme

advertisers.campaigns

oluştur

sil

al

liste

yama

advertisers.channels

al

liste

advertisers.creatives

oluştur

sil

al

liste

yama

advertisers.insertionOrders

oluştur

sil

al

liste

yama

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

oluştur

sil

al

liste

yama

advertisers.lineItems.targetingTypes.assignedTargetingOptions

oluştur

sil

al

liste

advertisers.locationLists

al

liste

advertisers.negativeKeywordLists

al

liste

combinedAudiences

al

liste

customLists

al

liste

firstAndThirdPartyAudiences

al

liste

floodlightGroups

al

yama

googleAudiences

al

liste

inventorySourceGroups

al

liste

inventorySources

al

liste

partners.channels

al

liste

partners.channels

al

liste

9 Mart 2020

Kullanıma Sunulan Görüntülü Reklam ve Video 360 API v1. Bu, API'nin ilk sürümüdür.

Bilinen sorunlar

Yok.