Marketplace API

概览

Authorized Buyers Marketplace API 是一系列资源，买方可以使用这些资源以编程方式管理以下各项：

  • 与发布商的协商
  • 竞价包
  • Authorized Buyers 市场界面的客户访问权限

本指南介绍了 Marketplace API，并说明了 Marketplace API 资源与 Authorized Buyers 界面中的 Marketplace 功能之间的对应关系。

出价方和买方

Marketplace API 与 Real-time Bidding API 的结构一致。这两种 API 都使用 bidders 和 buyers 作为出价方和买方操作的根级资源。对于实时出价 API 和市场 API，您可以在资源路径中使用相同的出价方和买方名称。

客户和客户用户

您可以使用 Marketplace API 创建和管理客户和客户用户，并以程序化方式向代理机构或广告客户授予对 Authorized Buyers 界面中的市场标签页的访问权限。

Client 表示与您的 Authorized Buyers 帐号相关联的客户、代理机构或广告客户。

ClientUser 表示在 Client 下具有界面访问权限的特定个人。客户端用户无法访问 Marketplace API。客户用户对您帐号的市场标签页的访问权限受限。客户端用户权限由其父级 Client 中指定的 role 决定。

Marketplace API 中的其他资源通过 Clients 资源中指定的名称引用客户端。

如需详细了解 Authorized Buyers 市场界面中的客户和客户用户，请参阅以下帮助中心文章：

媒体规划人员

媒体规划人员是指独立与发布商协商交易的代理机构或其他实体，可以让一个或多个出价方代表最终确定的交易出价。这些交易是私下竞价或首选交易，在最终敲定之前，您无法查看它们或与它们互动，然后它们将显示在 bidders.finalizedDeals.list 响应中。

要确定某个已敲定的交易是否由媒体规划人员协商好，您可以查看该交易的 mediaPlanner 字段是否已填充。媒体策划人员会设置一个列表，其中包含有资格进行交易的 DSP 专用席位 ID，您可以通过 eligibleSeatIds 字段查看这些 ID。在实时出价请求中，这些席位 ID 可能会出现在发布商设置的许可名单或屏蔽名单中，这些席位决定着出价是否会被滤除而无法参与竞价。它们可以出现在以下 BidRequest 字段中：

  • OpenRTB 协议
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Google 实时出价协议
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

竞价包

您可以使用 Marketplace API 为买方和客户订阅和退订竞价包，以及查看您订阅的竞价包。

AuctionPackage 类似于一组针对“市场”广告资源的定位条件。例如，竞价包可以定位与买方的商业兴趣相关的一系列网址和移动应用 ID。

您无法使用 Marketplace API 创建新的竞价包。您可以使用 Authorized Buyers 市场界面创建竞价包。Marketplace API 不包含与竞价包关联的特定定位信息。

您可以与其他买方和客户共享竞价包，也可以与您分享由 Google 或其他买方创建的竞价包。

如需了解详情，请参阅竞价包。

发布商资料

您可使用 Marketplace API 查看可协商的发布商的资料。

PublisherProfile 在 Marketplace API 中代表发布商。Marketplace API 中的其他资源引用了其 PublisherProfile 中指定的名称的发布商。

发布商资料中的信息与 Authorized Buyers 市场界面的发现标签页中的发布商信息类似。

如需了解详情，请参阅如何发现发布商。

提案和交易

您可以使用 Marketplace API 与发布商协商交易。您可以通过以下方式使用 Marketplace API 管理交易：

提案代表买方或客户与发布商之间的一项或多项交易的最新协商状态，与 Authorized Buyers 市场界面的协商标签页类似。

交易是指根据给定提案正在协商的交易的最新条款，类似于 Authorized Buyers 市场界面中针对指定提案标记为当前协商的交易列表。

已敲定的交易表示已完成协商阶段并准备好投放的交易。这包括已在投放的交易。敲定的交易类似于 Authorized Buyers 市场界面的交易标签页。

根据您要协商的交易的类型，Marketplace API 资源的行为可能会有所不同。例如，买方无法针对所有交易类型发起协商。如需详细了解用于协商的 Marketplace API 实现，请参阅以下资源：

如需详细了解 Authorized Buyers 市场界面中的协商，请参阅以下内容：