OpenRTB BidRequest — 광고 요청 구조와 주요 객체

OpenRTB BidRequest는 SSP(Supply-Side Platform)가 DSP(Demand-Side Platform)에게 “지금 이 광고 지면이 경매에 나왔습니다"라고 알리는 요청 메시지다. 하나의 BidRequest 안에는 어떤 지면인지(Imp), 어떤 사이트/앱에서 왔는지(Site/App), 어떤 디바이스의 어떤 사용자인지(Device/User), 그리고 적용해야 할 규제(Regs)와 광고 공급망 정보(Source/SupplyChain)가 모두 담긴다.

이 글은 OpenRTB 2.6 스펙을 기준으로 BidRequest의 주요 객체를 구조와 함께 정리한다.

BidRequest 전체 구조

BidRequest는 크게 세 가지 레이어로 구성된다. 최상위에는 요청 메타데이터와 컨텍스트 객체가 있고, 그 아래에 입찰 대상인 Impression 배열이 있으며, Impression 안에 실제 광고 형식(Banner/Video/Audio/Native)과 거래 조건(PMP/Deal)이 위치한다.

flowchart TB
    subgraph Request["BidRequest"]
        ID["id (필수)"]
        AT["at · tmax · cur · bcat · badv"]
        IMP["imp[] (필수, 최소 1개)"]
        SITE["site"]
        APP["app"]
        DEVICE["device"]
        USER["user"]
        SOURCE["source"]
        REGS["regs"]
    end

    subgraph Imp["Impression"]
        IMP_ID["id (필수)"]
        BIDFLOOR["bidfloor · bidfloorcur · secure · instl · rwdd"]
        BANNER["banner"]
        VIDEO["video"]
        AUDIO["audio"]
        NATIVE["native"]
        PMP["pmp (Private Marketplace)"]
    end

    Request --> IMP
    IMP --> Imp

최상위 필드

BidRequest 루트에는 요청 식별자, 경매 방식, 허용 통화, 차단 목록 같은 메타데이터가 위치한다.

△ = site, app, dooh 중 최소 하나 필수

Imp 객체

Imp(Impression)는 경매에 나온 광고 슬롯 하나를 표현한다. 하나의 BidRequest에 여러 Imp가 포함될 수 있으며, 각 Imp에는 해당 슬롯이 어떤 광고 형식을 수용하는지, 최소 입찰가는 얼마인지, 전면 광고인지 여부 등이 명시된다.

△ = banner, video, audio, native 중 최소 하나 필수

PMP (Private Marketplace) / Deal

PMP는 SSP가 특정 DSP에게만 입찰 자격을 부여하는 우선 거래 경매다. 퍼블리셔가 사전에 딜(Deal)을 생성하면, 초청받은 DSP만 해당 지면에 입찰할 수 있다. 일반 오픈 경매보다 높은 floor 가격이 적용되며, 프리미엄 인벤토리 보장을 전제로 한 계약 기반 거래다.

{
  "imp": [{
    "id": "1",
    "banner": {"w": 300, "h": 250},
    "bidfloor": 1.0,
    "pmp": {
      "private_auction": 1,
      "deals": [{
        "id": "deal-vip-xyz",
        "bidfloor": 5.0,
        "bidfloorcur": "USD",
        "at": 1,
        "wseat": ["dsp-001", "dsp-002"]
      }]
    }
  }]
}

미디어 타입 객체

각 Imp 안에는 해당 슬롯이 수용 가능한 미디어 타입 객체가 하나 이상 포함된다. 동일한 Imp에 Banner와 Video를 함께 넣으면 멀티포맷 입찰을 허용한다는 의미다. DSP는 응답 시 어떤 형식으로 크리에이티브를 제공할지 bid.mtype으로 명시한다.

flowchart LR
    subgraph Imp["imp[]"]
        BANNER["Banner"]
        VIDEO["Video"]
        AUDIO["Audio"]
        NATIVE["Native"]
    end

    subgraph ADM["bid.adm 크리에이티브"]
        HTML["HTML / JavaScript"]
        VAST["VAST XML"]
        DAAST["DAAST XML"]
        NJSON["Native JSON"]
    end

    BANNER --> HTML
    VIDEO --> VAST
    AUDIO --> DAAST
    NATIVE --> NJSON

Banner

