开放式 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 | 推荐 | 定价模式。数值:1 = cpm,2 = cpc。默认值 = 1(int)。 |
注意:当回复的是电子邮件点击区请求时,1 = 智能 CPC。
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