Sample

Bid 요청과 응답 예제입니다.

1. Bid Request Sample

1-1. Banner

{
  "id": "123f3604-c79c-4e69-9d3e-b1c4d87ef679",
  "imp": [
    {
      "id": "751071b2-262f-4e82-bace-46c5c1501db7",
      "banner": {
        "w": 728,
        "h": 90,
        "battr": [
          6,
          7
        ]
      },
      "displaymanager": "adfit",
      "displaymanagerver": "4.21.2",
      "tagid": "DAN-123456789",
      "bidfloor": 10,
      "bidfloorcur": "KRW",
      "secure": 1
    }
  ],
  "site": {
    "id": "3sq",
    "publisher": {
      "name": "DAUM"
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 Mobile Safari/537.36",
    "sua": {
      "browsers": [
        {
          "brand": "Chrome Mobile",
          "version": [
            "96",
            "0",
            "4664"
          ]
        }
      ],
      "platform": {
        "brand": "Android"
      },
      "mobile": 1,
      "model": "Smartphone",

1-2. Native (비즈보드)

{
  "id": "7b0b5ddf-75ad-45d1-873f-e3b5fd593f5e",
  "imp": [
    {
      "id": "5b3bada7-6dbe-4ced-8c57-e342daecfc67",
      "native": {
        "request": "{\"native\":{\"ver\":\"1.1\",\"plcmtcnt\":1,\"assets\":[{\"id\":1619,\"required\":0,\"data\":{\"type\":701,\"len\":45},\"ext\":{\"assettype\":\"adfit-alt-text\"}},{\"id\":1620,\"required\":1,\"img\":{\"type\":702,\"w\":1029,\"h\":258},\"ext\":{\"assettype\":\"adfit-banner-img-url\"}},{\"id\":1621,\"required\":1,\"img\":{\"type\":703,\"w\":50,\"h\":50},\"ext\":{\"assettype\":\"adfit-ad-info\"}}]}}",
        "ver": "1.2"
      },
      "displaymanager": "adfit",
      "displaymanagerver": ""3.15.1",
      "tagid": "DAN-234567890",
      "bidfloor": 100,
      "bidfloorcur": "KRW",
      "secure": 1
    }
  ],
  "app": {
    "id": "5pU",
    "bundle": "com.kakao.talk",
    "storeurl": "https://play.google.com/store/apps/details?id=com.kakao.talk&hl=ko",
    "publisher": {
      "name": "TALK"
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 Mobile Safari/537.36",
    "sua": {
      "browsers": [
        {
          "brand": "Chrome Mobile",
          "version": [
            "96",
            "0",
            "4664"
          ]
        }
      ],
      "platform": {
        "brand": "android"

1-3. Native (2:1 Image)

{
  "bidRequest": {
    "id": "1235b335-1234-1234-1234-191a1a958e75-1234",
    "allimps": 0,
    "at": 1,
    "tmax": 180,
    "cur": [
      "KRW"
    ],
    "imp": [
      {
        "bidfloorcur": "KRW",
        "secure": 1,
        "id": "12396535-f770-4b78-ac45-e56cd65ca13d",
        "native": {
          "request": "{\"native\":{\"ver\":\"1.1\",\"plcmtcnt\":1,\"assets\":[{\"id\":2033,\"required\":0,\"data\":{\"type\":701,\"len\":45},\"ext\":{\"assettype\":\"adfit-alt-text\"}},{\"id\":2034,\"required\":1,\"img\":{\"type\":703,\"w\":50,\"h\":50},\"ext\":{\"assettype\":\"adfit-ad-info\"}},{\"id\":2035,\"required\":1,\"data\":{\"type\":2,\"len\":45},\"ext\":{\"assettype\":\"adfit-desc\"}},{\"id\":2036,\"required\":1,\"img\":{\"type\":3,\"w\":1200,\"h\":600},\"ext\":{\"assettype\":\"adfit-main-img-url\"}},{\"id\":2037,\"required\":1,\"title\":{\"len\":25},\"ext\":{\"assettype\":\"adfit-title\"}},{\"id\":2038,\"required\":1,\"data\":{\"type\":1,\"len\":20},\"ext\":{\"assettype\":\"adfit-profile-name\"}},{\"id\":2039,\"required\":1,\"img\":{\"type\":1,\"w\":300,\"h\":300},\"ext\":{\"assettype\":\"adfit-profile-img-url\"}}]}}",
          "ver": "1.1"
        },
        "displaymanager": "adfit",
        "displaymanagerver": "4.34.1",
        "tagid": "DAN-1234567890",
        "bidfloor": 100
      }
    ],
    "site": {
      "page": "https://sports.daum.net",
      "publisher": {
        "name": "DAUM"
      },
      "id": "32a"
    },
    "device": {
      "ip": "221.166.1",
      "pxratio": 3,
      "ppi": 96,
      "h": 780,
      "w": 360,
      "os": "android",
      "osv": "15.0.0",
      "ifa": "12345678-9463-4722-913a-0662c30e6c0d",
      "ua": "Mozilla/5.0 (Linux; Android 15; SM-S921N Build/AP3A.240905.015.A2; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/140.0.7339.51 Mobile Safari/537.36 DaumApps/8.3.2 DaumDevice/mobile",
      "sua": {
        "source": 2,
        "browsers": [
          {
            "brand": "chrome",
            "version": [
              "140"
            ]
          }
        ],
        "platform": {
          "brand": "android",
          "version": [
            "15",
            "0",
            "0"
          ]
        },
        "mobile": 1,
        "model": "SM-S921N"
      },
      "model": "SM-S921N"
    },
    "bcat": [
      "IAB11-3",
      "IAB11-4",
      "IAB9-7",
      "IAB9-9"
    ],
    "badv": [],
    "user": {
      "id": "12345"
    },
    "source": {
      "fd": 1,
      "tid": "1235b335-1234-1234-1234-191a1a958e75-1234",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "kakao.com",
            "sid": "1v8",
            "rid": "1235b335-1234-1234-1234-191a1a958e75-1234",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  }
}

1-4. Native (Video)

{
  "bidRequest": {
    "id": "f963959a-1234-1234-1234-d09dd132c9bb-1234",
    "allimps": 0,
    "at": 1,
    "tmax": 180,
    "imp": [
      {
        "bidfloorcur": "KRW",
        "id": "e5c4fc8f-1234-1234-1234-f974ffe7f2fb",
        "displaymanager": "adfit",
        "tagid": "DAN-123456789",
        "secure": 1,
        "native": {
          "request": "{\"native\":{\"ver\":\"1.1\",\"plcmtcnt\":1,\"assets\":[{\"id\":1642,\"required\":0,\"data\":{\"type\":701,\"len\":45},\"ext\":{\"assettype\":\"adfit-alt-text\"}},{\"id\":1643,\"required\":1,\"img\":{\"type\":703,\"w\":50,\"h\":50},\"ext\":{\"assettype\":\"adfit-ad-info\"}},{\"id\":1644,\"required\":0,\"data\":{\"type\":2,\"len\":45},\"ext\":{\"assettype\":\"adfit-desc\"}},{\"id\":1645,\"required\":1,\"video\":{\"mimes\":[\"video/mp4\"],\"minduration\":0,\"maxduration\":3600,\"protocols\":[3],\"w\":720,\"h\":1280},\"ext\":{\"assettype\":\"adfit-video\"}},{\"id\":1646,\"required\":1,\"img\":{\"type\":701,\"w\":720,\"h\":1280},\"ext\":{\"assettype\":\"adfit-video-image-url\"}},{\"id\":1647,\"required\":1,\"title\":{\"len\":25},\"ext\":{\"assettype\":\"adfit-title\"}},{\"id\":1648,\"required\":1,\"data\":{\"type\":1,\"len\":20},\"ext\":{\"assettype\":\"adfit-profile-name\"}},{\"id\":1649,\"required\":1,\"img\":{\"type\":1,\"w\":300,\"h\":300},\"ext\":{\"assettype\":\"adfit-profile-img-url\"}},{\"id\":1650,\"required\":1,\"data\":{\"type\":12,\"len\":7},\"ext\":{\"assettype\":\"adfit-action-button\"}}]}}",
          "ver": "1.1"
        },
        "displaymanagerver": "3.14.16",
        "bidfloor": 100,
        "ext": {
          "skadn": {
            "skadnetids": [],
            "sourceapp": "365494029",
            "productpage": 1,
            "versions": [
              "2.0",
              "2.1",
              "2.2",
              "3.0",
              "4.0"
            ],
            "skadnetlist": {
              "addl": []
            }
          }
        }
      }
    ],
    "app": {
      "id": "C0E",
      "bundle": "365494029",
      "storeurl": "https://apps.apple.com/kr/app/id365494029",
      "ver": "7.5.2",
      "publisher": {
        "id": "1v8",
        "name": "DAUM"
      }
    },
    "device": {
      "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_2_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
      "sua": {
        "browsers": [
          {
            "brand": "Mobile Safari UI/WKWebView",
            "version": [
              "18",
              "2",
              "1"
            ]
          }
        ],
        "platform": {
          "version": [
            "18",
            "2",
            "1"
          ],
          "brand": "iOS"
        },
        "mobile": 1,
        "model": "iPhone",
        "source": 3
      },
      "os": "iOS",
      "osv": "18.2.1",
      "ifa": "00000000-0000-0000-0000-000000000000",
      "lmt": 1,
      "model": "iPhone",
      "hwv": "iPhone14,7",
      "ip": "211.235.1",
      "make": "apple"
    },
    "cur": [
      "KRW"
    ],
    "user": {},
    "bcat": [
      "IAB11-3",
      "IAB11-4"
    ],
    "badv": [],
    "source": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "sid": "1v8",
            "rid": "f963959a-1234-1234-1234-d09dd132c9bb-1234",
            "hp": 1,
            "asi": "kakao.com"
          }
        ],
        "ver": "1.0"
      },
      "fd": 1,
      "tid": "f963959a-1234-1234-1234-d09dd132c9bb-1234"
    }
  }
}

2. Bid Respone Sample

2-1. Banner

{
  "id": "45d151e9-f4b3-11e9-994a-6c92bfcfe7de",
  "bidid": "45d151e9-f4b3-11e9-994a-6c92bfcfe7de",
  "cur": "KRW",
  "seatbid": [
    {
      "seat": "DSPID",
      "bid": [
        {
          "id": "afv103nf23ifnaneoelanfjer",
          "impid": "45d151e8-f4b3-11e9-994a-6c92bfcfe7de",
          "price": 943.1401,
          "adid": "1686d151-7116-41ee-adab-aff1884960af",
          "nurl": "https://nurl.com/win?price=${AUCTION_PRICE}",
          "adm": "<>",
          "adomain": [
            "kakao.com"
          ],
          "iurl": " https://iurl.png",
          "cid": "0000",
          "crid": "1234",
          "attr": [],
          "w": 728,
          "h": 90,
          "cat": "IAB22"
        }
      ]
    }
  ]
}

2-2. Native (비즈보드)

{
  "bidResponse": {
    "id": "cf1298b2-d36c-42c6-8456-20afca112ffb",
    "cur": "KRW",
    "seatbid": [
      {
        "seat": "DSPID",
        "bid": [
          {
            "id": "1",
            "impid": "512a16df-c5af-49be-a488-6f779f54c5db",
            "price": 238.79,
            "adid": "1686d151-7116-41ee-adab-aff1884960af",
            "nurl": "https://nurl.com/win?price=${AUCTION_PRICE}",
            "lurl": "https://lurl.com/loss?code=${AUCTION_LOSS}&price=${AUCTION_MIN_TO_WIN}",
            "adm": "{\"native\":{\"assets\":[{\"id\":3298,\"required\":1,\"img\":{\"url\":\" https://admark.png\",\"h\":50,\"w\":50},\"link\":{\"url\":\"https://link.html\",\"clicktrackers\":null}},{\"id\":3299,\"required\":1,\"img\":{\"url\":\" https://iurl.png\",\"h\":258,\"w\":1029}}],\"link\":{\"url\":\"https://link.com",\"clicktrackers\":[]},\"imptrackers\":[],\"privacy\":\"\",\"ext\":{}}}",
            "adomain": [
              "kakao.com"
            ],
            "bundle": "com.kakao.talk",
            "iurl": "https://iurl.png",
            "cid": "0000",
            "crid": "1234",
            "cat": [
              "IAB14"
            ]
          }
        ]
      }
    ]
  }
}

2-3. Native (2:1 Image)

{
  "status": "OK",
  "elapseMillis": 100,
  "bidResponse": {
    "id": "1235b335-1234-1234-1234-191a1a958e75-1234",
    "bidid": "9dceb689b22341269ab810bdae5f574f",
    "cur": "KRW",
    "seatbid": [
      {
        "bid": [
          {
            "id": "dea90b91d1304dc798d8e6450ca6b093",
            "impid": "d397c085-b592-4400-8b73-659bd2332a5f",
            "price": 377.99,
            "adid": "3972179",
            "adm": "{\"native\":{\"assets\":[{\"id\":2033,\"data\":{\"value\":\"카카오비지니스\"}},{\"id\":2035,\"img\":{\"url\":\"https://admark.jpg\",\"w\":50,\"h\":50}},{\"id\":2035,\"data\":{\"value\":\"비즈니스, 톡처럼 쉬워지다\"}},{\"id\":2036,\"img\":{\"url\":\"https://mainimg.jpg\",\"w\":1200,\"h\":600}},{\"id\":2037,\"title\":{\"text\":\"새로운 연결, 더 나은 세상\"}},{\"id\":2038,\"data\":{\"value\":\"카카오\"}},{\"id\":2039,\"img\":{\"url\":\"https://profileimg.png\",\"w\":300,\"h\":300}}],\"link\":{\"url\":\"https://kakao.com\",\"clicktrackers\":[]}}}\n",
            "adomain": [
              "kakao.com"
            ],
            "iurl": "https://mainimg.jpg",
            "cid": "123",
            "crid": "45678",
            "cat": [
              "IAB7-32"
            ],
            "nurl": "https://nurl.com/win?price=${AUCTION_PRICE}",
            "lurl": "https://lurl.com/loss?code=${AUCTION_LOSS}&price=${AUCTION_MIN_TO_WIN}",
            "burl": "https://burl.com/bill?price=${AUCTION_PRICE}"
          }
        ]
      }
    ]
  }
}

2-4. Native (Video)

{
  "status": "OK",
  "elapseMillis": 100,
  "bidResponse": {
    "id": "963959a-1234-1234-1234-d09dd132c9bb-1234",
    "bidid": "124e9cecb1f64817bd7dfa03d2336ce0",
    "cur": "KRW",
    "seatbid": [
      {
        "bid": [
          {
            "id": "12f241fbdb054e75b3d512cf5596268f",
            "impid": "12126ceb-1234-1234-1234-9b7cd8a3bc67",
            "price": 1436.17,
            "adid": "2985964",
            "nurl": "https://nurl.com/win?price=${AUCTION_PRICE}",
            "lurl": "https://lurl.com/loss?code=${AUCTION_LOSS}&price=${AUCTION_MIN_TO_WIN}",
            "burl": "https://burl.com/bill?price=${AUCTION_PRICE}",
            "adm": "{\"native\":{\"assets\":[{\"id\":1643,\"img\":{\"url\":\"admark.jpg\",\"w\":50,\"h\":50}},{\"id\":1644,\"data\":{\"value\":\"비즈니스, 톡처럼 쉬워지다\"}},{\"id\":1645,\"video\":{\"vasttag\":\"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?><VAST version=\\\"3.0\\\"><Ad><InLine><AdSystem>IRIS</AdSystem><AdTitle>KAKAO AD</AdTitle><Error><![CDATA[]]></Error><Impression/><Creatives><Creative><Linear><Duration>00:00:27.015</Duration><TrackingEvents><Tracking event=\\\"start\\\"><![CDATA[https://trackingurl.com/vd?wa=td&ast=[VX_START_TYPE]]]></Tracking><Tracking event=\\\"firstQuartile\\\"><![CDATA[https://trackingurl.com/vd?wa=td]]></Tracking><Tracking event=\\\"midpoint\\\"><![CDATA[https://trackingurl.com/vd?wa=td]]></Tracking><Tracking event=\\\"thirdQuartile\\\"><![CDATA[https://trackingurl.com/vd?wa=td]]></Tracking><Tracking event=\\\"complete\\\"><![CDATA[https://trackingurl.com/vd?wa=td]]></Tracking><Tracking event=\\\"unmute\\\"><![CDATA[https://trackingurl.com/vd?wa=td]]></Tracking><Tracking event=\\\"progress\\\" offset=\\\"00:00:03\\\"><![CDATA[https://trackingurl.com/vd?wa=td]]></Tracking><Tracking event=\\\"progress\\\" offset=\\\"00:00:05\\\"><![CDATA[https://trackingurl.com/vd?wa=td]]></Tracking><Tracking event=\\\"progress\\\" offset=\\\"00:00:10\\\"><![CDATA[https://trackingurl.com/vd?wa=td]]></Tracking><Tracking event=\\\"progress\\\" offset=\\\"00:00:15\\\"><![CDATA[https://trackingurl.com/vd?wa=td]]></Tracking><Tracking event=\\\"progress\\\" offset=\\\"00:00:26.205\\\"><![CDATA[https://trackingurl.com/vd?wa=td]]></Tracking></TrackingEvents><MediaFiles><MediaFile delivery=\\\"progressive\\\" type=\\\"video/mp4\\\" bitrate=\\\"2000\\\" width=\\\"720\\\" height=\\\"1280\\\"><![CDATA[https://kakaocdn.net/.P720.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>\"}},{\"id\":1646,\"img\":{\"url\":\"mainimg.jpg\",\"w\":720,\"h\":1280}},{\"id\":1647,\"title\":{\"text\":\"카카오 비지니스\"}},{\"id\":1648,\"data\":{\"value\":\"카카오 비지니스\"}},{\"id\":1649,\"img\":{\"url\":\"profileimg.png\",\"w\":300,\"h\":300}},{\"id\":1650,\"data\":{\"value\":\"알아보기\"}},{\"id\":1642,\"data\":{\"value\":\"카카오비지니스\"}}],\"link\":{\"url\":\"https://kakao.com\",\"clicktrackers\":[]}}",
            "adomain": [
              "kakao.com"
            ],
            "cid": "123",
            "crid": "45678",
            "cat": [
              "IAB11-2"
            ]
          }
        ]
      }
    ]
  }
}

Last updated

Was this helpful?