v1'den v2'ye geçiş

Son güncelleme: 06.12.2022

Uygulamanızı taşıma

V1'den v2'ye geçiş yapmak için uç nokta URL'lerinizi v2'yi çağıracak şekilde güncellemeniz ve uygulamanızı, önemli değişiklikleri hesaba katacak şekilde güncellemeniz gerekir.

API çağrılarınızı v1'den v2'ye güncelleme

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

2. sürüm 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 son sürümünü kullanın ve yapılandırmanızı v2 sürümünü kullanacak şekilde güncelleyin.

Gerekli değişiklikleri yapın

2. sürümde bazı önemli değişiklikler yapıyoruz. Aşağıdaki talimatları inceleyin ve Display & Video 360 API'yi mevcut kullanımınızla ilgili 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 atanıyor. Örneğin, tablet cihazlar artık targetingTypes.targetingOptions hizmetindeki hedefleme seçeneği kimliği yerine doğrudan DEVICE_TYPE_TABLET DeviceType enum ile 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.

• ProximityRadiusRange enum değeri yerine yararlanmış bir yarıçap boyutu ve mesafe birimi kullanacak şekilde TARGETING_TYPE_PROXIMITY_LOCATION_LIST değerini yöneten çağrıları 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ı.

  Aşağıdaki yöntemlerin çağrılarını yeni adlarıyla kullanmak için 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

Aramaları advertisers.lineItems hizmetine yönlendirme

• inventorySourceIds alanı kaldırıldı. TARGETING_TYPE_INVENTORY_SOURCE'in AssignedTargetingOption kaynaklarını kullanarak envanter kaynağı atamasını yönetin.

• Aşağıdaki LineItemWarningMessage enum değerlerinin desteği v2'de sonlandırıldı ve artık LineItem.warningMessages'te gösterilmeyecek:

  • 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, LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER değeri ise LineItemFlightDateType enum türünden kaldırıldı. v2, satır öğelerinin manuel tetikleyicilerin etkinleştirilmesine göre harcama yapmasına yönelik ayarı desteklemez.

Aramaları customBiddingAlgorithms hizmetine yönlendirme

customBiddingAlgorithmState ve modelReadiness alanları, CustomBiddingModelDetails nesnelerinin listesi aracılığıyla erişimi olan her reklamveren için mevcut algoritma modelinin hazırlık ve askıya alma durumlarını sağlayan modelDetails alanıyla değiştirildi.

Ek değişiklikler

2. sürüm, yukarıda listelenen önemli değişikliklere ek olarak yeni özellikler de sunar.

İlk lansmandan sonra sürüm 2'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 okunur erişim sağlar. Bu, bu satır öğelerine yönelik tüm yazma isteklerinin hata döndüreceği anlamına gelir. YouTube satır öğeleri aşağıdaki LineItemType değerlerinden biri 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 hizmetinin 2. sürümünde, daha iyi performans ve daha az kota tüketimi için toplu istekler yerine kullanılabilecek yeni yöntemler sunulur:

• Birden fazla satır öğesi için aynı alan değerlerini ayarlamak üzere advertisers.lineItems.bulkUpdate kullanabilirsiniz. Şu anda yalnızca entityStatus alanındaki güncellemeler desteklenmektedir.
• Birden fazla satır öğesinde aynı atanmış hedefleme seçeneklerini eklemek veya kaldırmak için advertisers.lineItems.bulkEditAssignedTargetingOptions simgesini kullanabilirsiniz.
• Atanmış hedefleme seçeneklerini birden fazla satır öğesinde listelemek için advertisers.lineItems.bulkListAssignedTargetingOptions simgesini kullanabilirsiniz.
• Aynı kampanya siparişindeki mevcut bir satır öğesinin kopyasını oluşturmak için advertisers.lineItems.duplicate simgesini kullanarak tüm yapılandırmaları ve hedefleme ayarlarını kopyalayabilirsiniz.

Kampanya siparişi hedefleme için kısmi yazma erişimi

2. sürümde, advertisers.insertionOrders.targetingTypes.assignedTargetingOptions hizmetindeki yeni create ve delete yöntemlerini kullanarak InsertionOrder kaynakları için hedefleme ayarlarının alt kümesini düzenleyebilirsiniz. Aşağıdaki hedefleme türleri kampanya siparişi seviyesinde tamamen 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