版本说明

Marketplace API

版本 1.0

日期 备注
2024 年 2 月 29 日
  • Deal 引入了 mediaPlanner 字段。
  • Deal 中引入了 eligibleSeatIds 字段。
  • 如果交易属于媒体策划人员帐号,系统将不会填充该交易的 billingBuyer。
2023 年 11 月 29 日 CreativeFormat 添加了 AUDIO 枚举值。向 AppStoreType 添加了 LG_TV 枚举值。
2021 年 10 月 11 日 首次发布了 Authorized Buyers Marketplace API;有了它,您可以:
  • 提议交易并与发布商协商
  • 检索已敲定的交易和交易健康状况指标
  • 管理竞价包订阅
  • 管理客户和客户用户
  • 查找发布商资料

Real-time Bidding API

版本 1.0

日期 备注
2023 年 10 月 31 日 buyers.userLists.getRemarketingTagUrlRestriction 已停用,如果调用,将返回错误响应。我们建议您使用 Cookie 匹配代码的 google_ula 功能,通过放置浏览器中的代码将用户添加到用户列表中。 如需了解详情,请参阅 Cookie 匹配文档
2023 年 10 月 12 日 CreativeAttribute 添加了 RENDERING_PLAYABLE 枚举值。
2023 年 8 月 17 日 buyers.userLists.getRemarketingTagUrlRestriction 已弃用,并将于 2023 年 10 月 31 日停用。使用 Cookie 匹配代码的 google_ula 功能,通过浏览器中的代码将用户添加到用户列表中。如需了解详情,请参阅 Cookie 匹配文档
2023 年 3 月 17 日 PolicyTopicEntry 添加了 missingCertificate 字段。
2023 年 2 月 7 日

bidders.endpoints.bidProtocol 中移除了以下已废弃的枚举值:

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
2022 年 11 月 8 日

bidders.endpoints.bidProtocol 添加了新的 OPENRTB_PROTOBUF 枚举值。今后,一次只能支持一个 OpenRTB 版本。您应该使用 OPENRTB_JSONOpenRTB_PROTOBUF,以便以您偏好的格式使用最新支持的 OpenRTB 版本。如需了解详情,请参阅有关取消对旧版 OpenRTB 版本的支持的博文。

bidders.endpoints.bidProtocol 中的以下枚举字段已标记为已废弃:

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
2022 年 9 月 20 日 针对 FLEDGE 源试用引入了实验性 creatives.renderUrl 字段。
2022 年 9 月 1 日 为某些广告素材引入了 CERTIFICATE_REQUIRED 状态。如需了解详情,请参阅赌博和游戏政策
2022 年 4 月 27 日 释放 publisherConnections 资源。公开出价广告交易平台可以使用 publisherConnections 管理与发布商的关联。
2021 年 11 月 1 日 引入了 bidders.enpoints.patch,用于更新出价方的端点。
2021 年 5 月 27 日 为原生广告素材资源引入了 oneof 字段 video,该字段接受 videoVastXmlvideoUrl
2020 年 10 月 8 日 将字段 openAuctionServingStatusopenBiddingServingStatusdealsServingStatuschinaServingStatusrussiaServingStatus 分别替换为 networkPolicyComplianceplatformPolicyCompliancedealsPolicyCompliancechinaPolicyCompliancerussiaPolicyCompliance
2020 年 6 月 24 日 首次发布了 Real-time Bidding API,旨在最终取代 Ad Exchange Buyer API 和 Ad Exchange Buyer II API。

旧式

版本 2.0(已弃用)

日期 备注
2023/9/29

除用于实时出价问题排查的资源之外的所有资源都已停用,如果被调用,将返回错误响应。 我们建议您迁移到 Marketplace API,以便继续以程序化方式访问 Marketplace。停用的资源包括以下资源及其所有子资源:

  • accounts.clients
  • accounts.creatives
  • accounts.finalizedProposals
  • accounts.products
  • accounts.proposals
  • accounts.publisherProfiles
  • accounts.clients
2021/05/24

添加了交易级 pauseresume 方法。

2020/8/20

BidMetricsRow 添加了 detail 字段。

2020/5/6

BidMetricsRow 添加了 reachedQueries 字段。 向 NonBillableWinningBidStatusRowStatus 枚举添加了 FATAL_VAST_ERRORLOST_IN_MEDIATION

2016 年 3 月 9 日

发布了公开 Beta 版 Client Access。您现在可以允许客户买方直接访问 Authorized Buyers 市场,以便查看、协商和批准交易。 此外,您的应用能够以程序化方式执行一些以前只能在 Authorized Buyers 买方帐号设置标签页的客户部分中手动执行的操作。