ironsource Exchange OpenRTB 2.5 사양
프로그래머틱 광고 구매를 위해 DSP 또는 광고 플랫폼을 Ironsource Exchange에 연결하려면 OpenRTB 2.5 사양을 따르십시오.
다음 문서에서는 Ironsource Exchange에서 지원하는 객체와 파라미터를 명시합니다. 사양을 검토하는 동안
OpenRTB 2.5 사양 가이드를 사용할 수 있는지 확인하십시오.
단가 요청
요청 오브젝트
파라미터 | Type | 항상 합격 | 설명 |
|---|
| 문자열 | 예 | 단가 요청의 고유 ID입니다. 이 ID는 단가 리스폰스 오브젝트 반환되어야 합니다. |
| 오브젝트 | 예 | Ironsource 단가 요청당 하나의 노출 오브젝트 지원합니다. 노출을 참조하십시오. |
| integer | 예 | 사용되는 경매 유형입니다. Ironsource 첫 번째 경매만 지원합니다. |
| 오브젝트 | 예 | 앱 설명 앱을 참조하십시오. |
| 오브젝트 | 예 | 기기 설명. 기기 를 참조하십시오. |
| 오브젝트 | 예 | 사용자 설명. 사용자 참조. |
| integer | 예 | 최대 시간(밀리초) ironsource 는 입찰 수신을 허용합니다. |
| 문자열 배열 | 예 | IAB 콘텐츠 카테고리를 사용하는 차단된 광고주 카테고리. |
| 문자열 배열 | 지원 안 함 | 도메인을 기준으로 광고주 차단 목록 |
| 문자열 배열 | 지원 안 함 | 차단 목록 애플리케이션. Android에서는 번들 또는 패키지 이름(예: com.foo.mygame)이어야 합니다. iOS에서는 숫자 ID입니다. |
| 오브젝트 | 예 | 인벤토리 소스와 최종 결정을 내리는 엔티티 대한 데이터를 제공하는 소스 오브젝트. |
| 오브젝트 | 예 | 이 요청에 힘 업계, 법률 또는 정부 규정을 지정하는 Regs 오브젝트. |
| 오브젝트 | 지원 안 함 | OpenRTB의 Ironsource 확장용 플레이스홀더. |
노출 오브젝트
파라미터 | Type | 항상 합격 | 설명 |
|---|
| 문자열 | 예 | Ironsource 단가 요청당 단일 노출 오브젝트 지원합니다. |
| 오브젝트 | 동영상 전용 | 오브젝트 비디오 노출을 설명하는 데 사용됩니다. 동영상을 참조하십시오. |
| 오브젝트 | 표시 전용 | 오브젝트 디스플레이 노출을 설명하는 데 사용됩니다. 배너 참조하십시오. |
| integer | 지원 안 함 | 1 = 광고가 인터스티셜 광고 또는 전체 화면이며 0 = 인터스티셜 광고 아닙니다. |
| integer | 예 | 아이언소스에는 안전한 HTTPS URL 소재 자산 및 마크업이 필요합니다. |
| 오브젝트 | 예 | 이 노출에 적용되는 비공개 시장 거래가 포함된 Pmp 오브젝트 |
| 플로트 | 예 | 이 노출에 대한 최소 단가(CPM 단가)입니다. |
| 문자열 | 예 | Ironsource USD만 허용 |
| 오브젝트 | 지원 안 함 | OpenRTB의 Ironsource 확장용 플레이스홀더. |
비디오 오브젝트
파라미터 | Type | 항상 합격 | 설명 |
|---|
| 문자열 배열 | 예 | 콘텐츠 MIME 유형이 지원됩니다. |
| integer | 예 | 최소 동영상 광고 기간(초)입니다. |
| integer | 예 | 초 단위의 최대 동영상 광고 기간 |
| 정수 배열 | 예 | 지원되는 비디오 프로토콜 배열 |
| integer | 예 | 비디오 플레이어 너비(기기 독립성 화소(DIPS 기준)입니다. |
| integer | 예 | 비디오 플레이어 높이(기기 독립성 화소(DIPS 기준)입니다. |
| integer | 예 | 노출의 플레이스먼트 타입입니다. |
| integer | 예 | 플레이어 동영상 건너뛰기를 허용할지 여부를 나타냅니다. |
| 정수 배열 | 예 | 차단된 소재 속성. |
| integer | 예 | 사용 중일 수 있는 재생 메서드입니다. |
| integer | 예 | 화면의 광고 포지션입니다. |
| 정수 배열 | 예 | 이 노출에 대해 지원되는 API 프레임워크 목록 |
| integer | 예 | 요청이 보상형 비디오 광고 유닛에 대한지 여부를 나타냅니다. 1 = 예, 0 = 아니요 |
배너 오브젝트
파라미터 | Type | 항상 합격 | 설명 |
|---|
| integer | 예 | 비디오 플레이어 너비(기기 독립성 화소(DIPS 기준)입니다. |
| integer | 예 | 비디오 플레이어 높이(기기 독립성 화소(DIPS 기준)입니다. |
| integer | 예 | 화면의 광고 포지션입니다. |
| 정수 배열 | 예 | 차단된 배너 광고 유형. |
| 정수 배열 | 예 | 차단된 소재 속성. |
| 정수 배열 | 예 | 이 노출에 대해 지원되는 API 프레임워크 목록 |
여러 크기가 허용될 때 사용됩니다.
파라미터 | Type | 항상 합격 | 설명 |
|---|
| integer | 예 | 비디오 플레이어 너비(기기 독립성 화소(DIPS 기준)입니다. |
| integer | 예 | 비디오 플레이어 높이(기기 독립성 화소(DIPS 기준)입니다. |
앱 오브젝트
파라미터 | Type | 항상 합격 | 설명 |
|---|
| 문자열 | 예 | Ironsource 관련 애플리케이션 ID |
| 문자열 | 예 | 플랫폼별 애플리케이션 식별자. Android에서는 번들 또는 패키지 이름이어야 합니다(예: com.foo.mygame). iOS에서는 보통 숫자 ID입니다. |
| 문자열 | 예 | 애플리케이션 이름 |
| 문자열 | 예 | 앱 스토어 URL |
| 문자열 배열 | 예 | 앱의 IAB 콘텐츠 카테고리 |
기기 오브젝트
파라미터 | Type | 항상 합격 | 설명 |
|---|
| 문자열 | 예 | 브라우저 사용자 에이전트 문자열. |
| 오브젝트 | 예 | Geo 오브젝트 의해 정의된 사용자 현재 위치라고 가정되는 기기 위치 |
| integer | 예 | 0 = 트래킹 제한되지 않으며 1 = 트래킹 상업 가이드라인 따라 제한되어야 하는 "광고 트래킹 제한" 신호입니다. |
| 문자열 | 예 | 기기 가장 가까운 IPv4 주소입니다. |
| integer | 예 | 일반적인 기기 타입입니다. |
| 문자열 | 예 | 기기 제조사. |
| 문자열 | 예 | 기기 모델. |
| 문자열 | 예 | 운영체제 |
| 문자열 | 예 | 운영체제 버전 |
| 문자열 | 예 | 알파 사용하는 브라우저 문자열입니다. |
| integer | 예 | 네트워크 연결 유형 |
| 문자열 | 예 | 클리어에서 광고주가 사용할 수 있도록 승인된 ID입니다(예: 해시되지 않음). |
| 문자열 | 예 | (iOS 전용) 한 개발자가 모든 앱 할당한 벤더 식별자. ifv 로 나열되어 ifa 필드 형식과 일치합니다. |
| integer | 예 | (iOS 전용) 앱 트래킹 권한 부여, 인증 상태를 나타냅니다. 여기서 0 = 확인되지 않음 1 = 제한됨 2 = 거부됨 3 = 승인됨 |
사용자 오브젝트
파라미터 | Type | 항상 합격 | 설명 |
|---|
| 문자열 | 예 | 사용자의 아이언소스별 ID |
| 플로트 | 예 | 특정 앱 세션의 특정 플레이스먼트에 대한 노출 수입니다. 세션이 종료되면 노출 뎁스 초기화됩니다. |
소스 오브젝트
파라미터 | Type | 항상 합격 | 설명 |
|---|
| 오브젝트 | 예 | sellers.json 정보가 포함된 Schain 오브젝트 |
| 오브젝트 배열 | 예 | 퍼블리셔 애플리케이션 sellers.json 정보 |
| 정수 | 예 | 워터폴 타입을 나타냅니다. 여기서 1=입찰, 0=인스턴스 |
Regs 오브젝트
파라미터 | Type | 항상 합격 | 설명 |
|---|
| 문자열 | 예 | 요청이 GDPR 규정의 적용 대상인지 여부를 지정합니다. |
Geo 오브젝트
파라미터 | Type | 항상 합격 | 설명 |
|---|
| 플로트 | 예 | 위도 -90.0에서 +90.0, 음수는 남쪽입니다. |
| 플로트 | 예 | -180.0에서 +180.0까지의 경도, 음수는 서쪽입니다. |
| 정수 | 예 | 위치 데이터의 소스 |
| 정수 | 예 | IP 주소로부터 지리적 위치를 결정하는 데 사용되는 서비스 또는 제공업체(해당하는 경우) |
| 문자열 | 예 | ISO-3166-1-alpha-3.3166-1-alpha-3.-3를 사용하는 국가 코드 |
| 문자열 | 예 | ISO-3166-2를 사용하는 영역 코드, 미국의 경우 2자리 상태 코드. |
| 문자열 | 예 | Google 메트로 코드입니다. |
| 문자열 | 예 | United Nations Code for Trade & Transport Locations를 사용하는 도시입니다. |
| 문자열 | 예 | zip 문자열 Zip 또는 우편 번호입니다. |
단가 응답
단가 응답 오브젝트
파라미터 | Type | 요구 사항 | 설명 |
|---|
| 문자열 | 필수 여부 | 단가해야 합니다. |
| 문자열 | 필수 여부 | Ironsource USD만 지원하며, 다른 ISO 통화 코드에서는 단가 리스폰스가 무시됩니다. |
| 문자열 | 권장 | 트래킹 지원하기 위해 입찰자가 생성한 리스폰스 ID입니다. |
| 정수 | 권장 | 입찰하지 않은 이유입니다. OpenRTB 2.3 사양의 리스트 5.22를 참조하십시오. |
| 오브젝트 배열 | 권장 | 리스폰스에서 여러 시트비드 오브젝트를 사용할 수 있지만, Ironsource 현재 하나의 시트비드 오브젝트 사용합니다. 선택한 seatbid 오브젝트에는 다음이 포함됩니다. 단가.id = impression.id |
시트 단가 오브젝트
파라미터 | Type | 요구 사항 | 설명 |
|---|
| 오브젝트 배열 | 필수 여부 | Ironsource 하나 이상의 단가 예상했습니다. |
단가 오브젝트
파라미터 | Type | 요구 사항 | 설명 |
|---|
| 문자열 | 필수 여부 | 트래킹 지원하기 위해 입찰자가 생성한 단가 ID입니다. |
| 문자열 | 권장 | 이 단가 적용되는 노출의 ID입니다. 이 값은 단가 요청에 제공된 노출 ID와 일치합니다. |
| 플로트 | 필수 여부 | 단가 (CPM)입니다. 0 이하인 값은 무시됩니다. |
| 문자열 | 권장 | 단가 경매에서 낙찰되면 Ironsource 호출하는 낙찰 알림 URL입니다. 반드시 게재, 조회, 청구 가능한 광고를 나타내는 것은 아닙니다. 버럴이 없으면 Nurl이 교체하고 과금 알림을 보고합니다. |
| 문자열 | 필수 여부 | 단가 비용이 청구될 때 Ironsource에서 호출하는 청구 알림 URL입니다. |
| 문자열 | 권장 | 단가가 손실된 것으로 알려진 경우 아이언소스가 호출하는 실패 알림 URL입니다. 아이언소스는 최종 경매에서 승리하는 데 필요한 최소 단가를 나타내는 매크로를 지원합니다. |
| 문자열 | 권장 | 광고 품질 확인을 지원하는 캠페인 ID입니다. |
| 문자열 | 권장 | 광고 품질 확인을 지원하는 소재 ID입니다. |
| 문자열 | 필수 여부 | 단가 승리하는 경우 광고 마크업을 전달하는 데 필요한 수단입니다. |
| 문자열 배열 | 필수(단가.bundle=null인 경우) | 블랙리스트 확인을 위한 광고주 도메인 |
| 문자열 | 필수(단가.adomain=null인 경우) | 플랫폼별 애플리케이션 식별자. Android에서는 번들 또는 패키지 이름이어야 합니다(예: "com.foo.mygame"). iOS에서는 보통 숫자 ID입니다. |
| 문자열 배열 | 권장 | 소재 IAB 콘텐츠 카테고리입니다. |
| 정수 배열 | 권장 | 소재 설명하는 속성 집합입니다. |
| 정수 | 필수 여부 | 소재 너비(기기 독립성 화소(DIPS 기준)입니다. |
| 정수 | 필수 여부 | 소재 높이(기기 독립성 화소(DIPS 기준)입니다. |
단가 응답 없음
입찰자는 Ironsource 내에서 '단가 없음'으로 간주되는 다음 중 하나로 응답할 수 있습니다. 다음 응답 중 하나를 사용하여 노출에 단가 싶지 않다고 명시적으로 알리는 것이 중요. 그렇지 않으면 응답이 시간 초과 오류로 해석될 수 있습니다.
단가 없음(예: 수요 없음, 노출 구매에 대한 관심 없음):
- HTTP 204 No Content
- 빈 JSON 객체: ""
- 잘 형성된 단가 없음 응답(NBR): 문제로 인한 단가 없음
{"id": "1234567890", "seatbid": \[\]}
- 잘 형성된 단가 응답:
{"id": "1234567890", "seatbid": \[\], "nbr": 2}
- nbr에 사용할 수 있는 문제 코드 리스트는 아래에서 확인할 수 있습니다.
값 | 설명 |
|---|
| 0 | 알 수 없는 오류 |
| 1 | 기술적 오류 |
| 2 | 잘못된 요청 |
| 3 | 알려진 웹 거미 |
| 4 | 의심되는 비인간 트래픽 |
| 5 | 클로드, 데이터 센터 또는 프록시 IP |
| 6 | 지원되지 않는 기기 |
| 7 | 차단된 퍼블리셔 |
| 8 | 사용자 불일치 |
단가 요청 및 응답의 예
비디오 단가 요청
{ id: "1627786837177779624\_a5850b20-f274-11eb-947b-0ded24f22667\_237775956\_client\_name", imp: \[ { id: "1", 동영상: { Mimes: \\[ "video/mp4", "video/3gpp", "application/x-mpegURL" \], minduration: 1, maxduration: 120, 프로토콜: \[ 2, 5, 3, 6 \], w: 480, h: 320, 플레이스먼트: 5, skip: 0, 플레이 메서드: \\[ 5 \], 포스트: 7, API: \[ 7 \], companiontype: \\[ 1, 2 \], ext: { 보상형 광고: 1 } }, pmp: { deals: \[ { id: "104v4ahb53bb5800016dqa9a", bidfloor: 8, bidfloorcur: "USD" } \] }, displaymanager: "ironsource", bidfloor: 8, bidfloorcur: "USD", secure: 1 } \], app: { id: "113551", name: "Jetpack Joyride", bundle: "457446957", storeurl: "https://itunes.apple.com/app/id457446957", cat: \[ "IAB9" \], 퍼블리셔: { id: "146249", name: "Halfbrick Studios Pty Ltd" } }, device: { ua: "Mozilla/5.0(iPhone, CPU iPhone OS 14\_7\_1(Mac OS X) AppleWebKit/605.1.15(KHTML(Gecko) Mobile/15E148", geo: { lat: 41.7405, lon: \\-87.6587, type: 2, ipservice: 3, 국가: "USA", 영역: "IL", metro: "602", city: "Chicago", zip: "60620" }, lmt: 0, ip: "74.93.69.246", devicetype: 4, make: "Apple", 모델: "iPhone13,2", OS: "ios", osv: "14.7.1", 언어: "es", connectiontype: 2, ifa: "01234567-89ABCDEF-01234567-89ABCDEF", ext: { acceptLang: "es-xl", atts: 3 } }, 사용자: { id: "01234567-89ABCDEF-01234567-89ABCDEF" }, at: 1, tmax: 996, bcat: \[ "IAB23", "IAB25", "IAB26", "IAB8-18", "IAB8-5", "IAB9-9", "IAB11-4", "IAB14-1", "IAB14-3", "IAB17-16", "IAB9-7", "IAB7-39", "IAB3-7", "IAB18-5" \], badv: \[ "bigo.tv" \], source: { ext: { omidpn: "Ironsrc", omidpv: "7", schain: { 참조: "1.0", 완료: 1, nodes: \[ { asi: "ironsrc.com", sid: "146249", hp: 1, rid: "1627786837177779624\_a5850b20-f274-11eb-947b-0ded24f22667\_237775956\_client\_name", name: "Halfbrick Studios Pty Ltd", domain: "halfbrick.com" } \] } } }, "regs": {}}
단가 표시
{ id: "1627791578182182085\_af5e8df0-f27f-11eb-9a60-f72fd6932f89\_1452093813\_client\_name\_b", imp: \[ { id: "1", 배너: { w: 320, h: 480, btype: \[ 1, 4 \], battr: \[ 3, 6, 7, 8, 9, 14, 10 \], 포스트: 7, API: \[ 5, 3, 7 \] }, displaymanager: "ironsource", instl: 1, bidfloor: 1.6, bidfloorcur: "USD", secure: 1 } \], app: { id: "318613", name: "Subway Surfers (비COPPA)", bundle: "com.kiloo.subwaysurf", storeurl: "https://play.google.com/store/apps/details?id=com.kiloo.subwaysurf", cat: \[ "IAB9" \], 퍼블리셔: { id: "235297", name: "SYBO Games" } }, device: { ua: "Mozilla/5.0(Linux; Android 6.0.1; SM-G532M 빌드/MMB29T; wv) AppleWebKit/537.36(Gecko와 같은 KHTML) 버전/4.0 Chrome/92.0.4515.115 모바일 Safari/537.36", geo: { lat: 19.3617, lon: \\-98.2338, type: 2, ipservice: 3, 국가: "MEX", 영역: "TLA", metro: "0", city: "Tlaxcala City", zip: "90000" }, lmt: 0, ip: "189.167.5.112", devicetype: 4, make: "samsung", 모델: "SM-G532M", OS: "android", osv: "6.0.1", js: 1, 언어: "es", connectiontype: 2, ifa: "01234567-89ABCDEF-01234567-89ABCDEF" }, 사용자: { id: "01234567-89ABCDEF-01234567-89ABCDEF" }, at: 1, tmax: 998, bcat: \[ "IAB23", "IAB25", "IAB26", "IAB8-18", "IAB8-5", "IAB9-9", "IAB11-4", "IAB14-1", "IAB14-3", "IAB17-16", "IAB9-7", "IAB7-39", "IAB3-7", "IAB18-5" \], badv: \[ "caliente.mx", "yoox.com", "wine.com.br" \], source: { ext: { omidpn: "Ironsrc", omidpv: "7", schain: { 참조: "1.0", 완료: 1, nodes: \[ { asi: "ironsrc.com", sid: "235297", hp: 1, rid: "1627791578182182085\_af5e8df0-f27f-11eb-9a60-f72fd6932f89\_1452093813\_client\_name\_b", name: "SYBO Games", domain: "sybogames.com" } \] } } }, "regs": {}}
{ id: "1627783392367073418\_a03b6950-f26c-11eb-a9af-31ac778e44a2\_1539835153\_client\_name", imp: \[ { id: "1", 배너: { format: \[ { w: 320, h: 50 }, { w: 300, h: 50 } \], w: 320, h: 50, 포스트: 5, API: \[ 5, 3 \] }, displaymanager: "ironsource", tagid: "2708683", bidfloor: 0.0128, bidfloorcur: "USD", secure: 1 } \], app: { id: "353553", name: "타일 연결 - 클래식 매치 게임", bundle: "1529839083", storeurl: "https://itunes.apple.com/app/id1529839083", cat: \[ "IAB9" \], 퍼블리셔: { id: "249491", name: "HIGGS TECHNOLOGY CO.,LIMITED" } }, device: { ua: "Mozilla/5.0(iPhone, CPU iPhone OS 14\_6(Mac OS X) AppleWebKit/605.1.15(KHTML(Gecko) Mobile/15E148", geo: { lat: 39.9357, lon: \\-75.1832, type: 2, ipservice: 3, 국가: "USA", 영역: "PA", metro: "504", city: "필라델피아", zip: "19146" }, lmt: 0, ip: "76.98.251.72", devicetype: 4, make: "Apple", 모델: "iPhone9,2", OS: "ios", osv: "14.6.0", language: "en", connectiontype: 2, ifa: "01234567-89ABCDEF-01234567-89ABCDEF", ext: { acceptLang: "en-us", atts: 3 } }, 사용자: { id: "01234567-89ABCDEF-01234567-89ABCDEF" }, at: 1, tmax: 996, bcat: \[ "IAB23", "IAB25", "IAB26", "IAB8-18", "IAB8-5", "IAB9-9", "IAB11-4", "IAB14-1", "IAB14-3", "IAB17-16", "IAB9-7", "IAB7-39", "IAB3-7", "IAB18-5" \], badv: \[ "gratonresortcasino.com" \], source: { ext: { schain: { 참조: "1.0", 완료: 1, nodes: \[ { asi: "ironsrc.com", sid: "249491", hp: 1, rid: "1627783392367073418\_a03b6950-f26c-11eb-a9af-31ac778e44a2\_1539835153\_client\_name", name: "HIGGS TECHNOLOGY CO.,LIMITED", domain: "higgsgamestudio.com" } \] } } }, "regs": {}}
대규모 단가 응답
{ id: "1543190416705343377\_ip-172-31-13-147\_41965ed0-f10e-11e8-b7cd-fd40aa7b8b5f", seatbid: \\[ { bid: \[ { id: "opp\_100", impid: "opp\_100", 가격: 15, adm: "VAST\_XML", adomain: \\[ "AD\_DOMAIN" \], cid: "6b3gxrn", crid: "aqgwb3x7" } \], 시트: "2821" } \], cur: "USD"}
인터스티셜 광고 단가 표시
{ id: "1543190412223390473\_ip-172-31-13-147\_3eea9fc0-f10e-11e8-9915-1beb61037050", seatbid: \\[ { bid: \[ { id: "46-45347979-4f8b-4547-8376-2cea2c3ac12a-1", impid: "opp\_100", 가격: 9.9906, nurl: "NURL\_PIXEL", adm: "소재", adomain: \\[ "" \], cid: "143354", crid: "46\_10304614", dealid: "20135c3f564b7bd7dd138a480427a69f", w: 320, h: 480, ext: { agency\_name: "NAME" } } \], 시트: "6" } \], cur: "USD"}
{ id: "1617285225335329365\_ad0f3240-92f1-11eb-9667-c36f23277c0b\_client-banner", seatbid: \\[ { bid: \[ { id: "b0f43c8b-d009-4cb2-adb5-1c2782400b35", impid: "opp\_100", 가격: 0.51, nurl: "NURL\_PIXEL", burl: "BURL\_PIXEL", adm: "CREATIVE\_ADM", adomain: \\[ "" \], crid: "123456789", w: 320, h: 50 } \] } \], cur: "USD"}