# 단가 요청 > 수요 파트너가 경매 신호를 효과적으로 해석하고 반응하도록 활성화하다, 사용 가능하다. Unity가 광고 요청을 수신하면 SDK는 사용자가 광고 사용을 제한하지 않는 경우 맞춤형 광고에 사용되는 데이터를 포함하여 모든 잠재적 입찰자에게 단가 요청을 보냅니다([데이터 개인정보 보호](/grow/programmatic/unity-exchange/data-privacy.md) 문서 참조). Unity 단가 요청 데이터에 JSON 포맷을 지원합니다. 표준 JSON 표현의 MIME 유형은 `application/json`이며 HTTP 헤더 필드에 다음과 같이 지정됩니다. ```text contentType: application/json Accept-Encoding: gzip ``` Unity는 요청에서 수락 인코딩 [GZIP 압축](https://www.gzip.org/)을 전송하고 응답 압축을 적극 권장합니다. 자세한 내용은 [OpenRTB 사양](https://iabtechlab.com/wp-content/uploads/2022/04/OpenRTB-2-6_FINAL.pdf)의 **섹션 2.4**를 참조하십시오. > **Important:** > > 단가 요청을 수신하려면 엔드포인트가 `HTTPS` 프로토콜을 지원해야 합니다. > **Note:** > > 설명 열에 달리 명시되지 않는 한 Unity 가능한 경우 다음의 각 단가 요청 속성을 전달합니다. ## request objects##request 상위 레벨 단가 요청 오브젝트 광고 요청의 전역적으로 고유한 ID가 포함되어 있습니다. | **속성** | **유형** | **예제** | **설명** | | -------- | ------ | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | `id` | 문자열 | `"id": "bcaIDT1Nbv0zU8mn9tXQ6j"` | Unity에서 생성한 ID입니다. 이 ID는 [단가 응답 오브젝트](/grow/programmatic/unity-exchange/bid-responses.md)에 반환되어야 합니다. | | `imp` | object | 자세한 내용은 [`impression objects`](#imp) 섹션을 참고하십시오. | Unity는 단가 요청당 하나의 `imp` 오브젝트를 지원합니다. | | `pmp` | object | 자세한 내용은 [`pmp objects`](#pmp) 섹션을 참고하십시오. | 개인 시장 컨테이너. 실제 거래는 [`deal objects`](#deal)의 컬렉션으로 표시됩니다. | | `app` | object | 자세한 내용은 [`app objects`](#app) 섹션을 참고하십시오. | 프로젝트나 애플리케이션을 설명하는 오브젝트입니다. | | `device` | object | 자세한 내용은 [`device objects`](#device) 섹션을 참고하십시오. | 사용자의 기기를 설명하는 오브젝트. | | `user` | object | 자세한 내용은 데이터 개인정보 보호 문서를 참조하십시오(/grow/programmatic/unity-exchange/data-privacy#user-object-extension). | 오브젝트입니다. | | `at` | int | `"at": 1` | 사용된 경매 유형입니다. 모든 Unity Exchange 경매는 최저가 경매이므로 항상 가격은 `1`입니다. | | `tmax` | int | `"tmax": 200` | 밀리초 단위의 시간 초과 값입니다.Unity는 파트너가 네트워크 연결이 끊어지지 않도록 200ms 이내에 응답하도록 권장합니다. | | `bcat` | 문자열 배열 | `"bcat": ["IAB9-9", "IAB8"]` | [IAB 분류 ID](/grow/programmatic/unity-exchange/iab-category-mapping.md)를 사용하여 차단된 광고주 카테고리.이 속성 지원되지만 선택 사항입니다. | | `bapp` | 문자열 배열 | `"bapp": ["com.foo.mygame"]` | 차단된 애플리케이션 목록으로, 해당 플랫폼으로 표시됩니다. Android에서는 번들 또는 패키지 이름입니다. iOS에서는 숫자 ID입니다. | | `source` | object | 자세한 내용은 [`source objects`](#source) 섹션을 참고하십시오. | 인벤토리 소스에 대한 데이터를 제공하는 오브젝트이며 최종 결정을 내리는 엔티티입니다. | | `regs` | object | 자세한 내용은 [데이터 개인정보 보호](/grow/programmatic/unity-exchange/data-privacy.md#user-object-extension) 기술 자료를 참고하십시오. | 이 요청에 적용되는 업계, 법률 또는 정부 규정을 명시하는 오브젝트입니다. | ## source objects##source 거래 위에서 단가 요청의 소스인 엔티티 성격과 동작 설명하는 오브젝트 클래스. 이 오브젝트 주요 목적은 거래 자체가 최종 결정을 제어하지 않는 경우 경매 후 또는 업스트림 의사 결정을 정의하는 것입니다. 자세한 내용은 [OpenRTB 가이드라인](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **오브젝트: 소스** 섹션을 참조하십시오. | **속성** | **유형** | **예제** | **설명** | | --------------------------- | ------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pchain` | 문자열 | `"pchain": "12abcd3456789:12345"` | [태그 결제 ID 프로토콜 v1.0](https://www.tagtoday.net/hubfs/CAF/TAG%20Certified%20Against%20Fraud%20Guidelines%20v1%202016.pdf)에 설명된 내장 구문이 포함된 결제 체인 ID 문자열입니다. | | `schain` | object | 자세한 내용은 [체인 오브젝트](#schain) 섹션을 참조하십시오. | 이 오브젝트는 공급망의 링크를 나타내며, 공급망이 완료되었는지 여부를 나타냅니다. | | `source.ext.omidpn` | 문자열 | `"omidpn": "Unity3d"` | 입니다. OMID Partner 오브젝트의 `name` 파라미터와 동일합니다. | | `source.ext.omidpv` | 문자열 | `"omidpv": "1.3.0"` | 버전입니다. OMID Partner 오브젝트의 `versionString` 파라미터와 동일합니다. | | `source.ext.header_bidding` | int | `"header_bidding": 0` | 경매 유형을 나타냅니다. 여기서 1은 입찰, 0은 폭발입니다. | | `source.ext.fd` | int | `"fd": 0` | 최종 노출 판매 결정을 담당하는 엔티티. 0은 거래, 1은 업스트림 소스입니다. | ## schain 오브젝트##schain 이 오브젝트 공급망의 링크를 나타내며, 공급망이 완료되었는지 여부를 나타냅니다. | **속성** | **유형** | **예제** | **설명** | | ---------- | ------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | `complete` | 정수 | `"complete": 1` | 사이트, 앱 또는 인벤토리의 다른 매체 소유자로 이어지는 거래에 관련된 모든 노드를 체인에 포함하는지 여부를 나타내는 플래그.- `0`는 아니요 - `1`는 예 | | `nodes` | 오브젝트 배열 | 필요 예제 | 배열입니다. 전체 공급망에서 첫 번째 노드는 트랜잭션과 관련된 초기 광고 시스템과 판매자 ID(예: 사이트, 앱 또는 기타 매체 소유자)를 나타냅니다. 불완전한 공급망에서 이는 알려진 첫 노드를 나타냅니다. 마지막 노드는 이 단가 요청을 전송하는 엔티티를 나타냅니다. | | `ver` | 문자열 | `"ver": "1.0"` | 사용 중인 공급망 사양의 버전(`"major.minor"` 형식)입니다. | ## 노드 오브젝트##nodes 거래 공급망에 참여하는 엔티티 나타내는 오브젝트. | **속성** | **유형** | **예제** | **설명** | | ------ | ------ | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `asi` | 문자열 | `"asi":"unity.com"` | 입찰자가 연결하는 시스템의 도메인 이름입니다. 부모 기업 도메인 다른 경우 시스템의 운영 도메인 수 있습니다. 이 값은 `app-ads.txt` 파일에 있는 판매자를 식별하는 데 사용되는 값과 동일해야 합니다. | | `sid` | 문자열 | `"sid":"​​1596090"` | ID입니다. OpenRTB 거래에 사용되는 것과 동일한 값을 포함해야 합니다. 이것은 일반적으로 `publisher.id`입니다. 이 필드의 길이를 64자로 제한합니다. | | `rid` | 문자열 | `"rid": "582f5fb3-0cc6-4944-ab12-1233175675e8-9999-36946"` | 이 판매자가 발행한 요청의 OpenRTB `RequestId`. | | `hp` | int | `"hp":1` | 이 노드가 인벤토리의 결제 플로에 참여하는지 여부를 나타냅니다.- `0`는 이 노드가 결제 플로에 포함되지 않았음을 나타냅니다. - `1`는 아시아 필드에 있는 광고 시스템이 시드 필드에 있는 판매자에게 지불하는 것을 나타내며, 이는 체인의 이전 노드를 지불하는 것을 담당합니다. | ## imp 오브젝트##imp 경매 중인 광고 노출을 설명하는 오브젝트 클래스. | **속성** | **유형** | **예제** | **설명** | | ----------------------- | ------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | | `banner` | object | 자세한 내용은 [`banner` 객체](#banner) 섹션을 참고하십시오. | 배너 디스플레이 노출을 설명하는 오브젝트.Unity 배너 및 디스플레이 광고에 대해서만 이 속성 전달합니다. | | `bidfloor` | 플로트 | `"bidfloor": 3.95` | 최소 CPM 단가입니다. USD로 표시됩니다. | | `displaymanager` | 문자열 | `"displaymanager": "unity sdk"` | 광고 Mediation 파트너, SDK 기술 또는 광고 렌더링을 담당하는 플레이어의 이름입니다. | | `displaymanagerver` | 문자열 | `4001` | 광고 Mediation 파트너, SDK 기술 또는 광고 렌더링을 담당하는 플레이어의 버전입니다. | | `id` | 문자열 | `"id": "1"` | Unity는 단가 요청당 하나의 `imp` 오브젝트를 지원하므로, `id` 값은 항상 `1`입니다. | | `instl` | int | `"instl": 1` | 배너 광고 요청의 값은 `0`입니다. 다른 모든 플레이스먼트는 삽입형이며, 값은 `1`입니다. | | `secure` | int | `"secure": 1` | Unity는 노출이 안전한 `HTTPS URL` 소재 자산 및 마크업을 보유해야 합니다. 가치는 항상 `1`입니다. | | `tagid` | 문자열 | `"tagid": "com.this.game-video"` | Unity는 `<appID>-<adType>`를 식별자로 전달합니다. | | `video` | object | 자세한 내용은 [비디오 객체](#video) 섹션을 참조하십시오. | 비디오 노출을 설명하는 오브젝트.Unity 동영상 광고의 경우 항상 이 속성 전달합니다. | | `ext.skadn` | object | 자세한 내용은 iOS 14 지원 기술 자료를 참고하십시오(/grow/programmatic/unity-exchange/ios14-support#impression-ext). | 퍼블리셔 앱의 파일에 DSP에 하나 `SKAdNetworkItem` 이상의 오브젝트가 있는 경우, Unity는 이 오브젝트를 입찰 요청에 포함합니다.`Info.plist` 서명을 생성하는 데 필요한 정보를 제공합니다. | | `ext.skadn.skoverlay` | 정수 | `1` | SKOverlay 기능에 대한 자격을 나타냅니다.- `1`는 imp이 SKOverlay를 표시할 수 있음을 나타냅니다. - `0`는 imp이 SKOverlay를 표시할 수 없음을 나타냅니다. | | `ext.skadn.productpage` | 정수 | `1` | 커스텀 제품 페이지 기능에 대한 자격을 나타냅니다.- `1`는 imp이 커스텀 제품 페이지를 표시할 수 있음을 나타냅니다. - `0`는 imp이 커스텀 제품 페이지를 표시할 수 없음을 나타냅니다. | | `ext.skadn.ext.ask` | 정수 | `1` | Auto Storekit 기능에 대한 자격을 나타냅니다.- `1`는 imp이 Auto Storekit을 표시할 수 있음을 나타냅니다. - `0`는 imp이 Auto Storekit 표시에 적합하지 않음을 나타냅니다. | ### video objects##video 동영상 광고 노출을 설명하는 `impression` 오브젝트 클래스의 하위 집합입니다. 자세한 내용은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **섹션 3.2.7**을 참조하십시오. | **속성** | **유형** | **예제** | **설명** | | --------------- | ------ | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `api` | int 배열 | `"api": [7]` | API 프레임워크입니다. `7` 값은 Open Measurement 지원을 의미합니다. 자세한 내용은 OM 확장 문서를 참조하십시오(/grow/programmatic/unity-exchange/om-extensions). | | `battr` | int 배열 | `"battr": [ 1, 3, 5, 6, 8, 9, 13]` | 차단된 소재 속성 배열. 지원되는 값의 전체 목록은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **표 5.3**을 참조하십시오.Unity 정책은 기본적으로 다음을 차단 것입니다.\[1] 오디오 광고(자동 재생)확장 가능한 \[3]\(자동)확장 가능한 \[5]\(사용자 시작 - 롤오버)\[6] 배너 비디오 광고(자동 재생)\[8] 팝(예: Over, Under 또는 Upon Exit)\[9] provocative 또는 suggestive Imagery\[13] 사용자 인터랙티브(예: 내장 프로젝트) | | `h` | int | `"h": 600` | 비디오 플레이어의 높이(기기 독립성 픽셀)입니다. | | `maxduration` | int | `"maxduration": 30` | 입니다. 이 값은 항상 `30`입니다. | | `mimes` | 문자열 배열 | `"mimes": ["video/mp4"]` | 지원되는 콘텐츠 MIME 타입(`"video/mp4"` 포함). | | `minduration` | int | `"minduration": 5` | 최소 동영상 광고 기간입니다. 이 값은 항상 `5`입니다. | | `placement` | int | `"placement": 5` | Unity 지원하는 동영상 플레이스먼트 유형은 다음과 같습니다.- `1`는 현재 상태를 나타냅니다. - `5`는 인터스티셜 광고 | | `pos` | int | `"pos": 7` | 비디오 광고의 위치입니다. Unity Ads 인벤토리는 항상 전체 화면(`7`)으로 설정됩니다. 지원되는 값의 전체 목록은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **표 5.4**를 참조하십시오. | | `protocols` | int 배열 | `"protocols": [2, 3, 5, 6]` | 지원되는 비디오 프로토콜의 배열. 지원되는 값의 전체 목록은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **표 5.8**을 참조하십시오.Unity는 VAST 2.0(2) 및 VAST 2.0 Wrapper(5)를 완벽하게 지원하며 VAST 3.0(3) 및 VAST 3.0 Wrapper(6)의 일부 기능을 지원할 수 있습니다. 자세한 내용은 세일즈 담당자 문의하시기 바랍니다. | | `w` | int | `"w": 1024` | 비디오 플레이어의 너비(기기 독립성 픽셀)입니다. | | `companiontype` | int 배열 | `"companiontype": [1,2,3]` | 지원되는 엔드카드 유형 배열(예: `StaticResource`(`1`), `HTMLResource`(`2`) 및 `IFrameResource`(`3`)). | | `linearity` | int | `"linearity": 1` | 표시합니다. Unity Exchange의 경우 이 값은 항상 `1`입니다. | | `skip` | int | `"skip": 1` | 동영상을 건너뛰을 수 있는지 여부를 나타냅니다.- `0`는 비디오를 건너뛰지 못함을 나타냅니다. - `1`는 비디오를 건너뛰을 수 있음을 나타냅니다.Unity Exchange의 경우 이 값은 항상 `1`입니다. | | `sequence` | int | `"sequence": 1` | 동일한 단가에 여러 광고 노출 수가 제공되는 경우 배열한 번호를 사용하면 여러 광고 소재를 조정적으로 게재할 수 있습니다. Unity Exchange의 경우 이 값은 항상 `1`입니다. | ### 배너 객체##banner 배너 광고 노출을 설명하는 `impression` 오브젝트 클래스의 하위 집합입니다. 자세한 내용은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **섹션 3.2.6**을 참조하십시오. | **속성** | **유형** | **예제** | **설명** | | -------- | ------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `api` | int 배열 | `"api": [6]` | 입니다. Unity는 MRAID 3.0(`6`)을 지원합니다. 지원되는 값의 전체 목록은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **5.6 API Frameworks** 표를 참조하십시오. | | `battr` | int 배열 | `"battr": [ 1, 3, 5, 6, 8, 9]` | 배너 소재 속성의 배열. 지원되는 값의 전체 목록은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **표 5.3**을 참조하십시오.Unity 정책은 기본적으로 다음을 차단 것입니다.- `[1]` 오디오 광고(자동 재생) - 확장 가능한 `[3]`(자동) - 확장 가능한 `[5]`(사용자 시작 - 롤오버) - `[6]` 배너 비디오 광고(자동 재생) - `[8]` 팝(예: Over, Under 또는 Upon Exit) - `[9]` 도전 또는 제안 상상 | | `format` | 오브젝트 배열 | `"format": [{"w": 728, "h": 90}]` | 지원되는 배너 디스플레이 크기를 나타내는 오브젝트 배열.배너 소재 형식 지원 크기:- 320x50 - 728x90소재 형식 지원 크기 표시:- 250x300 - 300x250 - 320x480 - 1024x768imp.banner 오브젝트는 모바일 배너 및 인터스티셜 광고 요청에만 전달됩니다. 포맷이 지정되지 않으면 크기는 imp.banner.h 및 imp.banner.w 값으로 기본 설정됩니다. 배너 형식이 지정되지 않으면 크기는 h 및 w 값으로 기본 설정됩니다. 다른 측정 항목 지원에 대한 질문이 있는 경우 Unity 지원 팀에 문의하십시오. | | `h` | int | `"h": 320` | 배너 디스플레이의 높이(기기 독립성 픽셀)입니다. | | `pos` | int | `"pos": 7` | 입니다. 지원되는 값의 전체 목록은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **표 5.4**를 참조하십시오. | | `w` | int | `"w": 480` | 배너 디스플레이의 너비(기기 독립성 픽셀)입니다. | ## pmp 오브젝트##pmp 노출과 관련될 수 있는 구매자와 판매자 간의 직접 거래를 위한 비공개 마켓플레이스 속성을 설명하는 오브젝트 클래스. 자세한 내용은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **섹션 3.2.11**을 참조하십시오. | **속성** | **유형** | **예제** | **설명** | | ----------------- | ------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | `deals` | 오브젝트 배열 | 자세한 내용은 [`deal objects`](#deal) 섹션을 참고하십시오. | 이 노출에 적용되는 특정 거래를 전달하는 `deal` 객체 배열입니다. | | `private_auction` | int | `"private_auction": 0` | [`deal`](#deal) 오브젝트에 명명된 시트에 대한 경매 자격을 나타냅니다.- `0`(기본값)는 모든 입찰이 승인되었음을 나타냅니다. - `1`는 단가가 지정된 거래와 해당 조건으로 제한되었음을 나타냅니다. | ## deal objects##deal 구매자와 판매자 간에 이루어진 특정 거래를 설명하는 오브젝트 클래스. 해당 상태는 해당 거래 약관에 따라 노출을 사용할 수 있음을 나타냅니다. 자세한 내용은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **섹션 3.2.12**을 참조하십시오. | **속성** | **유형** | **예제** | **설명** | | ------ | ------ | --------------------- | ------------------------------------------------------------------------------------------------------------------------ | | `at` | 정수 | `"at": 1` | 단가 요청의 경매 유형에 대한 선택적 오버라이드:- `1`는 첫 번째 가격 경매를 의미합니다. - `2`는 2가치 경매를 의미합니다. - `3`는 `bidfloor`에서 전달된 값이 동의된 거래 가격임을 나타냅니다. | | `id` | 문자열 | `"id": "abcdef12345"` | 직접 거래에 대한 고유 식별자입니다. | ## app objects##app 광고 요청을 생성하는 앱을 설명하는 오브젝트 클래스. 자세한 내용은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **섹션 3.2.14**을 참조하십시오. | **속성** | **유형** | **예제** | **설명** | | ----------- | ------ | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | | `bundle` | 문자열 | Google 예시:`"bundle": "com.unityexample.game"`Apple 예시:`"bundle": "1198634425"` | Exchange 간에 고유한 애플리케이션 번들 또는 패키지 이름입니다.- Android 앱 번들 ID를 전달. - iOS 앱 번들 ID 또는 스토어 ID를 전달.이 속성 퍼블리셔 계약서에서 이를 금지하는 상황에서 전달되지 않을 수 있습니다. | | `id` | 문자열 | `"id": "a1b2c3d4e5f6g7h8i9j0123456789abc"` | 전환별 애플리케이션 ID입니다. | | `name` | 문자열 | `"name": "Trash Dash"` | 애플리케이션 이름입니다.이 속성 퍼블리셔 계약서에서 이를 금지하는 상황에서 전달되지 않을 수 있습니다. | | `publisher` | object | `"publisher": "ExamplePublisher"` | 교환별 퍼블리셔 ID. | | `storeurl` | 문자열 | `"storeurl": "https://itunes.apple.com/us/app/trash-dash/id1198634425?mt=8"` | 설치된 앱의 스토어 URL입니다(QAG 1.5 준수용).이 속성 퍼블리셔 계약서에서 이를 금지하는 상황에서 전달되지 않을 수 있습니다. | ## 퍼블리셔 객체##publisher 광고 요청을 수행하는 퍼블리셔 설명하는 오브젝트 클래스. 자세한 내용은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **섹션 3.2.15**을 참조하십시오. | **속성** | **유형** | **예제** | **설명** | | ------ | ------ | ------------------------------------------ | --------------- | | `id` | 문자열 | `"id": "a1b2c3d4e5f6g7h8i9j0123456789abc"` | 교환별 퍼블리셔 ID입니다. | ## 기기 객체##device 최종 사용자 기기 설명하는 오브젝트 클래스. 자세한 내용은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **섹션 3.2.18**을 참조하십시오. | **속성** | **유형** | **예제** | **설명** | | ---------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `connectiontype` | 정수 | `"connectiontype": 1` | 네트워크 연결 유형입니다. 지원되는 값의 전체 목록은 [OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **표 5.22**를 참조하십시오. | | `devicetype` | int | `"devicetype": 4` | 일반적인 기기 타입입니다. 지원되는 값의 전체 목록은 [](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)[OpenRTB 사양](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)의 **표 5.21**를 참조하십시오.휴대폰과 태블릿 간의 분리가 OpenRTB 버전 2.2에 도입되었습니다.- `4`가 전화기를 지정합니다. - `5`는 태블릿을 지정합니다. | | `geo` | object | ```text "geo": { "lat":34.0544, "lon":-118.2441, "type":2, "country":"미국", "영역":"CA", "city":"로스앤젤레스", "utcoffset":-480 } ``` | 기기 위치 데이터(사용자 현재 위치로 간주됨):- `lat` - `lon` - `type` - `country` - `region` - `city` - `UTCoffset` | | `hwv` | 문자열 | `"hwv": "samsung SM-J200H"` | 기기의 하드웨어 버전입니다. | | `ifa` | 문자열 | `"ifa": "ab12c456-78de-90f1-ghi2-j3kl4567890m"` | 광고주가 사용하도록 허용된 Android Advertising ID(AID) 또는 광고주용 iOS 식별자(IFA/IDFA)입니다.Unity는 COPPA 또는 GDPR 규정 준수에 필요한 경우 이 필드를 지웁니다. | | `ip` | 문자열 | `"ip": "12.34.5.6"` | 기기 IP 주소입니다.Unity는 COPPA 또는 GDPR 준수에 필요한 경우 이 필드를 지웁니다. | | `language` | 문자열 | `"language": "en"` | [ISO-639-1-alpha-2](https://www.iso.org/iso-639-language-codes.html) 코드를 사용하는 브라우저 언어입니다. | | `lmt` | int | `"lmt": 1` | 상업적으로 승인된 "광고 트래킹 제한" 신호입니다.- `0`는 트래킹이 제한되지 않음을 나타냅니다. - `1`는 트래킹을 상업 가이드라인에 따라 제한해야 한다는 뜻입니다.값이 `1`일 때 Unity는 항상 이 속성을 전달하고 값이 `0`일 때는 생략합니다. | | `make` | 문자열 | `"make": "Apple"` | 기기의 제조사입니다. | | `model` | 문자열 | `"model": "iPhone7,2"` | 기기의 모델입니다. | | `os` | 문자열 | `"os": "ios"` | 기기의 운영체제입니다. | | `osv` | 문자열 | `"osv": "3.1.2"` | 기기의 운영체제 버전입니다. | | `ua` | 문자열 | `"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_0 like Mac OS X)``AppleWebKit/602.1.50 (KHTML, like Gecko) Mobile/14A345"` | 웹 브라우저 사용자 에이전트 문자열입니다. | | `carrier` | 문자열 | `"carrier": "Verizon"` | 기기의 서비스 제공업체. | ## 단가 요청 예제##examples ### VAST 입찰 요청##v-a-s-t ```json { "id": "bcaIDT1Nbv0zU8mn9tXQ6j", "at": 1, "tmax": 200, "source": { "pchain": "12abcd3456789:12345" "omidpn": "Unity3d", "omidpv": "1.3.0" }, "imp": [{ "id": "1", "secure": 1, "instl": 1, "tagid": "com.unity3d.ads.example-vast", "bidfloor": 3.95, "video": { "mimes": [ "video/mp4","application/javascript" ], "minduration": 5, "maxduration": 30, "placement": 5 "protocols": [2, 3, 5, 6], "pos": 7, "battr": [1, 3, 5, 8, 9, 13], "w": 1024, "h": 600, "api": [7], "companiontype": [1,2,3] } "displaymanager": "unity SDK", "displaymanagerver": "4001", "ext": { "skadn": { "ext": { "ask": 1 }, "skoverlay": 1, "productpage": 1 } } }], "app": { "id": "d01234idnfld234ier6c70930a", "name": 빌드 마을: 모든 게임, "publisher": { "id": "11972001l" }, "bundle": "12312312399", "storeurl": "https://apps.apple.com/us/app/build-a-town/id12312312399" }, "device": { "ifa": "ab12c456-78de-90f1-ghi2-j3kl4567890m", "make": "Apple", "model": "iPhone", "ua": "Mozilla/5.0(iPhone, CPU iPhone OS 10_0(Mac OS X) AppleWebKit/602.1.50(KHTML(Gecko) Mobile/14A345", "os": "ios", "ip": "12.34.5.6", "devicetype": 4, "carrier": "Apple", "osv": "10.1", "hwv": "iphone6", "geo": { "lat": 55.5492, "lon": 59.0456, "country": "USA", "city": "San Francisco", "type": 2, "utcoffset": 180 }, "connectiontype": 3, "language": "en", "h": 1184, "w": 768 }, "regs": { "coppa": 0 } } ``` ### 배너 단가 요청## 배너 예제 ```json { "id": "bcda7938-14eb-4a46-8dcb-bcd7587a964f", "imp": [ { "id": "1", "banner": { "w": 320, "h": 50, "battr": [ 1, 3, 5, 6, 8, 9, 13 ] }, "pmp": {}, "displaymanager": "unity SDK", "displaymanagerver": "3200", "tagid": "com.unity3d.ads.opstool-banner", "bidfloor": 3.95, "secure": 1 } ], "app": { "id": "2aa377f91oo12398465d6af383", "name": "예제 게임: 제2장, "publisher": { "id": "189857700" }, "bundle": "com.devexample.thegamebundlename", "storeurl": "https://play.google.com/store/apps/details?id=com.devexample.thegamebundlename\u0026hl=en" }, "device": { "ua": "Mozilla/5.0(Linux; Android 9; Pixel 빌드/PQ3A.190705.001; wv) AppleWebKit/537.36(Gecko와 같은 KHTML) 버전/4.0 Chrome/75.0.3770.101 모바일 Safari/537.36", "geo": { "lat": 37.7958, "lon": -122.4203, "type": 2, "country": "USA", "region": "CA", "city": "San Francisco", "utcoffset": -480 }, "ip": "4.14.109.3", "devicetype": 4, "make": "Google", "model": "Pixel", "os": "android", "osv": "9.0", "hwv": "Google Pixel", "w": 320, "h": 50, "language": "en", "connectiontype": 2, "ifa": "d0a77d1b-e974-41f3-84c5-8fe75718ef2d" }, "at": 1, "tmax": 500, "regs": { "ext": {} }, "ext": { "sessionDepth": 1 } } ``` ### 플레이어블 단가 요청##m-r-a-i-d ```json { "id": "abcIDT1Def0zU8mn9gHI6j", "source": { "pchain": "12abcd3456789:12345" }, "imp": [{ "id": "1", "banner": { "w": 1024, "h": 768, "battr": [1, 3, 5, 6, 8, 9], "pos": 7, "api": [5] }, "displaymanager": "unity SDK", "displaymanagerver": "4000", "instl": 1, "tagid": "com.unity-game.trashdash-m3-ios-display", "bidfloor": 3.95, "secure": 1 }], "app": { "id": "d01234idnfld234ier6c70930a", "name": 빌드 마을: 모든 게임, "publisher": { "id": "11972001l" }, "bundle": "12312312399", "storeurl": "https://apps.apple.com/us/app/build-a-town/id12312312399" }, "device": { "ifa": "ab12c456-78de-90f1-ghi2-j3kl4567890m", "ua": "Mozilla/5.0(iPad, CPU OS 11_2_2(Mac OS X) AppleWebKit/604.4.7(KHTML(Gecko) Mobile/15C202", "geo": { "lat": 55.5492, "lon": 59.0456, "country": "USA", "city": "San Francisco", "type": 2, "utcoffset": 180 }, "ip": "12.34.5.6", "devicetype": 5, "model": "iPad5,3", "os": "ios", "osv": "11.2.2", "hwv": "iPad Air 2 (Wi-Fi)", "h": 768, "w": 1024, "language": "en", "connectiontype": 2 }, "at": 1, "tmax": 200, "regs": {}, "ext": {} } ``` ### 인터스티셜 광고 단가 요청## 인터스티셜 광고 ```json { "id": "ApJv9QAmN3FJjEcTtFDtW3", "imp": [{ "id": "1", "banner": { "w": 480, "h": 320, "format": [ {"w":250,"h":300}, {"w":300,"h":250}, {"w":480,"h":320}, {"w":320,"h":480} ], "battr": [1, 3, 5, 6, 8, 9, 13], "pos": 7, "api": [5] }, "displaymanager": "unity SDK", "displaymanagerver": "3750", "instl": 1, "tagid": "com.unity3d.ads.example-display", "bidfloor": 3.95, "secure": 1 }], "app": { "id": "2aa377f91oo12398465d6af383", "name": "예제 게임: 제2장, "publisher": { "id": "189857700" }, "bundle": "com.devexample.thegamebundlename", "storeurl": "https://play.google.com/store/apps/details?id=com.devexample.thegamebundlename\u0026hl=en" }, "device": { "ua": "Mozilla/5.0(Linux; Android 5.1.1; SM-J200H 빌드/LMY48B; wv) AppleWebKit/537.36(Gecko와 같은 KHTML) 버전/4.0 Chrome/64.0.3282.137 모바일 Safari/537.36", "geo": { "lat": 55.5492, "lon": 59.0456, "country": "USA", "city": "San Francisco", "type": 2, "utcoffset": 180 }, "source": { "pchain": "12abcd3456789:12345" }, "ip": "12.34.5.6", "devicetype": 4, "make": "samsung", "model": "SM-J200H", "os": "android", "osv": "5.1", "hwv": "samsung SM-J200H", "h": 540, "w": 960, "language": "ru", "carrier": "Tele2", "connectiontype": 2, "ifa": "dd92e219-68ae-43b9-bcb7-e6fb7557806e" }, "at": 1, "tmax": 200, "regs": {}, "ext": { "placementType":"nonrewarded", "Mute":false, "gameCategory":"애플리케이션", "subGameCategory":"Tools", "sessionDepth":0 } } ```