v1'den v2'ye geçiş

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ğrudan DEVICE_TYPE_TABLET DeviceType sıralamasıyla hedefleniyor. Bu enum'ların dize sürümleri, bu AssignedTargetingOption kaynaklarındaki yeni assignedTargetingOptionIdAlias alanında temsil edilir ve mevcut hedeflemeyi alırken veya silerken kullanılabilir. Bu AssignedTargetingOption kaynaklarının assignedTargetingOptionId 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 öğesinin AssignedTargetingOption 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ık LineItem.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ı ve LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER değeri LineItemFlightDateType 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ızca entityStatus 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