本頁提供 Display & Video 360 API 淘汰版本的版本資訊。
如要查看所有發布版本 (包括正式版),請前往主要版本資訊頁面。
2024 年 12 月 4 日
新功能
新增對 Core 和 Tubi Exchange 值的支援。
將 firstAndThirdPartyAudiences.list 的網頁大小上限從 200 增加到 5000。更新 firstAndThirdPartyAudiences.list 要求的 pageSize 參數,進一步最佳化配額用量。
v3
新增下列列舉值:
列舉 值 ExchangeEXCHANGE_COREEXCHANGE_TUBI下列清單方法的頁面大小上限已提高:
方法 新的最大頁面大小 firstAndThirdPartyAudiences.list5000
2024 年 10 月 22 日
新功能
新增支援單次收視出價成效目標。
新增設定及擷取連結裝置指定目標的功能。
在「第三方驗證工具指定目標」下方新增 Adloox 品牌安全設定。
新增支援下載 v8 結構化資料檔案,目前為封測階段。
v3
新增下列欄位:
物件 欄位 AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContent新增下列列舉值:
列舉 值 DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
已淘汰的值
由於 SDF 第 5.5 版已於 2024 年 10 月 3 日停用,因此我們已停止支援該版本。
v3
下列列舉值已淘汰:
列舉 值 SdfVersionSDF_VERSION_5_5
2024 年 8 月 15 日
新功能
新增支援 Netflix Exchange 類型。
v3
新增下列列舉值:
列舉 值 廣告交易平台 EXCHANGE_NETFLIX
v2
新增下列列舉值:
列舉 值 廣告交易平台 EXCHANGE_NETFLIX
2024 年 7 月 15 日
新功能
在第 3 版中,新增支援以 QA 格式下載委刊項和廣告群組結構化資料檔案。
v3
2024 年 6 月 17 日
新功能
開始支援管理在廣告主層級指派的關鍵字指定目標。
在廣告訂單資源中新增 optimizationObjective 欄位。optimizationObjective 僅適用於許可清單中的客戶。
v3
新增下列欄位:
資源 欄位 InsertionOrder 下列方法現在支援下列指定目標類型:
v2
下列方法現在支援下列指定目標類型:
2024 年 5 月 30 日
新功能
新增結構化資料檔案 (SDF) 7.1 版的支援。
v3
新增下列列舉值:
列舉 值 SdfVersion SDF_VERSION_7_1
v2
新增下列列舉值:
列舉 值 SdfVersion SDF_VERSION_7_1
2024 年 4 月 23 日
新功能
新增對新 KPI 類型、交易平台和應用程式平台的支援。
v3
新增下列欄位:
資源 欄位 Kpi 新增下列列舉值:
列舉 值 AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
廣告交易平台 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
新增下列列舉值:
列舉 值 AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
廣告交易平台 EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
2024 年 2 月 28 日
新功能
新增從目標顧客比對目標對象中明確移除成員的功能。
新增指定新廣告交易平台的支援功能。
v3
新增下列欄位:
資源 欄位 firstAndThirdPartyAudiences.editCustomerMatchMembers 新增下列列舉值:
列舉 值 廣告交易平台 EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
新增下列欄位:
資源 欄位 firstAndThirdPartyAudiences.editCustomerMatchMembers 新增下列列舉值:
列舉 值 廣告交易平台 EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
2024 年 1 月 29 日
新功能
新增透過新 floodlightGroups.floodlightActivities 服務擷取 Floodlight 活動的功能。
新增欄位,說明 YouTube 與合作夥伴委刊項的指定目標是否包含 Google TV 廣告空間。
新增欄位,用於轉送 Display & Video 360 使用者的上次登入時間。
v3
新增了下列方法:
服務 方法 floodlightGroups.floodlightActivities 新增下列欄位:
資源 欄位 使用者 YoutubeAndPartnersInventorySourceConfig
v2
新增了下列方法:
服務 方法 floodlightGroups.floodlightActivities 新增下列欄位:
資源 欄位 使用者 YoutubeAndPartnersInventorySourceConfig
2023 年 11 月 14 日
新功能
在所有正式版中,上傳目標顧客比對目標對象成員時,現在支援傳遞使用者同意聲明。
v3
新增下列欄位:
資源 欄位 ContactInfoList MobileDeviceIdList
v2
新增下列欄位:
資源 欄位 ContactInfoList MobileDeviceIdList
2023 年 10 月 31 日
新功能
v3 已從公開 Beta 版轉為正式發布版。
在第 3 版中,我們重新命名了 AdGroupFormat 列舉值,以更準確地反映相關格式。
新增 SDF_VERSION_7 列舉值 (第 2 版和第 3 版),支援結構化資料檔案第 7 版。
v3
下列列舉值已移除:
列舉 值 AdGroupFormat AD_GROUP_FORMAT_ACTION
新增下列列舉值:
列舉 值 AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
新增下列列舉值:
列舉 值 SdfVersion SDF_VERSION_7
2023 年 10 月 2 日
新功能
公開發布第 3 版測試版,包含下列變更:
- 可完整管理鄰近地區清單,並使用
advertisers.locationLists.assignedLocations服務建立及刪除指派給TARGETING_LOCATION_TYPE_PROXIMITYLocationList資源的位置。 - 新的布林值
enableOptimizedTargeting欄位,取代TargetingExpansionConfig物件中的targetingExpansionLevel欄位。 Advertiser資源中的billingConfig欄位規定,在提出advertisers.create要求時必須包含該欄位,以及Partner資源中的新billingConfig欄位。- 取代第 2 版中
YoutubeAdGroup和YoutubeAdGroupAd資源的新AdGroup和AdGroupAd資源。
請按照遷移指南中的步驟,從第 2 版遷移至第 3 版。
在第 2 版和第 3 版中,新增了 3 個 LineItemType 值、1 個 YoutubeAndPartnersBiddingStrategyType 和 1 個 PartnerCostType。
v3
新增了下列方法:
服務 方法 advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules 下列方法已移除:
服務 方法 advertisers.manualTriggers 啟用
create
停用。
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
下列方法行為已變更:
方法 變更 advertisers.locationLists.create 現在支援建立 TARGETING_LOCATION_TYPE_PROXIMITYLocationList資源。advertisers.locationLists.patch 現在支援更新 TARGETING_LOCATION_TYPE_PROXIMITYLocationList資源。advertisers.locationLists.assignedLocations.bulkEdit 現在支援在 TARGETING_LOCATION_TYPE_PROXIMITYLocationList資源中大量編輯AssignedLocation資源。advertisers.locationLists.assignedLocations.create 現在支援在 TARGETING_LOCATION_TYPE_PROXIMITYLocationList資源中建立AssignedLocation資源。已新增下列查詢參數:
方法 參數 inventorySources.get 下列欄位已設為必填:
資源 欄位 廣告主 新增下列欄位:
資源 欄位 BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig 下列欄位已遭移除:
資源 欄位 InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
新增下列列舉值:
列舉 值 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
下列列舉值已移除:
列舉 值 LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
新增下列列舉值:
列舉 值 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
2023 年 8 月 25 日
新功能
新增對兩個交易平台的支援,以及兩種新的 YouTube 與合作夥伴出價策略類型。
在 YouTube 與合作夥伴委刊項中新增 effectiveContentCategory 欄位,以便在考量廣告主和委刊項層級指派的值時,顯示委刊項使用的 YoutubeAndPartnersContentCategory。
v2
新增下列欄位:
資源 欄位 YoutubeAndPartnersSettings 下列欄位已遭移除:
資源 欄位 InventorySource subSitePropertyId
新增下列列舉值:
列舉 值 廣告交易平台 EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
2023 年 6 月 5 日
新功能
在第 1 版和第 2 版中,為結構化資檔案 (SDF) 第 6 版新增 SdfVersion 值。
v2
新增下列列舉值:
列舉 值 SdfVersion SDF_VERSION_6
v1
新增下列列舉值:
列舉 值 SdfVersion SDF_VERSION_6
2023 年 3 月 9 日
新功能
新增 LineItemWarningMessage 值,如果委刊項的 excludeFirstPartyAudience 欄位已設為 true,系統就會將這個值指派給委刊項的 warningMessages 欄位。excludeFirstPartyAudience 欄位將於 2023 年 3 月 25 日停用,並設為 false。
v2
新增下列列舉值:
列舉 值 LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
新增下列列舉值:
列舉 值 LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
2023 年 2 月 8 日
新功能
新增擷取 YouTubeAdGroup 和 YouTubeAdGroupAd 資源的功能,以及 YouTube 廣告群組資源指定目標。此外,我們也新增了可在 YouTube 廣告群組層級使用的可擷取指定目標類型。詳情請參閱這篇新指南頁面,瞭解如何擷取 YouTube 與合作夥伴資源。
在第 1 版和第 2 版中,新增對四個額外交易所的支援。
v2
新增了下列方法:
服務 方法 advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions 新增下列欄位:
服務 方法 AssignedTargetingOption YoutubeAndPartnersSettings 新增下列列舉值:
列舉 值 廣告交易平台 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
新增下列列舉值:
列舉 值 廣告交易平台 EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
2022 年 12 月 6 日
新功能
將 v2 從公開 Beta 版移至正式發布版。
在 AssignedTargetingOption 資源中新增 assignedTargetingOptionIdAlias 欄位,可用於擷取及刪除指定目標,取代 assignedTargetingOptionId。這個欄位只會針對透過列舉指派的指定類型,設定指派的指定選項。別名值是相關的列舉值 (以字串形式表示)。
在 Advertiser 資源中新增 billingConfig 欄位。
新增支援功能,可擷取 YouTube 與合作夥伴的 OTT 委刊項,
並以三個新的 LineItemType 值識別。
在第 1 版和第 2 版中,多個 list 方法的最大網頁大小已增加至 200。預設頁面大小不會變更。
v2
新增下列欄位:
資源 欄位 廣告主 AssignedTargetingOption 新增下列列舉值:
列舉 值 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
下列清單方法的頁面大小上限已提高:
v1
下列清單方法的頁面大小上限已提高:
已知問題
這項更新修正了第 2 版的下列已知問題:
- 使用 v2 中的列舉值指派的指定目標類型,其指派的指定目標選項無法使用
assignedTargetingOptionId移除或擷取,而是預期使用者會使用列舉值。這項更新推出後,您可以使用assignedTargetingOptionId或列舉值移除或擷取這些已指派的指定目標選項,列舉值會由AssignedTargetingOption資源中的新assignedTargetingOptionIdAlias欄位識別。 - 委刊項
bulkUpdate要求未正確使用advertisersId要求參數,因此傳回錯誤。本次更新修正了這個方法,並將要求參數從advertisersId重新命名為advertiserId。
2022 年 10 月 27 日
新增在父項InsertionOrder中複製現有委刊項的功能。
在 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 服務中新增 create 和 delete 方法,針對部分目標對象類型導入部分插入訂單目標對象寫入支援。
新功能
v2
新增了下列方法:
服務 方法 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
v1 版未新增任何功能。
2022 年 9 月 20 日
發布公開測試版 v2,包含下列變更:
- 您可以使用
advertisers.lineItems和advertisers.lineItems.targetingTypes.assignedTargetingOptions服務中的get和list方法,擷取 YouTube 與合作夥伴委刊項及其指定目標設定。 advertisers.lineItems服務中新增兩種大量指定目標方法,可透過單一要求編輯及擷取 多個委刊項的指定目標。- 新的
bulkUpdate方法,可讓使用者在單一要求中更新多個委刊項的entityStatus。 - 新的指定目標邏輯,需要使用列舉值指派及擷取部分指定目標類型的
AssignedTargetingOption資源,而非使用targetingTypes.targetingOptions服務擷取的指定目標選項 ID。
請按照遷移指南中的步驟,從第 1 版遷移至第 2 版。
在 v1 中新增對三種交易所的支援。
新功能
v2
以下列出 v1 和 v2 之間的變更:
v2 新增了下列方法:
服務 方法 advertisers.lineItems bulkEditAssignedTargetingOptions
下列方法已在第 2 版中移除:
服務 方法 advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
下列方法已在第 2 版中重新命名:
服務 舊方法名稱 新方法名稱 廣告主 bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions 合作夥伴 bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions 下列指定類型的
AssignedTargetingOption資源在第 2 版中,會使用列舉進行指定目標指派。這些指定目標類型的AssignedTargetingOption資源assignedTargetingOptionId欄位也已在第 2 版中更新,改用列舉值的字串版本:指定類型 列舉型別 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 環境 TARGETING_TYPE_EXCHANGE 廣告交易平台 TARGETING_TYPE_GENDER 性別 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 可視度 第 2 版新增了下列欄位:
v2 已移除下列欄位:
下列欄位在第 2 版中為必填欄位:
v2 新增了下列列舉值:
列舉 值 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_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
以下列舉值已在第 2 版中移除:
列舉 值 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 新增了下列列舉值:
列舉 值 廣告交易平台 EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
2022 年 5 月 26 日
新增建立 InventorySource 資源的功能,並透過新的 inventorySources 服務寫入方法和新的 guaranteedOrders 服務管理 GuaranteedOrder 資源。
在 CustomBiddingAlgorithm 資源中導入 modelReadiness 欄位。這個欄位會列出每個可存取演算法的廣告主,其模型完備性狀態。
為 advertisers.creatives.list 方法啟用新的 filter 查詢參數功能,讓使用者只擷取在指定時間戳記之前或之後建立的廣告素材。updateTime
新增 SdfVersion 列舉值,支援最新版 SDF (v5.5)。
新功能
新增了下列方法:
服務 方法 guaranteedOrders inventorySources 新增下列欄位:
資源 欄位 CustomBiddingAlgorithm InventorySource 新增下列列舉值:
列舉 值 SdfVersion 下列清單方法現在可依下列屬性篩選:
方法 欄位 advertisers.creatives.list
2022 年 3 月 31 日
新增支援功能,可擷取及設定內容長度、串流類型和類型的指定目標。
在 InsertionOrder 物件中新增 billableOutcome 欄位。
在 MaximizeSpendBidStrategy 物件中導入 raiseBidForDeals 欄位,讓使用者設定出價策略是否要針對指定交易套用廣告主底價。
新功能
新增下列欄位:
資源 欄位 AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption 新增下列列舉值:
列舉 值 TargetingType
2022 年 2 月 2 日
新增支援建立、更新及編輯特定目標顧客比對FirstAndThirdPartyAudience資源的成員。如要瞭解如何使用這些新功能,請參閱新版「使用目標對象」指南中的「上傳目標顧客比對目標對象」頁面。
在 InsertionOrder 和 LineItem 資源中導入新的 reservationType 欄位,用於識別資源是否為代碼保證、程式輔助保證或非保證。
新增功能:透過新的 excludeNewExchanges 欄位,擷取及設定委刊項是否自動指定新的廣告交易平台。
除了新功能外,預設配額限制也提高了一倍。
新功能
新增了下列方法:
服務 方法 firstAndThirdPartyAudiences 新增下列欄位:
資源 欄位 FirstAndThirdPartyAudience InsertionOrder LineItem
2021 年 12 月 8 日
在指定類型
TARGETING_TYPE_AUDIO_CONTENT_TYPE 下,新增對指定音訊內容類型的支援。
新功能
新增下列欄位:
資源 欄位 AssignedTargetingOption TargetingOption 新增下列列舉值:
列舉 值 TargetingType
2021 年 11 月 8 日
全面支援管理自訂出價演算法及其指令碼。 包括:
- 用來建立新項目和更新現有項目的函式
customBiddingAlgorithms。 - 透過擷取可用資源位置,然後將檔案上傳至該位置,即可上傳指令碼。
- 新的
customBiddingAlgorithms.scripts服務,用於擷取及建立customBiddingScripts。
我們在「管理委刊項」指南中新增了「導入自訂出價」頁面,說明如何建立自訂出價演算法、上傳指令碼,以及將自訂出價演算法指派為委刊項的出價策略。
新增 SdfVersion 列舉值,支援最新版 SDF (v5.4)。
新功能
新增了下列方法:
服務 方法 customBiddingAlgorithms customBiddingAlgorithms.scripts media 新增下列列舉值:
列舉 值 SdfVersion
2021 年 9 月 14 日
在指定類型 TARGETING_TYPE_BUSINESS_CHAIN 和 TARGETING_TYPE_POI 下新增鄰近地區指定目標支援。
新增搜尋可用TARGETING_TYPE_BUSINESS_CHAIN和TARGETING_TYPE_POI指定目標選項的功能,因為這些選項無法透過 targetingTypes.targetingOptions.get 或 targetingTypes.targetingOptions.list 方法擷取。targetingTypes.targetingOptions.search
在自訂出價演算法資源中導入新的 sharedAdvertiserIds 和 customBiddingAlgorithmState 欄位,並新增對 GOAL_BUILDER_BASED 自訂出價演算法類型的支援。
在 Exchange 列舉中新增了兩個值。
新功能
新增下列欄位:
資源 欄位 AssignedTargetingOption CustomBiddingAlgorithm TargetingOption TargetingOptions.search 要求主體 新增下列列舉值:
列舉 值 CustomBiddingAlgorithmType 廣告交易平台 TargetingType 下列清單方法現在可依下列屬性篩選:
方法 欄位 customBiddingAlgorithms.list
2021 年 8 月 4 日
在指定目標類型 TARGETING_TYPE_OMID 下,新增對啟用 Open Measurement 的廣告空間指定目標支援。
使用 pageSize 方法參數,增加各種廣告主、廣告活動、廣告訂單和委刊項指定目標選項清單方法單一頁面中,可傳回的指定目標選項數量上限。
新功能
新增下列欄位:
資源 欄位 AssignedTargetingOption TargetingOption 新增下列列舉值:
列舉 值 TargetingType 下列清單方法的頁面大小上限已提高:
2021 年 5 月 26 日
推出 advertisers.invoices 服務,讓使用者:
- 擷取在特定月份核發給廣告主的月結單。
- 查詢廣告主在特定月份使用的貨幣代碼。
在廣告活動資源中加入 campaignBudgets 欄位。廣告訂單預算區隔可以連結至廣告活動預算,將相關聯區隔的總預算限制在廣告活動總預算金額內。
新增對原生內容位置指定目標的支援,位於新的指定目標類型 TARGETING_TYPE_NATIVE_CONTENT_POSITION 下方。
在廣告主資源中導入新的 prismaEnabled 欄位,讓使用者啟用與 Mediaocean Prisma 工具的整合。
為廣告主的 entityStatus 欄位啟用 ENTITY_STATUS_PAUSED 列舉值支援。
新功能
新增了下列方法:
服務 方法 advertisers.invoices 新增下列欄位:
資源 欄位 廣告主 AssignedTargetingOption TargetingOption 新增下列列舉值:
列舉 值 AssignedTargetingOption.Recency 廣告交易平台 TargetingType 下列欄位現在可使用下列列舉值:
資源 欄位 值 廣告主 entityStatus ENTITY_STATUS_PAUSED
2021 年 4 月 29 日
在「管道」和「排除關鍵字清單」資源中新增欄位,傳回使用資源指定目標的行項目數量。為委刊項清單方法啟用新的 filter 屬性,讓使用者只擷取指定目標中使用特定管道或排除關鍵字清單的委刊項。
新功能
新增下列欄位:
資源 欄位 管道 下列清單方法現在可依下列屬性篩選:
方法 欄位 advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
2021 年 3 月 30 日
在委刊項服務中新增方法,可產生具有預設設定的委刊項。這些預設值是根據指定的委刊項類型,以及父項廣告訂單的設定和已指派的指定目標而定。
透過新的廣告活動指定服務和額外的批次清單方法,啟用廣告活動指定目標的擷取作業。
我們對 advertisers.channels.sites、partners.channels.sites 和 advertisers.negativeKeywordLists.negativeKeywords 服務進行多項變更,方便您管理管道和排除關鍵字清單內容。這些變更包括:
- 新增
replace方法,讓使用者完全覆寫現有管道或排除關鍵字清單的內容。 - 移除大量編輯要求中,
createdSites或createdNegativeKeywords欄位不得包含現有項目的規定。 - 增加單一頁面可傳回的項目數量上限,適用於列出網站或列出排除關鍵字的回應。
新功能
新增了下列方法:
新增下列欄位:
資源 欄位 AssignedTargetingOption.AppAssignedTargetingOptionDetails 下列清單方法的頁面大小上限已提高:
方法 舊版最大頁面大小 新的最大頁面大小 advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
淘汰項目
下列列舉值無法再指派給新資源或現有資源:
列舉 值 PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
2021 年 2 月 24 日
推出新的廣告訂單指定目標服務和額外的批次清單方法,可擷取指派給廣告訂單的指定目標。擴充廣告素材資源,新增僅限輸出的廣告素材欄位,供第三方音訊廣告素材使用。新增成效目標類型,供廣告訂單和廣告活動資源使用。
新功能
新增了下列方法:
服務 方法 advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 新增下列欄位:
資源 欄位 廣告素材 新增下列列舉值:
列舉 值 ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
2021 年 1 月 27 日
導入新的 InsertionOrderType 欄位和新的 LineItemType 列舉值,方便您擷取及管理電視廣告訂單和 over-the-top 委刊項。透過 mobileApp 委刊項欄位,新增對行動應用程式委刊項的支援。透過其他列舉值,擴大支援交易平台、Google 目標對象和 SDF。推出依上次更新時間篩選及排序 advertisers.list 值的功能。
新功能
新增下列欄位:
資源 欄位 InsertionOrder LineItem 新增下列列舉值:
列舉 值 廣告交易平台 GoogleAudienceType LineItemType SdfVersion 下列清單方法現在可以依下列欄位排序和篩選:
方法 欄位 廣告主
2020 年 12 月 4 日
新增搜尋「地理區域」指定目標選項的功能,並依上次更新時間篩選多個資源清單方法結果。推出新版 LineItemWarningMessage,在委刊項使用已淘汰的指定地理區域時通知使用者。
新功能
新增了下列方法:
服務 方法 targetingTypes.targetingOptions 新增下列列舉值:
列舉 值 廣告交易平台 LineItemWarningMessage 下列清單方法現在可以依下列欄位排序和篩選:
方法 欄位 advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
2020 年 11 月 5 日
新增建立、指派及啟用手動觸發條件的功能,可啟動相關聯委刊項的支出。推出擴展指定目標選項,設定後即可擴展委刊項的指定目標,納入與指定目標對象類似的使用者。在第三方驗證指定目標中使用的 DoubleVerify 和 Integral Ad Science 物件中,附加自訂區隔 ID 欄位。
新功能
我們新增了下列服務:
服務 方法 advertisers.manualTriggers 新增下列欄位:
資源 欄位 AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight 新增下列列舉值:
列舉 值 LineItemFlightDateType 下列清單方法現在可依下列欄位篩選:
方法 欄位 advertisers.lineItems.list
2020 年 10 月 12 日
在委刊項資源中導入可擷取的警告訊息,以及點閱率成效目標類型。在列出委刊項時,新增「已新增」warningMessages 做為可篩選的欄位。
除了新功能外,新配額限制也已生效,並提供使用批次要求的新文件。
新功能
新增下列欄位:
資源 欄位 LineItem 新增下列列舉值:
列舉 值 PerformanceGoalType 下列清單方法現在可依下列欄位篩選:
方法 欄位 advertisers.lineItems.list
2020 年 8 月 28 日
在廣告主稽核方法的回應中新增欄位,並在各種清單方法中新增可篩選的欄位。
新功能
新增下列欄位:
資源 欄位 Advertisers.Audit 回應主體 下列清單方法現在可依下列欄位篩選:
方法 欄位 advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
2020 年 8 月 4 日
推出全新的使用者管理、合作夥伴和合作夥伴指定目標服務。推出相關工具,協助使用者主動避免達到帳戶實體限制。新增音訊委刊項支援,並在委刊項和廣告訂單出價策略中,使用自訂出價演算法。
新功能
我們新增了下列服務:
服務 方法 customBiddingAlgorithms 合作夥伴 partners.targetingTypes.assignedTargetingOptions 使用者 新增了下列方法:
服務 方法 廣告主 新增下列欄位:
資源 欄位 MaximizeSpendBidStrategy PerformanceGoalBidStrategy 新增下列列舉值:
列舉 值 BiddingStrategyPerformanceGoalType LineItemType 下列清單方法現在可以依下列欄位排序和篩選:
方法 欄位 advertisers.lineItems.list 我們新增了下列範圍,供您用於下列服務:
範圍 服務 https://www.googleapis.com/auth/display-video-user-management
2020 年 6 月 24 日
推出小型更新,新增 partner 和 advertiser 管道的建立方法、新的 FirstAndThirdPartyAudience 欄位,以及其他 exchange 列舉值。
新功能
我們新增了下列服務:
服務 方法 advertisers.channels partners.channels 新增下列欄位:
資源 欄位 FirstAndThirdPartyAudience 新增下列列舉值:
列舉 值 廣告交易平台 下列清單方法現在可依下列欄位篩選:
方法 欄位 advertisers.creatives.list
2020 年 6 月 2 日
導入建立、修補及填入可指定目標實體子集的功能,並新增修改三種指定類型廣告主層級指定目標的功能:管道、數位內容標籤排除條件和敏感類別排除條件。
新功能
我們新增了下列服務:
新增了下列方法:
服務 方法 廣告主 advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels 新增下列欄位:
資源 欄位 廣告主 creative insertionOrder.insertionOrderBudgetSegment
2020 年 4 月 27 日
推出大量功能,將 API 範圍擴展至 SDF 以外。新增核心資源管理功能,可讓您建立、擷取、更新及刪除廣告主、廣告活動、廣告訂單、委刊項和廣告素材等實體。此外,您也可以在委刊項層級編輯指定目標。
新功能
我們新增了下列服務:
2020 年 3 月 9 日
推出 Display & Video 360 API 第 1 版。這是 API 的初始版本。
已知問題
無。