배너는 이미지, HTML, 리치미디어 등 디스플레이 광고를 위한 객체다. format 배열로 여러 크기를 동시에 허용할 수 있으며, DSP는 그 중 하나를 선택해 응답한다.

Video

비디오 객체는 인스트림(Pre-roll, Mid-roll, Post-roll)과 아웃스트림 광고 지면을 표현한다. DSP는 이 정보를 기반으로 적합한 크리에이티브(VAST XML)를 응답한다.

plcmt 값 (OpenRTB 2.6에서 placement 대체): 1=Instream(프리롤/미드롤/포스트롤), 2=Accompanying Content(아웃스트림), 3=Interstitial(전면), 4=No Content/Standalone

protocols 주요 값: 2=VAST 2.0, 3=VAST 3.0, 5=VAST 2.0 Wrapper, 6=VAST 3.0 Wrapper, 7=VAST 4.0, 8=VAST 4.0 Wrapper

playbackmethod 주요 값: 1=Autoplay Sound On, 2=Autoplay Sound Off(모바일 표준), 3=Click-to-Play, 6=Viewport 진입 Sound Off

Ad Pods (CTV): CTV 환경에서 연속 재생 광고 블록을 구성할 때 podid(슬롯 공유 식별자), podseq(Pod 순서), slotinpod(슬롯 위치)을 사용한다. complete: 1이면 체인 완전, 0이면 일부 누락.

유형별 설정 요약

Pre-roll 비디오 요청 예시

{
  "imp": [{
    "id": "imp-preroll-1",
    "video": {
      "mimes": ["video/mp4"],
      "minduration": 5,
      "maxduration": 30,
      "protocols": [2, 3, 5, 6, 7, 8],
      "w": 1280,
      "h": 720,
      "linearity": 1,
      "plcmt": 1,
      "startdelay": 0,
      "skip": 1,
      "skipmin": 5,
      "skipafter": 5,
      "playbackmethod": [2]
    }
  }]
}

Audio

오디오 광고는 팟캐스트, 스트리밍 음악 서비스 등 오디오 콘텐츠 내 광고 지면을 표현한다. 응답 크리에이티브는 DAAST XML 형식이다.

Native

네이티브 광고는 피드 내 광고, 콘텐츠 추천 위젯 등 콘텐츠와 자연스럽게 어우러지는 광고 형식이다. 요청 스펙 자체를 JSON 문자열로 직렬화해 request 필드에 담는 독특한 구조를 갖는다.

{
  "native": {
    "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"img\":{\"type\":3,\"wmin\":300,\"hmin\":157}},{\"id\":2,\"required\":1,\"title\":{\"len\":90}},{\"id\":3,\"data\":{\"type\":2,\"len\":200}}]}",
    "ver": "1.2"
  }
}

컨텍스트 객체

컨텍스트 객체는 광고 요청이 발생한 환경을 DSP에게 알려준다. 어떤 사이트/앱에서 광고가 노출되는지(Site/App), 어떤 디바이스에서 접속했는지(Device), 어떤 사용자인지(User)를 기술한다. 타겟팅 정확도와 직결되는 정보이므로 DSP의 입찰 결정에 큰 영향을 준다.

Site / App

site는 웹 퍼블리셔, app은 모바일 앱 퍼블리셔 환경을 담는다. 두 객체는 BidRequest에 동시에 포함될 수 없으며 환경에 따라 하나만 사용한다.

{
  "site": {
    "id": "site-123",
    "domain": "news.example.com",
    "cat": ["IAB12"],
    "page": "https://news.example.com/article/123",
    "publisher": {"id": "pub-456", "name": "Example Media"}
  }
}

Device

광고 요청이 발생한 디바이스 정보를 담는다. 타겟팅, 광고 ID 매칭, 위치 기반 광고에 핵심적으로 사용된다.

User

광고 수신자인 사용자 정보를 담는다. 타겟팅 세그먼트, 확장 ID(eids), GDPR 동의 문자열 등이 포함된다.

{
  "user": {
    "id": "user-12345",
    "data": [
      {
        "id": "dmp-provider",
        "segment": [{"id": "seg-123"}, {"id": "seg-456"}]
      }
    ],
    "eids": [
      {"source": "liveramp.com", "uids": [{"id": "abc123", "atype": 3}]}
    ]
  }
}

Geo

device.geo(현재 위치)와 user.geo(홈 위치) 두 곳에 중첩된다. 주요 필드: lat/lon(위경도), country(ISO-3166-1-alpha-3), region(ISO-3166-2), city, type(1=GPS, 2=IP, 3=사용자 제공).

