开放式 RTB 竞标响应规范
投标申请的答复应采用以下结构：
回应
| 属性 | 是否需要？ | 说明 |
|---|---|---|
| 本我 | 是 | 作为响应的投标请求的 ID(字符串) |
| 竞拍 | 是 | 收集投标人代表特定席位(阵列)进行的投标 |
注意： ID 必须与请求中提供的 ID 一致
竞拍
| 属性 | 是否需要？ | 说明 |
|---|---|---|
| 竞投 | 是 | 与目标印象相关的出价对象数组 |
seatbid.bid
| 属性 | 是否需要？ | 说明 |
|---|---|---|
| 本我 | 是 | 投标对象的 ID，用于跟踪(字符串) |
| 冰冻三尺非一日之寒 | 是 | 相关投标申请中印象对象的 ID。 |
| 价格 | 是 | 以 CPM 或 CPC(浮动)表示的出价 |
| 敬佩 | 是 | XML/JSON 广告标记(字符串) |
| 网页 | 是 | Win 通知 URL，建议使用 HTTP over HTTPS 来指定 nurl(字符串)。 |
| 毛刺 | 没有 | 计费通知 URL，建议使用HTTP通过 HTTPS 设置 nurl(字符串) |
| 蟋蟀 | 推荐 | 协助广告质量检查的创意 ID(字符串) |
| iurl | 推荐 | 创意的 URL |
| 绵延 | 没有 | ExoClick 特定扩展(对象) |
注：
- impid 必须与请求中提供的 impid 一致。
- 钦点必须根据目标广告格式以 JSON 或 XML 格式提供：JSON格式适用于原生广告、内流广告和推送通知；XML格式适用于所有其他格式。
- 必须通知 nURL，以确保活动封顶，避免每次都收到相同的回复。
- 根据 btype 字段中的 CPM 或 CPC(默认 CPM)，当印象或点击被传递时，bURL 将被调用。
seatbid.bid.ext
| 属性 | 是否需要？ | 说明 |
|---|---|---|
| btype | 推荐 | Pricing Model. Values: 1 = CPM, 2 = CPC. Default = 1 (int). When the response is for an Email Clicks zone request, 1 = Smart CPC. |
| Note: Only Push Notification, Native ads, Direct Link, and Email Clicks may bid with the CPC pricing model. |
seatbid.bid.ext.dsa
| 属性 | 是否需要？ | 说明 |
|---|---|---|
| 利益 | 是 | 广告商透明度：自由 UNICODE 文本字符串，包含广告显示对象的名称。最多 100 个字符。(字符串) |
| 付讫 | 是 | 广告商透明度：自由 UNICODE 文本字符串，表示广告费用由谁支付。即使与代表属性中列出的内容相同，也必须始终包含。最多 100 个字符(字符串) |
| 摒弃 | 是 | 表示买方/广告商将在创意中呈现自己的 DSA 透明度信息的标志。0 = 买方/广告商不会渲染，1 = 买方/广告商会渲染(int) |
seatbid.bid.dsa.transparency
| 属性 | 是否需要？ | 说明 |
|---|---|---|
| 领域 | 是 | 应用用户参数的实体的域(字符串) |
| 参数 | 是 | 买方应用的用户目标参数阵列(使用 DSA 透明化工作组提供的列表)。包括对多个供应商的支持，这些供应商可添加自己的用户定位参数。(int array) |
无投标回复
若要回复投标请求而不进行实际投标，则应发送 HTTP 响应代码 204 "无内容"。
获奖和账单通知 URL
如果投标响应中的 nURL 或 bURL 是有效的 URL，ExoClick 平台将向其发送 GET 请求。在进行 GET 之前，ExoClick 会替换这些 URL 中的一些标记：
${AUCTION_ID} - ID of the bid request; from "Bid Request Object -> id" attribute.
${AUCTION_BID_ID} - ID of the bid; from "Bid Response Object -> bidid" attribute.
${AUCTION_IMP_ID} - ID of the impression just won; from "Bid Request Object -> Impression Object -> id" attribute.
${AUCTION_SEAT_ID} - ID of the bidder seat for whom the bid was made; from "Bid Response Object -> Seat Bid Object -> Bid Object -> id" attribute.
${AUCTION_AD_ID} - ID of the ad markup the bidder wishes to serve; from "Bid Response Object -> Seat Bid Object -> Bid Object -> adid" attribute.
${AUCTION_PRICE} - Settlement price using the same currency and units as the account; from "Bid Response Object -> Seat Bid Object -> Bid Object -> price" attribute.
${AUCTION_CURRENCY} - The currency used in the bid (explicit or implied); for confirmation only.
例如
https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}¤cy=${AUCTION_CURRENCY}
如果同时使用 nURL 和 bURL，ExoClick 将同时调用这两个 URL。
ADM 结构
Depending on the ad format, the adm parameter can contain a piece of XML or JSON. You can find detailed examples of adm structures in our examples page
在创建 ADM 时，请注意以下几点：
- 必须在您的 ExoClick 账户中启用iFrame 标记**(横幅、全页面插页)，才能使用这些标记。
- 流内广告、本地广告和推送通知广告**应在 adm 中包含一个 JSON 编码字符串。
- 来自 In-Stream 的 adm 参数可遵循两种结构之一： 远程 VAST 或本地 VAST。在远程 VAST 中，您只需声明 VAST 封装器所在的 URL，而在本地 VAST 中，除 "videoURL "和 "clickURL "外，您还需声明任何要跟踪的"trackingEvents "**。
目前，我们支持印象、进度和完成事件。印象和进度事件是必须的，而完成事件只有在使用本地 VAST 时才能添加。
The ADM must follow the same structure as shown in our example above.
作为一个可选参数，您可以在原生广告 adm 的 JSON 字符串中包含crop_anchor_point，以确定原生图片的锚点位置。可用值有
- middle_center = 0、
- TOP_LEFT = 1、
- top_center = 2、
- TOP_RIGHT = 3、
- middle_left = 4、
- middle_right = 5、
- bottom_left = 6、
- bottom_center = 7、
- bottom_right= 8
以下是可用锚点的可视化展示：
- Also, regarding Native Ads, make sure that you are adding your eventtrackers according to the latest native specification
请注意，虽然我们也允许在原生广告中使用imptrackers，但我们强烈建议使用eventtrackers。
- 推送通知广告只允许每个通知使用一个图片资产。宽度和高度取决于来自请求的图片，可以是 192x192 或 720x480。请注意，adm 也必须是 JSON 编码字符串，因为请求将来自本地对象。
- 最后，推送通知广告只允许一个"imptracker "URL
实例
You can find detailed examples from Bid responses and ADM structures in our Advertiser Response example page