Skip to main content

开放式 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

如果投标响应中的 nURLbURL 是有效的 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}&currency=${AUCTION_CURRENCY}

如果同时使用 nURLbURL,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

以下是可用锚点的可视化展示:

crop anchor point

请注意,虽然我们也允许在原生广告中使用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