RevoSurge 文檔

繁體中文

English
简体中文

繁體中文

English
简体中文

Appearance

競價接口參考 ​

接口地址 ​

URLhttp://rtb.revosurge.com/api/v1/openrtb2/{sspId}/bid
方法POST
Content-Typeapplication/json
協議OpenRTB 2.5

競價請求 ​

頂層欄位 ​

欄位類型是否必需說明
idstring是本次競價請求的唯一 ID
imparray是曝光對象列表（見下文）
siteobject建議廣告展示所在網站
deviceobject建議裝置與用戶環境
userobject否用戶身份
atinteger否競價類型。我們支援 1（一價競價）
tmaxinteger否最大響應超時（毫秒，例如 250）
curarray否允許的貨幣（例如 ["USD"]）
allimpsinteger否可用曝光指示

曝光對象（imp[]） ​

欄位類型是否必需說明
idstring是唯一曝光 ID
bannerobject二選一橫幅廣告位（見下文）
nativeobject二選一原生廣告位
bidfloorfloat否最低出價（CPM，USD）。預設為 0
bidfloorcurstring否底價貨幣。預設為 USD
instlinteger否彈窗（全屏/插屏）時設為 1
tagidstring否SSP 側該曝光的廣告位/標籤 ID
ext.typestring否SSP 提供的格式提示。使用 "pop" 表示彈窗

橫幅對象（imp[].banner） ​

欄位類型說明
winteger寬度（像素）
hinteger高度（像素）

網站對象（site） ​

欄位類型說明
idstring網站在您平台上的 ID
namestring網站名稱（可讀）
domainstring網站域名
pagestring頁面完整 URL
catarrayIAB 內容分類
publisher.idstring發布商 ID
keywordsstring逗號分隔的關鍵詞

裝置對象（device） ​

欄位類型說明
uastringUser-Agent 字符串
ipstring用戶的 IPv4 地址
ipv6string用戶的 IPv6 地址（無 IPv4 時發送）
geo.countrystringISO 3166-1 alpha-3 國家代碼（例如 IND、IDN、USA）
osstring操作系統（例如 Android、iOS）
devicetypeintegerOpenRTB 裝置類型代碼（例如 1 = 移動裝置）
languagestring瀏覽器/裝置語言代碼
carrierstring移動運營商名稱
jsinteger支援 JavaScript 為 1，否則為 0

用戶對象（user） ​

欄位類型說明
idstring買方側用戶 ID

競價響應 ​

成功出價時，我們返回 HTTP 200 及 JSON 響應體。若沒有匹配的廣告系列，我們返回 HTTP 204 No Content（無響應體）。

頂層欄位 ​

欄位類型說明
idstring回顯競價請求的 id
seatbidarray包含一個 seat bid 對象的數組
curstring貨幣 — 始終為 USD

出價對象（seatbid[].bid[]） ​

欄位類型說明
idstring唯一出價 ID
impidstring請求中的曝光 ID
pricefloat出價（CPM，USD）
adidstring廣告系列 ID
cridstring創意 ID
admstring廣告代碼 — 橫幅/原生為 HTML；彈窗為跳轉 URL
ext.popurlstring彈窗落地頁 URL（僅彈窗，與 adm 相同）
winteger創意寬度（彈窗為 0）
hinteger創意高度（彈窗為 0）
nurlstring獲勝通知 URL（我們勝出時觸發）
burlstring計費通知 URL（曝光時觸發）
lurlstring失敗通知 URL，包含 ${AUCTION_LOSS} 宏（我們失敗時觸發）

示例 ​

請求 ​

json
{
  "id": "xqoErTidWX",
  "imp": [
    {
      "id": "AhpTG",
      "banner": { "w": 300, "h": 250 },
      "bidfloor": 0
    }
  ],
  "site": {
    "id": "674721464",
    "domain": "example.com",
    "page": "https://example.com",
    "cat": ["IAB25-3"],
    "publisher": { "id": "17918" }
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Mobile Safari/537.36",
    "geo": { "country": "IND" },
    "ip": "223.184.195.38",
    "os": "Android",
    "language": "en"
  },
  "user": { "id": "platform:2fda85882b825efbb54e84d014ff8fb9" },
  "at": 1
}

響應（有出價） ​

json
{
  "id": "xqoErTidWX",
  "seatbid": [
    {
      "bid": [
        {
          "id": "xqoErTidWX",
          "impid": "AhpTG",
          "price": 0.5,
          "adid": "AWC-20251003-094732-029-6102",
          "crid": "AWC-20251003-094732-029-6102",
          "adm": "<a href='https://...' target='_blank'><img src='https://...' width='300' height='250'></a>",
          "w": 300,
          "h": 250,
          "nurl": "http://rtb.revosurge.com/rtb/win?id=xqoErTidWX&impId=AhpTG",
          "burl": "http://rtb.revosurge.com/rtb/bill?id=xqoErTidWX&impId=AhpTG",
          "lurl": "http://rtb.revosurge.com/rtb/loss?id=xqoErTidWX&impId=AhpTG&nbr=${AUCTION_LOSS}"
        }
      ],
      "seat": "revo"
    }
  ],
  "cur": "USD"
}

響應（不出價） ​

HTTP 204 No Content

彈窗（Popunder）格式 ​

如需請求彈窗庫存，請設置 imp[].instl: 1 和 imp[].ext.type: "pop"。響應中的 adm 將是跳轉 URL（而非 HTML），出價對象還會包含值相同的 ext.popurl。

請求（彈窗） ​

json
{
  "id": "pxBrQtYuWZ",
  "imp": [
    {
      "id": "ImpPop1",
      "instl": 1,
      "bidfloor": 0.1,
      "ext": { "type": "pop" }
    }
  ],
  "site": {
    "id": "70915",
    "domain": "example.com",
    "page": "https://example.com/",
    "ext": { "categories": "Entertainment" }
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36",
    "geo": { "country": "VNM" },
    "ip": "113.175.11.125",
    "os": "Android"
  },
  "at": 1,
  "tmax": 250
}

響應（彈窗出價） ​

json
{
  "id": "pxBrQtYuWZ",
  "seatbid": [
    {
      "bid": [
        {
          "id": "b91c3e2a-7f4d-4b1a-93ec-8f21ad047c12",
          "impid": "ImpPop1",
          "price": 0.64,
          "adid": "AWA-20260403-060030-100-5550",
          "crid": "AWR-20260326-024959-045-0754",
          "adm": "https://ingestor.revosurge.com/pop?...",
          "ext": { "popurl": "https://ingestor.revosurge.com/pop?..." },
          "w": 0,
          "h": 0,
          "nurl": "http://rtb.revosurge.com/rtb/win?id=pxBrQtYuWZ&impId=ImpPop1",
          "burl": "http://rtb.revosurge.com/rtb/bill?id=pxBrQtYuWZ&impId=ImpPop1",
          "lurl": "http://rtb.revosurge.com/rtb/loss?id=pxBrQtYuWZ&impId=ImpPop1&nbr=${AUCTION_LOSS}"
        }
      ],
      "seat": "revo"
    }
  ],
  "cur": "USD"
}