Son güncelleme: 06.12.2022
Uygulamanızı taşıyın
v1'den v2'ye geçiş yapmak için uç nokta URL'lerinizin v2'yi çağıracak şekilde güncellenmesi ve uygulamanızı, zarar veren değişiklikleri hesaba katacak şekilde güncellemeniz gerekir.
API çağrılarınızı v1'den v2'ye güncelleyin
v1 yerine v2'yi kullanmak için isteklerinizi yeni v2 uç noktalarını kullanacak şekilde güncellemeniz gerekir.
Örneğin, advertisers.get
yöntemini v1 ile çağırmak için aşağıdaki URL'yi kullanırsınız:
GET https://displayvideo.googleapis.com/v1/advertisers/advertiserId
v2 için URL'yi aşağıdaki şekilde güncelleyin:
GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId
API'ye istek göndermek için bir istemci kitaplığı kullanıyorsanız istemci kitaplığının en yeni sürümünü kullanın ve yapılandırmanızı v2'yi kullanacak şekilde güncelleyin.
Gerekli değişiklikleri yapın
v2'de bazı zarar veren değişiklikler yapıyoruz. Aşağıdaki talimatları inceleyin ve Display & Video 360 API'yi mevcut kullanımınızla ilgili olarak gerekli değişiklikleri yapın.
Hedefleme yöntemlerine yapılan çağrıları güncelleme
Bazı hedefleme türleri, artık hedefleme seçeneği kimlikleri yerine enum değerleri kullanılarak atanmaktadır. Örneğin, tablet cihazlar artık
targetingTypes.targetingOptions
hizmetindeki hedefleme seçeneği kimliği yerine doğrudanDEVICE_TYPE_TABLET
DeviceType
sıralamasıyla hedefleniyor. Bu enum'ların dize sürümleri, buAssignedTargetingOption
kaynaklarındaki yeniassignedTargetingOptionIdAlias
alanında temsil edilir ve mevcut hedeflemeyi alırken veya silerken kullanılabilir. BuAssignedTargetingOption
kaynaklarınınassignedTargetingOptionId
değeri değişmedi.Aşağıdaki hedefleme türlerini yöneten çağrıları, enum değerlerini kullanacak şekilde güncelleyin:
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_CONTENT_INSTREAM_POSITION
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_EXCHANGE
TARGETING_TYPE_GENDER
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_NATIVE_CONTENT_POSITION
TARGETING_TYPE_OMID
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_VIDEO_PLAYER_SIZE
TARGETING_TYPE_VIEWABILITY
advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions
yöntemi,advertisers.lineItems.bulkEditAssignedTargetingOptions
yöntemiyle değiştirildi.advertisers.lineItems.bulkListLineItemAssignedTargetingOptions
yöntemi,advertisers.lineItems.bulkListAssignedTargetingOptions
yöntemiyle değiştirildi.TARGETING_TYPE_PROXIMITY_LOCATION_LIST
yöneten çağrıları,ProximityRadiusRange
sıralama değeri yerine ayarlanmış bir yarıçap boyutu ve mesafe birimi kullanacak şekilde güncelleyin.Tek bir üst kaynak altında, birden fazla hedefleme türünde hedefleme seçeneklerini alan veya düzenleyen hedefleme yöntemleri yeniden adlandırıldı.
Yeni adlarını kullanmak için aşağıdaki yöntemlere yapılan çağrıları güncelleyin:
advertisers.bulkEditAdvertiserAssignedTargetingOptions
-advertisers.editAssignedTargetingOptions
advertisers.bulkListAdvertiserAssignedTargetingOptions
-advertisers.listAssignedTargetingOptions
advertisers.campaigns.bulkListCampaignAssignedTargetingOptions
-advertisers.campaigns.listAssignedTargetingOptions
advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions
-advertisers.insertionOrders.listAssignedTargetingOptions
partners.bulkEditPartnerAssignedTargetingOptions
-partners.editAssignedTargetingOptions
advertisers.lineItems
hizmetine yapılan çağrıları güncelle
inventorySourceIds
alanı kaldırıldı.TARGETING_TYPE_INVENTORY_SOURCE
öğesininAssignedTargetingOption
kaynaklarını kullanarak envanter kaynağı atamasını yönetin.Aşağıdaki
LineItemWarningMessage
enum değerleri v2'de kullanımdan kaldırılmıştır ve artıkLineItem.warningMessages
'te gösterilmeyecektir:NO_POSITIVE_AUDIENCE_LIST_TARGETED
APP_INSTALL_NO_CONVERSION_PIXEL
TARGETING_REVOKED_OR_CLOSED_USER_LIST
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
TARGETING_DEPRECATED_GEO_TARGET
triggerId
alanıLineItemFlight
nesnesinden kaldırıldı veLINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
değeriLineItemFlightDateType
sıralama türünden kaldırıldı. v2, satır öğelerinin manuel tetikleyicilerin etkinleştirilmesine göre harcanacak şekilde ayarlanmasını desteklemez.
customBiddingAlgorithms
hizmetine yapılan çağrıları güncelle
customBiddingAlgorithmState
ve modelReadiness
alanları, CustomBiddingModelDetails
nesne listesi aracılığıyla erişimi olan her reklamveren için mevcut algoritma modelinin hazır olma ve askıya alınma durumlarını sağlayan modelDetails
alanıyla değiştirildi.
Ek değişiklikler
2. sürüm, yukarıda listelenen zarar veren değişikliklere ek olarak yeni özellikler de sunar.
İlk lansmandan sonra v2'ye eklenen özellikleri sürüm notlarımızda bulabilirsiniz.
YouTube satır öğelerine salt okuma erişimi
2. sürümde, YouTube satır öğeleri ve hedefleme ayarları sırasıyla advertisers.lineItems
ve advertisers.lineItems.targetingTypes.assignedTargetingOptions
hizmetleri kullanılarak alınabilir. API salt okuma erişimi sağlar. Diğer bir deyişle, bu satır öğelerine yapılan tüm yazma istekleri hata döndürür. YouTube satır öğeleri, aşağıdaki LineItemType
değerlerinden birinde olacaktır:
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_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
Daha iyi performans sağlayan yeni yöntemler
advertisers.lineItems
hizmeti, v2'de daha iyi performans ve daha düşük kota tüketimi için toplu istekler yerine kullanılacak yeni yöntemler sunar:
- Birden fazla satır öğesinde aynı alan değerlerini ayarlamak için
advertisers.lineItems.bulkUpdate
kullanabilirsiniz. Şu anda yalnızcaentityStatus
alanında yapılan güncellemeler desteklenmektedir. - Birden fazla satır öğesinde aynı atanmış hedefleme seçeneklerini eklemek veya kaldırmak için
advertisers.lineItems.bulkEditAssignedTargetingOptions
kullanabilirsiniz. - Birden fazla satır öğesinde atanan hedefleme seçeneklerini listelemek için
advertisers.lineItems.bulkListAssignedTargetingOptions
kullanabilirsiniz. - Aynı kampanya siparişindeki mevcut bir satır öğesinin kopyasını oluşturmak için
advertisers.lineItems.duplicate
aracını kullanabilir, tüm yapılandırmaları ve hedefleme ayarlarını kopyalayabilirsiniz.
Kampanya siparişi hedefleme için kısmi yazma erişimi
v2'de, advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
hizmetindeki yeni create
ve delete
yöntemlerini kullanarak InsertionOrder
kaynakları için alt küme hedefleme ayarlarını düzenleyebilirsiniz. Aşağıdaki hedefleme türleri, kampanya siparişi seviyesinde tümüyle yönetilebilir:
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_BROWSER
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_CHANNEL
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_GENDER
TARGETING_TYPE_KEYWORD
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_VIEWABILITY