Bu sayfada, Display & Video 360 API'nin kullanımdan kaldırılan sürümlerine ait sürüm notları yer almaktadır.
Tüm canlı sürüm yayınları için ana sürüm notları sayfamıza gidin.
4 Aralık 2024
Yeni Özellikler
Core ve Tubi Exchange değerleri için destek eklendi.
firstAndThirdPartyAudiences.list için izin verilen maksimum sayfa boyutu 200'den 5000'e yükseltildi. Kota kullanımınızı daha da optimize etmek için firstAndThirdPartyAudiences.list isteklerinizin pageSize parametresini güncelleyin.
v3
Aşağıdaki enum değerleri eklendi:
Enum Değerler ExchangeEXCHANGE_COREEXCHANGE_TUBIAşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:
Yöntem Yeni Maksimum Sayfa Boyutu firstAndThirdPartyAudiences.list5000
22 Ekim 2024
Yeni Özellikler
Görüntüleme başına maliyet performans hedefi için destek eklendi.
Bağlı cihazların hedeflemesini ayarlama ve alma özelliği eklendi.
Üçüncü taraf doğrulayıcı hedefleme bölümüne yeni Adloox marka güvenliği ayarları eklendi.
Şu anda kapalı beta sürümünde olan v8 Yapılandırılmış Veri Dosyaları'nın indirilmesi için destek eklendi.
v3
Aşağıdaki alanlar eklendi:
Nesne Alanlar AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContentAşağıdaki enum değerleri eklendi:
Enum Değerler DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
Desteği sonlandırılan değerler
3 Ekim 2024'te kullanımdan kaldırılacağı için SDF v5.5 desteği kaldırıldı.
v3
Aşağıdaki enum değerlerinin desteği sonlandırıldı:
Enum Değerler SdfVersionSDF_VERSION_5_5
15 Ağustos 2024
Yeni Özellikler
Netflix Exchange türü için destek eklendi.
v3
Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange EXCHANGE_NETFLIX
v2
Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange EXCHANGE_NETFLIX
15 Temmuz 2024
Yeni Özellikler
v3'te satır öğesi ve reklam grubu yapılandırılmış veri dosyalarının kalite güvencesi biçiminde indirilmesi için destek eklendi.
v3
Aşağıdaki alanlar eklendi:
Kaynak Alanlar IdFilter Aşağıdaki enum değerleri eklendi:
Enum Değerler FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
17 Haziran 2024
Yeni Özellikler
Reklamveren düzeyinde atanan anahtar kelime hedeflemesini 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
Aşağıdaki alanlar eklendi:
Kaynak Alanlar InsertionOrder Aşağıdaki yöntemler artık aşağıdaki hedefleme türlerini destekliyor:
Hedefleme Türü Yöntemler TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
v2
Aşağıdaki yöntemler artık aşağıdaki hedefleme türlerini destekliyor:
Hedefleme Türü Yöntemler TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
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:
Enum Değerler SdfVersion SDF_VERSION_7_1
v2
Aşağıdaki enum değerleri eklendi:
Enum Değerler SdfVersion SDF_VERSION_7_1
23 Nisan 2024
Yeni Özellikler
Yeni TPG türleri, borsalar ve uygulama platformları için destek eklendi.
v3
Aşağıdaki alanlar eklendi:
Kaynak Alanlar Kpi Aşağıdaki enum değerleri eklendi:
Enum Değ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
Aşağıdaki enum değerleri eklendi:
Enum Değerler AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Exchange EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
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
Aşağıdaki alanlar eklendi:
Kaynak Alanlar firstAndThirdPartyAudiences.editCustomerMatchMembers Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Aşağıdaki alanlar eklendi:
Kaynak Alanlar firstAndThirdPartyAudiences.editCustomerMatchMembers Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
29 Ocak 2024
Yeni Özellikler
Yeni bir floodlightGroups.floodlightActivities hizmeti aracılığıyla Floodlight etkinliklerini alma özelliği eklendi.
YouTube ve iş ortakları satır öğesinin hedeflemesinde Google TV envanterinin yer alıp almadığını belirten yeni bir alan eklendi.
Display & Video 360 kullanıcısının son giriş zamanını iletmek için yeni bir alan eklendi.
v3
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler floodlightGroups.floodlightActivities Aşağıdaki alanlar eklendi:
Kaynak Alanlar Kullanıcı YoutubeAndPartnersInventorySourceConfig
v2
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler floodlightGroups.floodlightActivities Aşağıdaki alanlar eklendi:
Kaynak Alanlar Kullanıcı YoutubeAndPartnersInventorySourceConfig
14 Kasım 2023
Yeni Özellikler
Müşteri Eşleştirme kitle üyeleri tüm canlı sürümlerde yüklenirken son kullanıcı izninin iletilmesi için destek eklendi.
v3
Aşağıdaki alanlar eklendi:
Kaynak Alanlar ContactInfoList MobileDeviceIdList
v2
Aşağıdaki alanlar eklendi:
Kaynak Alanlar ContactInfoList MobileDeviceIdList
31 Ekim 2023
Yeni Özellikler
v3, herkese açık beta sürümünden çıkarılıp genel kullanıma sunuldu.
V3'te bir AdGroupFormat enum değeri, ilgili biçimi daha doğru yansıtacak şekilde yeniden adlandırıldı.
v2 ve v3'e SDF_VERSION_7 enum değeri eklenerek Yapılandırılmış Veri Dosyaları v7 desteği eklendi.
v3
Aşağıdaki enum değerleri kaldırıldı:
Enum Değerler AdGroupFormat AD_GROUP_FORMAT_ACTION
Aşağıdaki enum değerleri eklendi:
Enum Değerler AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Aşağıdaki enum değerleri eklendi:
Enum Değerler SdfVersion SDF_VERSION_7
2 Ekim 2023
Yeni Özellikler
Aşağıdaki değişiklikleri içeren v3 sürümünü herkese açık beta olarak yayınladık:
- Yakınlık konum listelerini tam olarak yönetme olanağı. Bu sayede,
advertisers.locationLists.assignedLocationshizmeti kullanılarakTARGETING_LOCATION_TYPE_PROXIMITYkaynaklarına atanan konumlar oluşturulup silinebilir.LocationList TargetingExpansionConfignesnesindekitargetingExpansionLevelalanının yerini alan yeni bir booleanenableOptimizedTargetingalanı.billingConfigalanınınAdvertiserkaynağındaki zorunluluğu (advertisers.createistekleri gönderilirken dahil edilmelidir) vePartnerkaynağında yeni birbillingConfigalanı.- v2'deki
YoutubeAdGroupveYoutubeAdGroupAdkaynaklarının yerini alan yeniAdGroupveAdGroupAdkaynakları.
v2'den v3'e geçmek için taşıma kılavuzumuzdaki adımları uygulayın.
Sürüm 2 ve 3'te 3 yeni LineItemType değeri, bir yeni YoutubeAndPartnersBiddingStrategyType ve bir yeni PartnerCostType değeri için destek eklendi.
v3
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules Aşağıdaki yöntemler kaldırıldı:
Hizmet Yöntemler advertisers.manualTriggers etkinleştir
create
devre dışı bırak
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
Aşağıdaki yöntem davranışları değişti:
Yöntem Değişiklikler advertisers.locationLists.create Artık TARGETING_LOCATION_TYPE_PROXIMITYLocationListkaynakları oluşturmayı destekliyor.advertisers.locationLists.patch Artık TARGETING_LOCATION_TYPE_PROXIMITYLocationListkaynaklarının güncellenmesini destekliyor.advertisers.locationLists.assignedLocations.bulkEdit Artık TARGETING_LOCATION_TYPE_PROXIMITYLocationListkaynaklarındakiAssignedLocationkaynaklarının toplu olarak düzenlenmesini destekliyor.advertisers.locationLists.assignedLocations.create Artık TARGETING_LOCATION_TYPE_PROXIMITYLocationListkaynaklarındaAssignedLocationkaynakları oluşturmayı destekliyor.Aşağıdaki sorgu parametreleri eklendi:
Yöntem Parametreler inventorySources.get Aşağıdaki alanlar zorunlu hale getirildi:
Kaynak Alanlar Reklamveren Aşağıdaki alanlar eklendi:
Kaynak Alanlar BiddingStrategy InsertionOrder İş Ortağı TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Aşağıdaki alanlar kaldırıldı:
Kaynak Alanlar InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Aşağıdaki enum değerleri eklendi:
Enum Değerler CustomBiddingAlgorithmType RULE_BASED
LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Aşağıdaki enum değerleri kaldırıldı:
Enum Değerler LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Aşağıdaki enum değerleri eklendi:
Enum Değerler LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
25 Ağustos 2023
Yeni Özellikler
İki borsa ve iki yeni YouTube ve iş ortakları teklif stratejisi türü için destek eklendi.
Hem reklamveren hem de satır öğesi düzeyinde atanan değerler dikkate alınırken satır öğesi tarafından kullanılan YoutubeAndPartnersContentCategory'ı göstermek için YouTube ve iş ortakları satır öğelerine yeni bir effectiveContentCategory alanı eklendi.
v2
Aşağıdaki alanlar eklendi:
Kaynak Alanlar YoutubeAndPartnersSettings Aşağıdaki alanlar kaldırıldı:
Kaynak Alanlar InventorySource subSitePropertyId
Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
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:
Enum Değerler SdfVersion SDF_VERSION_6
v1
Aşağıdaki enum değerleri eklendi:
Enum Değerler SdfVersion SDF_VERSION_6
9 Mart 2023
Yeni Özellikler
Kullanımdan kaldırılan excludeFirstPartyAudience alanı true olarak ayarlanmışsa bir 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:
Enum Değerler LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Aşağıdaki enum değerleri eklendi:
Enum Değerler LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 Şubat 2023
Yeni Özellikler
YouTubeAdGroup ve YouTubeAdGroupAd kaynaklarının yanı sıra YouTube reklam grubu kaynak hedeflemesini alma özelliği eklendi. Ayrıca, YouTube reklam grupları düzeyinde kullanılan yeni, alınabilir hedefleme türleri de ekledik. Daha fazla bilgi için YouTube ve iş ortakları kaynaklarını alma ile ilgili yeni rehber sayfamızı inceleyin.
Sürüm 1 ve sürüm 2'de dört ek exchange için destek eklendi.
v2
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Aşağıdaki alanlar eklendi:
Hizmet Yöntemler AssignedTargetingOption YoutubeAndPartnersSettings Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
Aşağıdaki enum değerleri eklendi:
Enum Değ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.
Hedefleme alınırken ve silinirken assignedTargetingOptionId yerine kullanılabilecek assignedTargetingOptionIdAlias adlı yeni bir alan AssignedTargetingOption kaynağına eklendi.
Bu alan yalnızca numaralandırma yoluyla atanan hedefleme türlerinin atanmış hedefleme seçenekleri için ayarlanır. Takma ad değeri, ilgili enum değerinin dize olarak gösterimidir.
billingConfig kaynağına yeni bir Advertiser alanı eklendi.
Üç yeni LineItemType değeriyle tanımlanan YouTube ve iş ortakları over-the-top satır öğelerini alma desteği eklendi.
v1 ve v2'deki çeşitli list yöntemleri için maksimum sayfa boyutu 200'e çıkarıldı. Varsayılan sayfa boyutu değişmez.
v2
Aşağıdaki alanlar eklendi:
Kaynak Alanlar Reklamveren AssignedTargetingOption Aşağıdaki enum değerleri eklendi:
Enum Değerler LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:
v1
Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:
Bilinen sorunlar
Bu güncelleme, v2'deki aşağıdaki bilinen sorunları düzeltir:
- V2'de enum değerleri kullanılarak atanan hedefleme türlerinin atanmış hedefleme seçenekleri,
assignedTargetingOptionIdkullanılarak kaldırılamıyor veya alınamıyordu ve bunun yerine kullanıcıların enum değerini kullanması bekleniyordu. Bu güncellemeyle, atanan bu hedefleme seçenekleri,assignedTargetingOptionIdveyaAssignedTargetingOptionkaynağındaki yeniassignedTargetingOptionIdAliasalanı tarafından tanımlanan enum değeri kullanılarak kaldırılabilir veya alınabilir. bulkUpdatesatır öğesi isteği,advertisersIdistek parametresini doğru şekilde kullanmadığı için hata döndürüyordu. Bu güncelleme ile yöntem düzeltildi ve istek parametresinin adıadvertisersIdikenadvertiserIdolarak değiştirildi.
27 Ekim 2022
Üst öğe içinde mevcut bir satır öğesini kopyalama özelliği eklendi
InsertionOrder.
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions hizmetine create ve delete yöntemlerinin eklenmesiyle, hedefleme türlerinin bir alt kümesi için kısmi kampanya siparişi hedefleme yazma desteği kullanıma sunuldu.
Yeni Özellikler
v2
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
v1'e yeni özellikler eklenmedi.
20 Eylül 2022
Aşağıdaki değişiklikleri içeren v2'yi herkese açık beta sürümünde yayınladık:
advertisers.lineItemsveadvertisers.lineItems.targetingTypes.assignedTargetingOptionshizmetlerindegetvelistyöntemlerini kullanarak YouTube ve iş ortakları satır öğelerini ve bunların hedefleme ayarlarını alma özelliği.advertisers.lineItemshizmetinde, tek bir istekle birden fazla satır öğesine atanmış hedeflemeyi düzenlemeyi ve almayı sağlayan iki yeni toplu hedefleme yöntemi.- Kullanıcıların tek bir istekte birden fazla satır öğesinin
bulkUpdatedeğerini güncellemesine olanak tanıyan yeni birbulkUpdateyöntemi.entityStatus AssignedTargetingOptionkaynaklarının,targetingTypes.targetingOptionshizmeti kullanılarak alınan hedefleme seçeneği kimlikleri yerine numaralandırılmış değerler kullanılarak atanmasını ve alınmasını gerektiren yeni hedefleme mantığı.
v1'den v2'ye geçmek için taşıma kılavuzumuzdaki adımları uygulayın.
Sürüm 1'de üç yeni borsa için destek eklendi.
Yeni Özellikler
v2
v1 ile v2 arasındaki değişikliklerin listesini aşağıda bulabilirsiniz:
v2'ye aşağıdaki yöntemler eklenmiştir:
Hizmet Yöntemler advertisers.lineItems bulkEditAssignedTargetingOptions
Aşağıdaki yöntemler v2'de kaldırıldı:
Hizmet Yöntemler advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Aşağıdaki yöntemlerin adı v2'de değiştirildi:
Hizmet Eski Yöntem Adı Yeni Yöntem Adı reklamverenler bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions iş ortakları bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Aşağıdaki hedefleme türlerine ait
AssignedTargetingOptionkaynakları, v2'de hedefleme ataması için numaralandırmaları kullanır. Bu hedefleme türlerininAssignedTargetingOptionkaynakları içinassignedTargetingOptionIdalanı, v2'de enum değerlerinin dize sürümlerini kullanacak şekilde güncellendi:Hedefleme Türü Enum Türü TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT Ortam TARGETING_TYPE_EXCHANGE Exchange TARGETING_TYPE_GENDER Cinsiyet TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY Görüntülenebilirlik v2'ye aşağıdaki alanlar eklendi:
Aşağıdaki alanlar v2'de kaldırıldı:
Aşağıdaki alanlar v2'de zorunlu hale getirilmiştir:
Aşağıdaki enum değerleri v2'ye eklendi:
Enum Değerler AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
Exchange EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
Aşağıdaki enum değerleri v2'de kaldırıldı:
Enum Değerler LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
v1'e aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 Mayıs 2022
Yeni inventorySources hizmet yazma yöntemleri ve yeni 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, algoritmanın modelinin erişebilen her reklamveren için hazırlık durumu listelenir.
Kullanıcının yalnızca belirli bir zaman damgasından önce veya sonra updateTime içeren reklam öğelerini almasına olanak tanıyan advertisers.creatives.list yöntemi için yeni filter sorgu parametresi işlevini etkinleştirdik.
SdfVersion enum değeri eklenerek en yeni SDF sürümü olan v5.5 için destek eklendi.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler guaranteedOrders inventorySources Aşağıdaki alanlar eklendi:
Kaynak Alanlar CustomBiddingAlgorithm InventorySource Aşağıdaki enum değerleri eklendi:
Enum Değerler SdfVersion Aşağıdaki liste yöntemleri artık aşağıdaki özelliklere göre filtrelenebilir:
Yöntem Alanlar advertisers.creatives.list
31 Mart 2022
İçerik süresi, akış türü ve tür için hedeflemeyi alma ve ayarlama desteği eklendi.
InsertionOrder nesnesine billableOutcome alanı eklendi.
MaximizeSpendBidStrategy nesnesine raiseBidForDeals alanı eklendi. Bu alan, kullanıcıların teklif stratejisinin hedeflenen anlaşmalar için reklamveren taban fiyatlarını uygulayıp uygulamayacağını ayarlamasına olanak tanır.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Aşağıdaki enum değerleri eklendi:
Enum Değerler TargetingType
2 Şubat 2022
Belirli Müşteri Eşleştirme FirstAndThirdPartyAudience kaynaklarının oluşturulması, güncellenmesi ve üyelerinin düzenlenmesi için destek eklendi. Yeni Kitleleri Kullanma rehberimizdeki 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ına, kaynağın etiket garantili, programatik garantili veya garantili olup olmadığını belirten yeni bir reservationType alanı eklendi.
Yeni bir excludeNewExchanges alanı aracılığıyla bir satır öğesinin yeni exchange'leri otomatik olarak hedefleyip hedeflemeyeceğini alma ve ayarlama özelliği eklendi.
Yeni özelliklere ek olarak, varsayılan kota sınırları iki katına çıkarıldı.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler firstAndThirdPartyAudiences Aşağıdaki alanlar eklendi:
Kaynak Alanlar FirstAndThirdPartyAudience InsertionOrder LineItem
8 Aralık 2021
Hedefleme türü TARGETING_TYPE_AUDIO_CONTENT_TYPE altında ses içerik türü hedefleme için destek eklendi.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption TargetingOption Aşağıdaki enum değerleri eklendi:
Enum Değerler TargetingType
8 Kasım 2021
Özel teklif verme algoritmalarının ve komut dosyalarının yönetimi için tam destek eklendi. Bunlardan bazıları:
- Yeni oluşturma ve mevcut güncelleme işlevleri
customBiddingAlgorithms - Kullanılabilir bir kaynak konumunu alma ve ardından dosyayı bu konuma yükleme işlemiyle komut dosyalarını yükleme özelliği.
customBiddingAlgorithms.scriptshizmeti,customBiddingScriptsalmak ve oluşturmak için kullanılır.
Özel teklif verme algoritması oluşturma, komut dosyası yükleme ve özel teklif verme algoritmasını satır öğesinin teklif stratejisi olarak atama sürecini açıklayan Satır Öğelerini Yönetme kılavuzumuza yeni bir Özel Teklif Vermeyi Uygulama sayfası eklendi.
SdfVersion enum değeri eklenerek en yeni SDF sürümü olan v5.4 için destek eklendi.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler customBiddingAlgorithms customBiddingAlgorithms.scripts media Aşağıdaki enum değerleri eklendi:
Enum Değerler SdfVersion
14 Eylül 2021
Hedefleme türleri TARGETING_TYPE_BUSINESS_CHAIN ve TARGETING_TYPE_POI altında yakın çevredeki hedefleme için destek eklendi.
TARGETING_TYPE_BUSINESS_CHAIN ve TARGETING_TYPE_POI hedefleme seçenekleri, targetingTypes.targetingOptions.get veya targetingTypes.targetingOptions.list yöntemleriyle alınamadığından targetingTypes.targetingOptions.search kullanılarak aranabilir.
Ö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
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption CustomBiddingAlgorithm TargetingOption TargetingOptions.search İstek Metni Aşağıdaki enum değerleri eklendi:
Enum Değerler CustomBiddingAlgorithmType Exchange TargetingType Aşağıdaki liste yöntemleri artık aşağıdaki özelliklere göre filtrelenebilir:
Yöntem Alanlar customBiddingAlgorithms.list
4 Ağustos 2021
Hedefleme türü Open Measurement etkin envanter hedefleme için destek eklendi
TARGETING_TYPE_OMID.
pageSize yöntem parametresi kullanılarak çeşitli reklamveren, kampanya, kampanya siparişi ve satır öğesi atanmış hedefleme seçenekleri listesi yöntemlerinin tek bir sayfasında döndürülebilecek maksimum atanmış hedefleme seçeneği sayısı artırıldı.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption TargetingOption Aşağıdaki enum değerleri eklendi:
Enum Değerler TargetingType Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:
26 Mayıs 2021
Kullanıcıların advertisers.invoices hizmetini kullanıma sundu. Bu hizmet sayesinde kullanıcılar:
- Belirli bir ay içinde bir reklamverene düzenlenen faturaları alma
- Belirli bir ay boyunca bir reklamveren tarafından kullanılan para birimi kodunu arama
Kampanya kaynağına campaignBudgets alanı eklendi. Kampanya siparişi bütçe segmentleri, kampanya bütçesine bağlanabilir. Bu durumda, 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 doğal içerik konum hedefleme için destek eklendi.
Reklamveren kaynağına yeni bir prismaEnabled alanı eklendi. Bu alan, kullanıcıların Mediaocean'ın Prisma aracıyla entegrasyonu etkinleştirmesine olanak tanır.
ENTITY_STATUS_PAUSED enum değerinin, reklamverenin entityStatus alanı için desteklenmesi etkinleştirildi.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.invoices Aşağıdaki alanlar eklendi:
Kaynak Alanlar Reklamveren AssignedTargetingOption TargetingOption Aşağıdaki enum değerleri eklendi:
Enum Değerler AssignedTargetingOption.Recency Exchange TargetingType Aşağıdaki enum değerleri artık aşağıdaki alanlar için geçerlidir:
Kaynak Alan Değerler Reklamveren entityStatus ENTITY_STATUS_PAUSED
29 Nisan 2021
Channel ve Negative Keyword List kaynaklarına, hedefleme için kaynağı kullanan satır öğelerinin sayısını döndüren yeni alanlar eklendi. Kullanıcının hedeflemesinde yalnızca belirli kanalları veya negatif anahtar kelime listelerini kullanan satır öğelerini almasına olanak tanıyan, filter
satır öğesi listesi yöntemi için yeni özellikler etkinleştirildi.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar Kanal Aşağıdaki liste yöntemleri artık aşağıdaki özelliklere göre filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
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, verilen satır öğesi türünün yanı sıra ana kampanya siparişinin ayarlarını ve atanmış hedeflemesini temel alır.
Yeni bir kampanya hedefleme hizmeti ve ek toplu liste yöntemi aracılığıyla kampanya hedeflemenin alınmasını etkinleştirdik.
Daha fazla platformdaki uygulamaların 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 fazla değişiklik yapıldı. Bu değişiklikler şunlardır:
- Kullanıcının bir kanalın veya negatif anahtar kelime listesinin mevcut içeriklerinin tamamını üzerine yazmasına olanak tanıyan
replaceyöntemlerinin eklenmesi. - Toplu düzenleme isteklerinin
createdSitesveyacreatedNegativeKeywordsalanlarına mevcut öğelerin dahil edilmemesi şartının kaldırılması. - Liste sitelerinin veya negatif anahtar kelimeleri listeleyen bir yanıtın tek bir sayfasında döndürülebilecek maksimum öğe sayısının artırılması.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption.AppAssignedTargetingOptionDetails Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:
Yöntem Eski Maksimum Sayfa Boyutu Yeni Maksimum Sayfa Boyutu advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
Kullanımdan kaldırmalar
Aşağıdaki numaralandırma değerleri artık yeni veya mevcut kaynaklara atanamaz:
Enum Değerler PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
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. Reklam öğesi kaynağı genişletildi ve üçüncü taraf işitsel reklam öğeleri tarafından kullanılmak üzere yalnızca çıkışa yönelik reklam öğesi alanları eklendi. Kampanya siparişi ve kampanya kaynakları tarafından kullanılmak üzere yeni performans hedefi türleri eklendi.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Aşağıdaki alanlar eklendi:
Kaynak Alanlar Reklam öğesi Aşağıdaki enum değerleri eklendi:
Enum Değerler ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 Ocak 2021
Yeni InsertionOrderType alanı ve yeni LineItemType enum değeri kullanıma sunularak TV kampanya siparişlerinin ve baypas yayın satır öğelerinin alınması ve yönetilmesi etkinleştirildi. mobileApp satır öğesi alanı aracılığıyla mobil uygulama satır öğeleri için destek eklendi.
Ek enum değerleri aracılığıyla 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 eklendi.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar InsertionOrder LineItem Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange GoogleAudienceType LineItemType SdfVersion Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre sıralanabilir ve filtrelenebilir:
Yöntem Alanlar reklamverenler
4 Aralık 2020
Coğrafi bölge hedefleme seçeneklerini arama ve birden fazla kaynak listesi yöntemi sonucunu son güncellenme zamanına göre filtreleme özelliği eklendi. Kullanıcıları, bir satır öğesinin desteği sonlandırılmış coğrafi hedeflemeyi kullandığı zamanlar hakkında bilgilendirmek için yeni bir LineItemWarningMessage eklendi.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler targetingTypes.targetingOptions Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange LineItemWarningMessage Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre sıralanabilir ve filtrelenebilir:
Yöntem Alanlar advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 Kasım 2020
İlişkili satır öğelerinin harcama yapmasını başlatan manuel tetikleyiciler oluşturma, atama ve etkinleştirme özelliği eklendi. Ayarlanması durumunda bir satır öğesinin hedeflemesini, hedeflenen kitlelerdeki kullanıcılara 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 eklenen özel segment kimliği alanları.
Yeni Özellikler
Aşağıdaki hizmetler eklendi:
Hizmet Yöntemler advertisers.manualTriggers Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Aşağıdaki enum değerleri eklendi:
Enum Değerler LineItemFlightDateType Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list
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 özelliklerin yanı sıra yeni kota sınırları da yürürlüğe girdi. Ayrıca, toplu istekleri kullanmayla ilgili yeni dokümanlar da mevcut.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar LineItem Aşağıdaki enum değerleri eklendi:
Enum Değerler PerformanceGoalType Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list
28 Ağustos 2020
Reklamveren denetimi yönteminin yanıtına yeni alanlar ve çeşitli liste yöntemlerine yeni filtrelenebilir alanlar eklendi.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar Advertisers.Audit Response Body Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 Ağustos 2020
Yeni kullanıcı yönetimi, iş ortağı ve iş ortağı hedefleme hizmetleri kullanıma sunuldu. Kullanıcıların hesap öğesi sınırlarına ulaşmasını proaktif olarak önlemelerine yardımcı olacak araçlar kullanıma sunuldu. İşitsel satır öğeleri ile satır öğeleri ve kampanya siparişi teklif stratejilerinde özel teklif verme algoritmalarının kullanımına destek eklendi.
Yeni Özellikler
Aşağıdaki hizmetler eklendi:
Hizmet Yöntemler customBiddingAlgorithms iş ortakları partners.targetingTypes.assignedTargetingOptions users Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler reklamverenler Aşağıdaki alanlar eklendi:
Kaynak Alanlar MaximizeSpendBidStrategy PerformanceGoalBidStrategy Aşağıdaki enum değerleri eklendi:
Enum Değerler BiddingStrategyPerformanceGoalType LineItemType Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre sıralanabilir ve filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list Aşağıdaki kapsamlar, aşağıdaki hizmetlerde kullanılmak üzere eklendi:
Kapsam Hizmetler https://www.googleapis.com/auth/display-video-user-management
24 Haziran 2020
İş ortağı ve reklamveren kanalları için oluşturma yöntemi, yeni FirstAndThirdPartyAudience alanları ve ek exchange enum değerleri ekleyen küçük bir güncelleme yayınlandı.
Yeni Özellikler
Aşağıdaki hizmetler eklendi:
Hizmet Yöntemler advertisers.channels partners.channels Aşağıdaki alanlar eklendi:
Kaynak Alanlar FirstAndThirdPartyAudience Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.creatives.list
2 Haziran 2020
Hedeflenebilir öğelerin bir alt kümesini oluşturma, düzeltme 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
Aşağıdaki hizmetler eklendi:
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler reklamverenler advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Aşağıdaki alanlar eklendi:
Kaynak Alanlar advertiser creative insertionOrder.insertionOrderBudgetSegment
27 Nisan 2020
API'nin kapsamını SDF'nin ötesine genişleten büyük bir özellik seti kullanıma sunuldu. Reklamverenler, kampanyalar, yayınlanma siparişleri, satır öğeleri ve reklam öğeleri gibi öğeleri 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:
9 Mart 2020
Display & Video 360 API v1'i kullanıma sundu. Bu, API'nin ilk sürümüdür.
Bilinen sorunlar
Yok.