版本資訊

本頁提供 Display & Video 360 API 的版本資訊。

最新 API 版本:v3

2024 年 4 月 23 日

新功能

新增對新的 KPI 類型、廣告交易平台和應用程式平台的支援。

v3

v2

2024 年 2 月 28 日

新功能

新增從目標客戶比對目標對像中明確移除成員的功能。

新增指定新廣告交易平台的支援功能。

v3

v2

2024 年 1 月 29 日

新功能

新增透過新的 floodlightGroups.floodlightActivities 服務擷取 Floodlight 活動的功能。

新增欄位,顯示 YouTube 與合作夥伴委刊項的指定目標是否包含 Google TV 廣告空間。

新增欄位,以便轉發 Display & Video 360 使用者的上次登入時間。

v3

v2

2023 年 11 月 14 日

新功能

開始支援在所有上線版本中上傳目標客戶比對目標對象成員時,傳送使用者同意聲明。

v3

v2

2023 年 10 月 31 日

新功能

第 3 版已進入公開測試版,並全面開放使用。

在 v3 中重新命名 AdGroupFormat 列舉值,以更準確反映相關格式。

在第 2 版和第 3 版中加入 SDF_VERSION_7 列舉值,開始支援結構化資料檔案 v7。

v3

  • 下列列舉值已移除:

    列舉
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • 已新增以下列舉值:

    列舉
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • 已新增以下列舉值:

    列舉
    SdfVersion

    SDF_VERSION_7

2023 年 10 月 2 日

新功能

推出公開測試版的第 3 版,其中包括下列變更:

請按照遷移指南中的步驟,從第 2 版遷移至第 3 版。

新增支援 3 個新的 LineItemType 值、一個新的 YoutubeAndPartnersBiddingStrategyType 值,以及 2 版和 3 版中的一個新 PartnerCostType

v3

v2

2023 年 8 月 25 日

新功能

新增兩種廣告交易平台支援,以及兩種新的 YouTube 與合作夥伴出價策略類型

在 YouTube 與合作夥伴委刊項中新增 effectiveContentCategory 欄位,以便在考慮在廣告客戶和委刊項層級指派的值時,顯示委刊項使用的 YoutubeAndPartnersContentCategory

v2

2023 年 6 月 5 日

新功能

為第 1 版和第 2 版中的結構化資料檔案 (SDF) v6 新增 SdfVersion 值。

v2

  • 已新增以下列舉值:

    列舉
    SdfVersion

    SDF_VERSION_6

v1

  • 已新增以下列舉值:

    列舉
    SdfVersion

    SDF_VERSION_6

2023 年 3 月 9 日

新功能

新增 LineItemWarningMessage 值;如果這個欄位的已淘汰 excludeFirstPartyAudience 欄位設為 true,則會指派給委刊項的 warningMessages 欄位。excludeFirstPartyAudience 欄位將於 2023 年 3 月 25 日後停用,並設為 false

v2

v1

2023 年 2 月 8 日

新功能

新增擷取 YouTubeAdGroupYouTubeAdGroupAd 資源的功能,以及 YouTube 廣告群組資源指定功能。此外,我們還加入了可在 YouTube 廣告群組層級使用的可擷取指定類型。詳情請參閱新的 YouTube 與合作夥伴擷取資源指南

第 1 版和第 2 版新增了四種廣告交易平台支援。

v2

v1

  • 已新增以下列舉值:

    列舉
    廣告交易平台

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

2022 年 12 月 6 日

新功能

第 2 版已從公開測試版移至一般發布版本。

AssignedTargetingOption 資源中新增 assignedTargetingOptionIdAlias 欄位,可用於在擷取及刪除指定目標時取代 assignedTargetingOptionId。這個欄位只適用於透過列舉指定的指定類型指定目標選項。別名值是字串的相關列舉值。

Advertiser 資源中新增 billingConfig 欄位。

新增透過三個新的 LineItemType 值識別 YouTube 與合作夥伴 over-the-top 委刊項的支援功能。

在 v1 和 v2 中,將多種 list 方法的網頁大小上限提高到 200 個。預設頁面大小維持不變。

v2

v1

已知問題

本次更新修正了第 2 版的下列已知問題:

2022 年 10 月 27 日

新增在父項 InsertionOrder 中複製現有委刊項的功能。

advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 服務新增 createdelete 方法,我們已針對部分指定類型推出部分廣告訂單指定目標寫入支援。

新功能

v2

v1

第 1 版並未新增任何功能。

2022 年 9 月 20 日

