v1'den v2'ye geçiş

Son güncelleme: 06.12.2022

Uygulamanızı taşıma

v1'den v2'ye taşıma işlemi için uç nokta URL'lerinizin v2'ye ve uygulamanızı güncelleyerek zarar veren değişiklikleri hesaba katabilirsiniz.

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

v1 yerine v2'yi kullanmak için isteklerinizi yeni v2'yi kullanacak şekilde güncellemeniz gerekir uç noktalar.

Örneğin, advertisers.get yöntemini v1 ile çağırmak için aşağıdaki URL'yi kullanın:

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

Gerekli değişiklikleri yapın

2. sürümde, zarar veren bazı değişiklikler yapıyoruz. Aşağıdakileri inceleyin geçerli talimatları ve mevcut Görüntülü Reklam ve Video 360 API.

Hedefleme yöntemlerine yapılan çağrıları güncelleme

• Bazı hedefleme türleri artık hedefleme yerine enum değerleri kullanılarak atanıyor seçenek kimlikleri. Örneğin, tablet cihazlar artık doğrudan DEVICE_TYPE_TABLET DeviceType sıralaması, hedefleme seçeneği kimliği yerine targetingTypes.targetingOptions hizmeti. Dize versiyonları bu sıralamalar yeni assignedTargetingOptionIdAlias alanı AssignedTargetingOption kaynaklarına sahiptir ve alınırken ya da Mevcut hedeflemeyi silme. assignedTargetingOptionId değeri bu AssignedTargetingOption kaynaktan değişiklik yapılmadı.

  Aşağıdaki hedefleme türlerini yöneten çağrıları, numaralandırma 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 , yöntem ile değiştirildi advertisers.lineItems.bulkEditAssignedTargetingOptions.

• advertisers.lineItems.bulkListLineItemAssignedTargetingOptions yöntemi , yöntem ile değiştirildi advertisers.lineItems.bulkListAssignedTargetingOptions.

• TARGETING_TYPE_PROXIMITY_LOCATION_LIST arama yönetimi ayarlarını güncelleme belirlemek için belirli bir yarıçap boyutu ve bir mesafe birimi ProximityRadiusRange sıralama değeri.

• Birden fazla hedefleme seçeneğini alan veya düzenleyen hedefleme yöntemleri tek bir üst kaynak altındaki hedefleme türleri yeniden adlandırıldı.

  Çağrıları, yeni adlarını kullanmak için aşağıdaki yöntemlere güncelleyin:

  • advertisers.bulkEditAdvertiserAssignedTargetingOptions ve advertisers.editAssignedTargetingOptions
  • advertisers.bulkListAdvertiserAssignedTargetingOptions ve advertisers.listAssignedTargetingOptions
  • advertisers.campaigns.bulkListCampaignAssignedTargetingOptions ve advertisers.campaigns.listAssignedTargetingOptions
  • advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions ve advertisers.insertionOrders.listAssignedTargetingOptions
  • partners.bulkEditPartnerAssignedTargetingOptions - partners.editAssignedTargetingOptions

advertisers.lineItems hizmetine yapılan aramaları güncelle

• inventorySourceIds alanı kaldırıldı. Yönet AssignedTargetingOption kaynaklarını kullanarak envanter kaynağı ataması TARGETING_TYPE_INVENTORY_SOURCE.

• Aşağıdaki LineItemWarningMessage enum değerlerinde desteği v2'de sonlandırılmıştır ve artık LineItem.warningMessages:

  • 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 nesnesi ve LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER değeri LineItemFlightDateType sıralama türü. v2 desteklemez manuel tetikleyicilerin etkinleştirilmesine göre satır öğelerini harcama yapacak şekilde ayarlama.

customBiddingAlgorithms hizmetine yapılan aramaları güncelle

customBiddingAlgorithmState ve modelReadiness alanları, modelDetails ile değiştirildi alanına giderek hazırlık sağlayabilirsiniz. ve mevcut algoritmanın askıya alma durumları erişimi olan her reklamveren için bir model CustomBiddingModelDetails nesneleri için de uygun olduğundan emin olun.

Ek değişiklikler

v2, yukarıda listelenen zarar veren değişikliklere ek olarak, özellikleri.

İlk lansmandan sonra v2'ye eklenen özellikleri şurada bulabilirsiniz: sürüm notlarını inceleyin.

YouTube satır öğelerine salt okuma erişimi

v2'de, YouTube satır öğeleri ve bunların hedefleme ayarları advertisers.lineItems ve advertisers.lineItems.targetingTypes.assignedTargetingOptions hizmetleridir. API salt okuma erişimi sağlar. Yani, bu satır öğelerine yapılan yazma istekleri hata döndürür. YouTube satır öğesi şunlardan biri olacaktır: LineItemType değerleri:

• 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

v2'de advertisers.lineItems hizmeti, daha iyi sonuçlar elde etmek için toplu istekler yerine kullanılacak performans ve daha düşük kota tüketimi:

• Aşağıdaki değeri ayarlamak için advertisers.lineItems.bulkUpdate aracını kullanabilirsiniz: birden fazla satır öğesi için aynı alan değerlerine sahip olmalıdır. Yalnızca entityStatus alanı şu anda desteklenmektedir.
• Tekliflerinizi otomatikleştirmek ve optimize etmek için advertisers.lineItems.bulkEditAssignedTargetingOptions Birden fazla satırda, aynı atanmış hedefleme seçeneklerini eklemek veya kaldırmak için öğeler.
• Tekliflerinizi otomatikleştirmek ve optimize etmek için advertisers.lineItems.bulkListAssignedTargetingOptions kullanarak birden fazla satır öğesinde atanan hedefleme seçeneklerini listeleyin.
• Kopya oluşturmak için advertisers.lineItems.duplicate aracını kullanabilirsiniz aynı kampanya siparişinde bulunan mevcut bir satır öğesinin, tüm satır öğelerinin yapılandırmaları ve hedefleme ayarlarını değiştirebilir.

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

v2'de, InsertionOrder için bir alt küme hedefleme ayarlarını düzenleyebilirsiniz yeni create ve delete yöntemleri advertisers.insertionOrders.targetingTypes.assignedTargetingOptions geliştirmenizi sağlar. Aşağıdaki hedefleme türleri, ekleme sırasında tümüyle yönetilebilir sipariş düzeyi:

• 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