규제 & 투명성

Regs — 개인정보 규제 신호

Regs 객체는 해당 요청에 적용되는 개인정보 보호 규제를 명시한다. DSP는 이 정보를 기반으로 타겟팅 방식과 데이터 사용 범위를 결정해야 한다.

Privacy 신호는 세 객체에 분산된다: regs(규제 플래그), user.consent(TCF 동의 문자열), device.dnt/device.lmt(디바이스 레벨 추적 제한).

{
  "regs": {
    "coppa": 0,
    "gdpr": 1,
    "us_privacy": "1YNN",
    "gpp": "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN",
    "gpp_sid": [2, 6]
  },
  "user": {
    "consent": "CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA"
  },
  "device": {
    "dnt": 0,
    "lmt": 0
  }
}

Source & Supply Chain

Supply Chain(schain)은 광고 요청이 거쳐온 모든 중간 거래자(Publisher → SSP → Exchange → DSP)를 투명하게 기록한다. DSP는 이 정보로 요청 경로의 신뢰성을 검증하고 의심스러운 중간자가 있으면 입찰을 거부할 수 있다.

{
  "source": {
    "schain": {
      "complete": 1,
      "ver": "1.0",
      "nodes": [
        {
          "asi": "exchange1.com",
          "sid": "1234",
          "hp": 1,
          "rid": "req-abc",
          "name": "Exchange 1"
        },
        {
          "asi": "exchange2.com",
          "sid": "5678",
          "hp": 1
        }
      ]
    }
  }
}

schain Node 필드

complete: 1은 체인이 완전하다는 의미다. 중간 경로가 누락된 경우 complete: 0으로 설정한다.

BidRequest 전체 예시

아래는 모바일 앱에서 발생한 인스트림 비디오 광고 요청의 현실적인 예시다. GDPR 비적용 환경이며, 리워드 광고가 아닌 스킵 가능한 Pre-roll 지면이다.

{
  "id": "1234567890abcdef",
  "at": 1,
  "tmax": 200,
  "cur": ["USD"],
  "imp": [
    {
      "id": "imp-1",
      "tagid": "video-preroll-top",
      "video": {
        "mimes": ["video/mp4", "video/webm"],
        "minduration": 5,
        "maxduration": 30,
        "protocols": [2, 3, 5, 6, 7, 8],
        "w": 1280,
        "h": 720,
        "linearity": 1,
        "plcmt": 1,
        "startdelay": 0,
        "skip": 1,
        "skipmin": 5,
        "skipafter": 5,
        "playbackmethod": [2]
      },
      "bidfloor": 5.0,
      "bidfloorcur": "USD",
      "secure": 1
    }
  ],
  "app": {
    "id": "app-12345",
    "name": "Cool Game",
    "bundle": "com.example.coolgame",
    "storeurl": "https://play.google.com/store/apps/details?id=com.example.coolgame",
    "cat": ["IAB9-30"],
    "ver": "2.0",
    "publisher": {
      "id": "pub-67890",
      "name": "Example Publisher"
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15",
    "ip": "203.0.113.100",
    "geo": {
      "lat": 37.5665,
      "lon": 126.9780,
      "country": "KOR",
      "region": "11",
      "city": "Seoul"
    },
    "devicetype": 4,
    "make": "Apple",
    "model": "iPhone",
    "os": "iOS",
    "osv": "15.0",
    "language": "ko",
    "connectiontype": 2,
    "ifa": "AEBE52E7-03EE-455A-B3C4-E57283966239",
    "lmt": 0
  },
  "user": {
    "id": "user-abc123",
    "eids": [{"source": "liveramp.com", "uids": [{"id": "lr-uid-xyz", "atype": 3}]}]
  },
  "regs": {
    "coppa": 0,
    "gdpr": 0
  },
  "source": {
    "schain": {
      "complete": 1,
      "ver": "1.0",
      "nodes": [
        {
          "asi": "ssp.example.com",
          "sid": "pub-67890",
          "hp": 1,
          "rid": "1234567890abcdef"
        }
      ]
    }
  }
}

참고 자료

• OpenRTB 2.6 Specification (GitHub)
• IAB Tech Lab - OpenRTB
• IAB VAST 4.2
• OpenRTB Native Ads 1.2
• IAB TCF 2.0 (GDPR)