Bu sayfada, Görüntülü Reklam Ağı ve Video 360 API.
En son API sürümü: v3
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
Satır Öğesi ve Reklam Grubu Yapılandırılmış Veri Dosyalarını indirme desteği eklendi v3'teki QA biçimi.
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 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
Aşağıdaki alanlar eklendi:
Kaynak Alanlar InsertionOrder Aşağıdaki yöntemler artık aşağıdaki hedefleme türlerini desteklemektedir:
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 desteklemektedir:
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, exchange'ler 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
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
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'yi yüklerken son kullanıcı iznini iletme desteği eklendi tüm canlı versiyonlarda kitle üyelerini kullanın.
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 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ı:
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 herkese açık beta olarak yayınlandı:
- Yakın çevredeki konum listelerini tümüyle yöneterek
Oluşturmak için
advertisers.locationLists.assignedLocations
hizmeti veTARGETING_LOCATION_TYPE_PROXIMITY
adlı kullanıcıya atanan konumları silinLocationList
kaynakları hakkında daha fazla bilgi edinin. - Yeni boole
enableOptimizedTargeting
alanıtargetingExpansionLevel
alanının yerini alanTargetingExpansionConfig
nesnesini ifade eder. billingConfig
alanının Oluşturma işlemi sırasında dahil edilmesi gerekenAdvertiser
kaynağıadvertisers.create
istekleri ve yeni birPartner
alanındakibillingConfig
alanı gösterir.- Şu özelliklere sahip yeni
AdGroup
veAdGroupAd
kaynakları: v2'dekiYoutubeAdGroup
veYoutubeAdGroupAd
kaynaklarını değiştirin.
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
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ışı değişti:
Yöntem Değişiklikler advertisers.locationLists.create Artık TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarının oluşturulmasını destekliyor.advertisers.locationLists.patch Artık TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarının güncellenmesini destekliyor.advertisers.locationLists.assignedLocations.bulkEdit Artık TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarındakiAssignedLocation
kaynaklarının toplu olarak düzenlenmesini destekliyor.advertisers.locationLists.assignedLocations.create Artık TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarındaAssignedLocation
kaynaklarının oluşturulmasını 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 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
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
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:
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
Ş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:
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ı 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
seviyesinde olmalıdır. YouTube ve Google Cloud ürünlerine dair İş Ortakları
kaynakları inceleyin.
v1 ve v2'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 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
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'de bilinen aşağıdaki bilinen sorunları düzeltir:
- Sıralama kullanılarak atanan hedefleme türlerinin atanmış hedefleme seçenekleri
v2'deki değerler kaldırılamadı veya alınamadı
assignedTargetingOptionId
kullandığını ve bunun yerine enum değerini kullanmasını sağlar. Bu güncellemeyle birlikte, söz konusu atanan hedeflemeler seçenekleri,assignedTargetingOptionId
veya yeniassignedTargetingOptionIdAlias
alanınıAssignedTargetingOption
kaynağı. bulkUpdate
satır öğesi isteği, doğru şekilde kullanılmadıadvertisersId
istek parametresi, hata döndürüyor. Bu güncellemeyle, bu yöntem düzeltildi ve istek parametresiadvertisersId
-advertiserId
.
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
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
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ı:
- YouTube ve İş ortakları satır öğeleri ve hedeflemeleri
ayarları
advertisers.lineItems
içindeget
velist
yöntemlerini kullanarak veadvertisers.lineItems.targetingTypes.assignedTargetingOptions
hizmetleri. advertisers.lineItems
hizmetinde iki yeni toplu hedefleme yöntemi var düzenleme ve alma özelliğini etkinleştiren birden fazla satır öğesinde atanmış hedefleme, tek istek.- Kullanıcıların
bulkUpdate
Tek bir istekte birden fazla satır öğesindenentityStatus
. AssignedTargetingOption
gerektiren yeni hedefleme mantığı bir hedefleme türü alt kümesinin kaynakları hedefleme seçeneği kimlikleri yerine enum değerleri kullanılarak atanıp alınırtargetingTypes.targetingOptions
hizmeti kullanılarak alınır.
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:
Aşağıdaki yöntemler v2'ye eklenmiştir:
Hizmet Yöntemler advertisers.lineItems bulkEditAssignedTargetingOptions
Aşağıdaki yöntemler v2'de kaldırılmıştır:
Hizmet Yöntemler advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Aşağıdaki yöntemler v2'de yeniden adlandırılmıştır:
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ürlerinin
AssignedTargetingOption
kaynakları, v2'deki hedefleme ataması için enum'ları kullanır. Bu hedefleme türlerininAssignedTargetingOption
kaynaklarınınassignedTargetingOptionId
alanı, enum değerlerinin dize sürümlerini kullanmak için v2'de de 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ı:
v2'de aşağıdaki alanlar zorunlu hale getirildi:
v2'de aşağıdaki sıralama değerleri 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 sıralama 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 sıralama değerleri eklendi:
Enum Değ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
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 özellikler tarafından filtrelenebilir:
Yöntem Alanlar advertisers.creatives.list
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
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
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
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ü altında ses içeriği türü hedefleme desteği eklendi
TARGETING_TYPE_AUDIO_CONTENT_TYPE
.
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ı ve komut dosyalarını yönetmek için tam destek eklendi. Bunlardan bazıları:
- Yeni oluşturma ve mevcut güncelleme işlevleri
customBiddingAlgorithms
. - Komut dosyalarını son 30 güne ait kullanılabilir bir kaynak konumunu alma ve ardından dosyayı ilgili konuma yükleyin.
- Yeni bir
customBiddingAlgorithms.scripts
hizmeti alın ve oluşturcustomBiddingScripts
.
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
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler customBiddingAlgorithms customBiddingAlgorithms.scripts medya Aşağıdaki enum değerleri eklendi:
Enum Değerler SdfVersion
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
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption CustomBiddingAlgorithm TargetingOption HedeflemeOptions.search İstek Gövdesi Aşağıdaki enum değerleri eklendi:
Enum Değerler CustomBiddingAlgorithmType Exchange TargetingType Aşağıdaki liste yöntemleri artık aşağıdaki özellikler tarafından filtrelenebilir:
Yöntem Alanlar customBiddingAlgorithms.list
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 pageSize
yöntem parametresini kullanarak.
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
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
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 Borsa TargetingType Aşağıdaki enum değerleri artık şu alanlar için geçerlidir:
Kaynak Alan Değerler Reklamveren entityStatus ENTITY_STATUS_PAUSED
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
Aşağıdaki alanlar eklendi:
Kaynak Alanlar Kanal Aşağıdaki liste yöntemleri artık aşağıdaki özellikler tarafından filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
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:
- Kullanıcının tamamen üzerine yazmasını sağlayan
replace
yöntemlerinin eklenmesi bir kanalın veya negatif anahtar kelime listesinin mevcut içeriklerini gösterir. - Mevcut herhangi bir sözleşmenin zorunlu olarak
createdSites
veyacreatedNegativeKeywords
toplu düzenleme alanı kabul edersiniz. - Tek bir seferde iade edilebilecek maksimum öğe sayısındaki artış siteleri listelemenin veya negatif anahtar kelimeleri listeleme yanıtı.
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 enum değerleri artık yeni veya mevcut kaynaklara atanamaz:
Enum Değerler PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
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 ataması yapıldı. 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
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
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
Aşağıdaki alanlar eklendi:
Kaynak Alanlar InsertionOrder LineItem Aşağıdaki enum değerleri eklendi:
Enum Değerler Borsa GoogleAudienceType LineItemType SdfVersion Aşağıdaki liste yöntemleri artık şu alanlara göre sıralanabilir ve filtrelenebilir:
Yöntem Alanlar reklamverenler
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
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler targetingTypes.targetingOptions Aşağıdaki enum değerleri eklendi:
Enum Değerler Borsa LineItemWarningMessage Aşağıdaki liste yöntemleri artık şu alanlara göre sıralanabilir ve filtrelenebilir:
Yöntem Alanlar advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
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
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 şu alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list
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
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 şu alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list
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
Aşağıdaki alanlar eklendi:
Kaynak Alanlar Reklamverenler.Denetim Yanıtı Gövdesi Aşağıdaki liste yöntemleri artık şu 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 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
Aşağıdaki hizmetler eklendi:
Hizmet Yöntemler customBiddingAlgorithms iş ortakları partners.targetingTypes.assignedTargetingOptions kullanıcılar 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 şu alanlara göre sıralanabilir ve filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list Aşağıdaki kapsamlar, şu hizmetler için 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 sıralama değerleri ekleyerek küçük bir güncelleme kullanıma sunuldu.
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 Borsa Aşağıdaki liste yöntemleri artık şu alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.creatives.list
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
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 reklamveren reklam öğesi insertionOrder.insertionOrderBudgetSegment
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:
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.