推出公開測試版的第 2 版,其中包含下列變更:

請按照遷移指南中的步驟,從 v1 遷移至 v2。

v1 中新增對三個新廣告交易平台的支援。

新功能

v2

以下是 v1 和 v2 之間的變更清單:

v1

  • v1 新增了下列列舉值:

    列舉
    廣告交易平台

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

2022 年 5 月 26 日

新增透過新的 inventorySources 服務寫入方法和新的 guaranteedOrders 服務,建立 InventorySource 資源及管理 GuaranteedOrder 資源。

CustomBiddingAlgorithm 資源中引入 modelReadiness 欄位。這個欄位會列出每個可存取演算法的 廣告主,是否已經準備好使用演算法。

advertisers.creatives.list 方法啟用新的 filter 查詢參數功能,讓使用者只能擷取指定時間戳記前後 updateTime 的廣告素材。

新增對最新的 SDF 版本 v5.5 版的支援功能,新增 SdfVersion 列舉值。

新功能

2022 年 3 月 31 日

新增擷取及設定內容時間長度串流類型類型指定目標的支援功能。

已將 billableOutcome 欄位新增至 InsertionOrder 物件。

已在 MaximizeSpendBidStrategy 物件中加入 raiseBidForDeals 欄位,讓使用者設定出價策略是否對指定交易套用廣告主底價。

新功能

2022 年 2 月 2 日

開始支援建立更新編輯特定目標客戶比對 FirstAndThirdPartyAudience 資源的成員。新版「使用目標對象」指南中的「上傳目標客戶比對目標對象」頁面,將會詳細說明這些新功能的使用方式。

InsertionOrderLineItem 資源中加入新的 reservationType 欄位,可識別資源是屬於代碼保證、程式輔助保證,還是無保證。

新增擷取及設定委刊項是否透過新的 excludeNewExchanges 欄位自動指定新的廣告交易平台的功能。

除了新功能以外,預設配額限制也已增加一倍。

新功能

2021 年 12 月 8 日

新增對指定類型 TARGETING_TYPE_AUDIO_CONTENT_TYPE 下的音訊內容類型指定支援。

新功能

2021 年 11 月 8 日

新增自訂出價演算法及其指令碼的完整支援。包括:

管理委刊項」指南中新增了「導入自訂出價」頁面,當中說明如何建立自訂出價演算法、上傳指令碼,以及指派自訂出價演算法做為委刊項的出價策略。

新增對最新的 SDF 版本 v5.4 版的支援功能,新增 SdfVersion 列舉值。

新功能

2021 年 9 月 14 日

新增對指定類型 (TARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_POI) 下鄰近目標的支援。

新增使用 targetingTypes.targetingOptions.search 搜尋可用的 TARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_POI 指定目標選項,因為無法透過 targetingTypes.targetingOptions.gettargetingTypes.targetingOptions.list 方法擷取。

自訂出價演算法資源推出新的 sharedAdvertiserIdscustomBiddingAlgorithmState 欄位,並新增對 GOAL_BUILDER_BASED 自訂出價演算法類型的支援。

已將兩個新值新增至 Exchange 列舉。

新功能

2021 年 8 月 4 日

在指定類型 TARGETING_TYPE_OMID 下方,新增對已啟用 Open Measurement 的廣告空間指定功能的支援。

針對使用 pageSize 方法參數,在各種廣告主廣告活動廣告訂單委刊項指派的指定目標選項清單方法中,單一頁面傳回的指派指定目標選項數量上限提高。

新功能

2021 年 5 月 26 日

推出 advertisers.invoices 服務,讓使用者可以:

  • 擷取每月核發給廣告客戶的月結單。
  • 查詢廣告客戶在指定月份使用的貨幣代碼。

在廣告活動資源中加入 campaignBudgets 欄位。廣告訂單預算區隔可與廣告活動預算連結,將相關區隔的預算總和設為廣告活動預算總金額。

在新的指定類型 TARGETING_TYPE_NATIVE_CONTENT_POSITION 中新增原生內容位置指定功能

在廣告客戶資源中加入新的 prismaEnabled 欄位,讓使用者能與 Mediaocean 的 Prisma 工具整合。

開始支援對廣告主 entityStatus 欄位的 ENTITY_STATUS_PAUSED 列舉值支援。

新功能

2021 年 4 月 29 日

頻道排除關鍵字清單資源中新增欄位,用於傳回使用資源做為指定目標的項目數量。為委刊項清單方法啟用新的 filter 屬性,讓使用者只能擷取指定目標中使用特定管道或排除關鍵字清單的委刊項。

新功能

2021 年 3 月 30 日

委刊項服務新增方法,使用預設設定產生委刊項。這些預設值取決於指定的委刊項類型,以及上層廣告訂單的設定和指定指定目標。

透過新的廣告活動指定目標服務其他大量名單方法,擷取廣告活動指定目標。

擴大指定應用程式,方便您在更多平台指定應用程式。

advertisers.channels.sitespartners.channels.sitesadvertisers.negativeKeywordLists.negativeKeywords 服務進行多項變更,可簡化頻道管理和排除關鍵字清單內容。這類異動包括:

新功能

淘汰項目

2021 年 2 月 24 日

推出新的廣告訂單指定目標服務其他大量清單方法,以便擷取指派給廣告訂單的指定目標。擴充廣告素材資源,新增僅限輸出的廣告素材欄位,以供第三方音訊廣告素材使用。新增新的成效目標類型,供廣告訂單廣告活動資源使用。

新功能

2021 年 1 月 27 日

導入新的插入訂單類型欄位新的 LineItemType 列舉值,可擷取及管理電視廣告訂單和 over-the-top 委刊項。透過 mobileApp 委刊項欄位新增對行動應用程式委刊項的支援。透過其他列舉值,擴大 ExchangeGoogle 目標對象SDF 的支援。推出可依上次更新時間篩選及排序 advertisers.list 值的功能。

新功能

2020 年 12 月 4 日

新增地理區域指定目標選項的搜尋功能,並依據上次更新時間篩選多個資源清單方法結果。推出全新 LineItemWarningMessage,說明委刊項何時使用已淘汰的指定地理區域。

新功能

2020 年 11 月 5 日

新增建立、指派及啟用手動觸發條件的功能,可啟動相關委刊項的預算。推出擴展指定目標選項,設定完成後,即可擴大委刊項的指定目標,納入與指定目標對象相似的使用者。將自訂區隔 ID 欄位附加到第三方驗證指定功能中使用的 DoubleVerifyIntegral Ad Science 物件。

新功能

2020 年 10 月 12 日

向委刊項資源和點閱率 (CTR) 成效目標類型推出可擷取的警告訊息。新增 warningMessages 做為列出委刊項時可篩選的欄位。

除了新功能以外,新配額限制現已生效,我們也提供有關運用批次要求的新說明文件。

新功能

2020 年 8 月 28 日

廣告客戶稽核方法的回應新增欄位,並在各種清單方法中新增可篩選欄位。

新功能

2020 年 8 月 4 日

推出新的使用者管理合作夥伴合作夥伴指定服務。推出全新工具,協助使用者主動避免達到帳戶實體限制。新增對音訊委刊項的支援,以及在委刊項廣告訂單出價策略中使用自訂出價演算法

新功能

2020 年 6 月 24 日

推出小幅更新,新增合作夥伴廣告客戶管道的建立方法、新增 FirstAndThirdPartyAudience 欄位,以及其他廣告交易平台列舉值。

新功能

2020 年 6 月 2 日

針對部分可指定的實體,新增建立、修補和填入資料的功能,並且針對三種指定類型新增修改廣告主層級指定目標的功能:管道數位內容標籤排除敏感類別排除

新功能

2020 年 4 月 27 日

推出大型功能集,將 API 的範圍擴大到結構化資料檔案之外。新增核心資源管理功能,可讓您建立、擷取、更新及刪除實體 (例如廣告主、廣告活動、廣告訂單、委刊項和廣告素材)。新功能也可讓你在委刊項層級編輯指定目標。

新功能

已新增下列服務:

服務方法
廣告客戶

建立

刪除

get

list

修補程式

advertisers.assets

上傳

advertisers.campaigns

建立

刪除

get

list

修補程式

advertisers.channels

get

list

advertisers.creatives

建立

刪除

get

list

修補程式

advertisers.insertionOrders

建立

刪除

get

list

修補程式

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

建立

刪除

get

list

修補程式

advertisers.lineItems.targetingTypes.assignedTargetingOptions

建立

刪除

get

list

advertisers.locationLists

get

list

advertisers.negativeKeywordLists

get

list

combinedAudiences

get

list

customLists

get

list

firstAndThirdPartyAudiences

get

list

floodlightGroups

get

修補程式

googleAudiences

get

list

inventorySourceGroups

get

list

inventorySources

get

list

partners.channels

get

list

partners.channels

get

list

2020 年 3 月 9 日

推出 Display & Video 360 API 第 1 版。這是 API 的初始版本。

已知問題

無。