단가 요청
수요 파트너가 경매 신호를 효과적으로 해석하고 반응하도록 활성화하다, 사용 가능하다.
읽는 시간 27분최근 업데이트: 9시간 전
Unity가 광고 요청을 수신하면 SDK는 사용자가 광고 사용을 제한하지 않는 경우 맞춤형 광고에 사용되는 데이터를 포함하여 모든 잠재적 입찰자에게 단가 요청을 보냅니다(데이터 개인정보 보호 문서 참조).
Unity 단가 요청 데이터에 JSON 포맷을 지원합니다. 표준 JSON 표현의 MIME 유형은 이며 HTTP 헤더 필드에 다음과 같이 지정됩니다.
application/jsoncontentType: application/jsonAccept-Encoding: gzip
Unity는 요청에서 수락 인코딩 GZIP 압축을 전송하고 응답 압축을 적극 권장합니다. 자세한 내용은 OpenRTB 사양의 섹션 2.4를 참조하십시오.
request objects
상위 레벨 단가 요청 오브젝트 광고 요청의 전역적으로 고유한 ID가 포함되어 있습니다.
속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
| 문자열 | | Unity에서 생성한 ID입니다. 이 ID는 단가 응답 오브젝트에 반환되어야 합니다. |
| object | 자세한 내용은 | Unity는 단가 요청당 하나의 |
|
object | 자세한 내용은 |
노출과 관련이 있을 수 있는 구매자와 판매자 간의 직접 거래를 위한 개인 시장 컨테이너. 실제 거래는 |
| object | 자세한 내용은 | 프로젝트나 애플리케이션을 설명하는 오브젝트입니다. |
| object | 자세한 내용은 | 사용자의 기기를 설명하는 오브젝트. |
|
object | 자세한 내용은 데이터 개인정보 보호 문서를 참조하십시오(/grow/programmatic/unity-exchange/data-privacy#user-object-extension). | 기기의 사용자 또는 광고의 잠재 고객을 나타내는오브젝트입니다. |
| int | | 사용된 경매 유형입니다. 모든 Unity Exchange 경매는 최저가 경매이므로 항상 가격은 |
| int | | 밀리초 단위의 시간 초과 값입니다. |
| 문자열 배열 | | IAB 분류 ID를 사용하여 차단된 광고주 카테고리. |
| 문자열 배열 | | 차단된 애플리케이션 목록으로, 해당 플랫폼으로 표시됩니다. Android에서는 번들 또는 패키지 이름입니다. iOS에서는 숫자 ID입니다. |
| object | 자세한 내용은 | 인벤토리 소스에 대한 데이터를 제공하는 오브젝트이며 최종 결정을 내리는 엔티티입니다. |
| object | 자세한 내용은 데이터 개인정보 보호 기술 자료를 참고하십시오. | 이 요청에 적용되는 업계, 법률 또는 정부 규정을 명시하는 오브젝트입니다. |
source objects
거래 위에서 단가 요청의 소스인 엔티티 성격과 동작 설명하는 오브젝트 클래스. 이 오브젝트 주요 목적은 거래 자체가 최종 결정을 제어하지 않는 경우 경매 후 또는 업스트림 의사 결정을 정의하는 것입니다. 자세한 내용은 OpenRTB 가이드라인의 오브젝트: 소스 섹션을 참조하십시오.
속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
| 문자열 | | 태그 결제 ID 프로토콜 v1.0에 설명된 내장 구문이 포함된 결제 체인 ID 문자열입니다. |
| object | 자세한 내용은 체인 오브젝트 섹션을 참조하십시오. | 이 오브젝트는 공급망의 링크를 나타내며, 공급망이 완료되었는지 여부를 나타냅니다. |
|
문자열 | |
Open Measurement SDK 통합을 위한 식별자 입니다. OMID Partner 오브젝트의 |
|
문자열 | |
Open Measurement SDK 통합의 버전입니다. OMID Partner 오브젝트의 |
| int | | 경매 유형을 나타냅니다. 여기서 1은 입찰, 0은 폭발입니다. |
| int | | 최종 노출 판매 결정을 담당하는 엔티티. 0은 거래, 1은 업스트림 소스입니다. |
schain 오브젝트
이 오브젝트 공급망의 링크를 나타내며, 공급망이 완료되었는지 여부를 나타냅니다.
속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
| 정수 | | 사이트, 앱 또는 인벤토리의 다른 매체 소유자로 이어지는 거래에 관련된 모든 노드를 체인에 포함하는지 여부를 나타내는 플래그.
|
|
오브젝트 배열 | 필요 예제 | 체이닝 순서대로배열입니다. 전체 공급망에서 첫 번째 노드는 트랜잭션과 관련된 초기 광고 시스템과 판매자 ID(예: 사이트, 앱 또는 기타 매체 소유자)를 나타냅니다. 불완전한 공급망에서 이는 알려진 첫 노드를 나타냅니다. 마지막 노드는 이 단가 요청을 전송하는 엔티티를 나타냅니다. |
| 문자열 | | 사용 중인 공급망 사양의 버전( |
노드 오브젝트
거래 공급망에 참여하는 엔티티 나타내는 오브젝트.
속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
| 문자열 | | 입찰자가 연결하는 시스템의 도메인 이름입니다. 부모 기업 도메인 다른 경우 시스템의 운영 도메인 수 있습니다. 이 값은 |
|
문자열 | |
광고 시스템 내에서 판매자 또는 리셀러 계정에 연결된 ID입니다. OpenRTB 거래에 사용되는 것과 동일한 값을 포함해야 합니다. 이것은 일반적으로 |
| 문자열 | | 이 판매자가 발행한 요청의 OpenRTB |
| int | | 이 노드가 인벤토리의 결제 플로에 참여하는지 여부를 나타냅니다.
|
imp 오브젝트
경매 중인 광고 노출을 설명하는 오브젝트 클래스.
속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
| object | 자세한 내용은 | 배너 디스플레이 노출을 설명하는 오브젝트. |
|
플로트 | |
이 노출을 얻기 위해 필요한 최소 CPM 단가입니다. USD로 표시됩니다. |
| 문자열 | | 광고 Mediation 파트너, SDK 기술 또는 광고 렌더링을 담당하는 플레이어의 이름입니다. |
| 문자열 | | 광고 Mediation 파트너, SDK 기술 또는 광고 렌더링을 담당하는 플레이어의 버전입니다. |
| 문자열 | | Unity는 단가 요청당 하나의 |
| int | | 배너 광고 요청의 값은 |
| int | | Unity는 노출이 안전한 |
| 문자열 | | Unity는 |
| object | 자세한 내용은 비디오 객체 섹션을 참조하십시오. | 비디오 노출을 설명하는 오브젝트. |
| object | 자세한 내용은 iOS 14 지원 기술 자료를 참고하십시오(/grow/programmatic/unity-exchange/ios14-support#impression-ext). | 퍼블리셔 앱의 파일에 DSP에 하나 |
| 정수 | | SKOverlay 기능에 대한 자격을 나타냅니다.
|
| 정수 | | 커스텀 제품 페이지 기능에 대한 자격을 나타냅니다.
|
| 정수 | | Auto Storekit 기능에 대한 자격을 나타냅니다.
|
video objects
동영상 광고 노출을 설명하는 오브젝트 클래스의 하위 집합입니다. 자세한 내용은 OpenRTB 사양의 섹션 3.2.7을 참조하십시오.
impression속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
|
int 배열 | |
이 노출에 대해 지원되는 API 프레임워크입니다. |
| int 배열 | | 차단된 소재 속성 배열. 지원되는 값의 전체 목록은 OpenRTB 사양의 표 5.3을 참조하십시오. |
| int | | 비디오 플레이어의 높이(기기 독립성 픽셀)입니다. |
|
int | |
초 단위로 표시되는 최대 동영상 광고 기간 입니다. 이 값은 항상 |
| 문자열 배열 | | 지원되는 콘텐츠 MIME 타입( |
|
int | |
초 단위로 표시되는 최소 동영상 광고 기간입니다. 이 값은 항상 |
| int | | Unity 지원하는 동영상 플레이스먼트 유형은 다음과 같습니다.
|
| int | | 비디오 광고의 위치입니다. Unity Ads 인벤토리는 항상 전체 화면( |
| int 배열 | | 지원되는 비디오 프로토콜의 배열. 지원되는 값의 전체 목록은 OpenRTB 사양의 표 5.8을 참조하십시오. |
| int | | 비디오 플레이어의 너비(기기 독립성 픽셀)입니다. |
| int 배열 | | 지원되는 엔드카드 유형 배열(예: |
|
int | |
노출이 선형이어야 하는지 표시합니다. Unity Exchange의 경우 이 값은 항상 |
| int | | 동영상을 건너뛰을 수 있는지 여부를 나타냅니다.
Unity Exchange의 경우 이 값은 항상 |
| int | | 동일한 단가에 여러 광고 노출 수가 제공되는 경우 배열한 번호를 사용하면 여러 광고 소재를 조정적으로 게재할 수 있습니다. Unity Exchange의 경우 이 값은 항상 |
배너 객체
배너 광고 노출을 설명하는 오브젝트 클래스의 하위 집합입니다. 자세한 내용은 OpenRTB 사양의 섹션 3.2.6을 참조하십시오.
impression속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
|
int 배열 | |
퍼블리셔가 지원하는 배너 API 프레임워크 입니다. Unity는 MRAID 3.0( |
| int 배열 | | 배너 소재 속성의 배열. 지원되는 값의 전체 목록은 OpenRTB 사양의 표 5.3을 참조하십시오.
|
| 오브젝트 배열 | | 지원되는 배너 디스플레이 크기를 나타내는 오브젝트 배열. 배너 소재 형식 지원 크기:
소재 형식 지원 크기 표시:
|
| int | | 배너 디스플레이의 높이(기기 독립성 픽셀)입니다. |
| int | | 배너 디스플레이의 너비(기기 독립성 픽셀)입니다. |
pmp 오브젝트
노출과 관련될 수 있는 구매자와 판매자 간의 직접 거래를 위한 비공개 마켓플레이스 속성을 설명하는 오브젝트 클래스. 자세한 내용은 OpenRTB 사양의 섹션 3.2.11을 참조하십시오.
속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
| 오브젝트 배열 | 자세한 내용은 | 이 노출에 적용되는 특정 거래를 전달하는 |
| int | |
|
deal objects
구매자와 판매자 간에 이루어진 특정 거래를 설명하는 오브젝트 클래스. 해당 상태는 해당 거래 약관에 따라 노출을 사용할 수 있음을 나타냅니다. 자세한 내용은 OpenRTB 사양의 섹션 3.2.12을 참조하십시오.
속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
| 정수 | | 단가 요청의 경매 유형에 대한 선택적 오버라이드:
|
| 문자열 | | 직접 거래에 대한 고유 식별자입니다. |
app objects
광고 요청을 생성하는 앱을 설명하는 오브젝트 클래스. 자세한 내용은 OpenRTB 사양의 섹션 3.2.14을 참조하십시오.
속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
| 문자열 | Google 예시: Apple 예시: | Exchange 간에 고유한 애플리케이션 번들 또는 패키지 이름입니다.
|
| 문자열 | | 전환별 애플리케이션 ID입니다. |
| 문자열 | | 애플리케이션 이름입니다. |
| object | | 교환별 퍼블리셔 ID. |
| 문자열 | | 설치된 앱의 스토어 URL입니다(QAG 1.5 준수용). 이 속성 퍼블리셔 계약서에서 이를 금지하는 상황에서 전달되지 않을 수 있습니다. |
퍼블리셔 객체
광고 요청을 수행하는 퍼블리셔 설명하는 오브젝트 클래스. 자세한 내용은 OpenRTB 사양의 섹션 3.2.15을 참조하십시오.
속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
| 문자열 | | 교환별 퍼블리셔 ID입니다. |
기기 객체
최종 사용자 기기 설명하는 오브젝트 클래스. 자세한 내용은 OpenRTB 사양의 섹션 3.2.18을 참조하십시오.
속성 | 유형 | 예제 | 설명 |
|---|---|---|---|
| 정수 | | 네트워크 연결 유형입니다. 지원되는 값의 전체 목록은 OpenRTB 사양의 표 5.22를 참조하십시오. |
| int | | 일반적인 기기 타입입니다. 지원되는 값의 전체 목록은 OpenRTB 사양의 표 5.21를 참조하십시오. 휴대폰과 태블릿 간의 분리가 OpenRTB 버전 2.2에 도입되었습니다.
|
| object |
| 기기 위치 데이터(사용자 현재 위치로 간주됨):
|
| 문자열 | | 기기의 하드웨어 버전입니다. |
| 문자열 | | 광고주가 사용하도록 허용된 Android Advertising ID(AID) 또는 광고주용 iOS 식별자(IFA/IDFA)입니다. |
| 문자열 | | 기기 IP 주소입니다. |
| 문자열 | | ISO-639-1-alpha-2 코드를 사용하는 브라우저 언어입니다. |
| int | | 상업적으로 승인된 "광고 트래킹 제한" 신호입니다.
값이 |
| 문자열 | | 기기의 제조사입니다. |
| 문자열 | | 기기의 모델입니다. |
| 문자열 | | 기기의 운영체제입니다. |
| 문자열 | | 기기의 운영체제 버전입니다. |
| 문자열 | | 웹 브라우저 사용자 에이전트 문자열입니다. |
| 문자열 | | 기기의 서비스 제공업체. |
단가 요청 예제
VAST 입찰 요청
{ "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 }}
배너 단가 요청
{ "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 }}
플레이어블 단가 요청
{ "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": {} }
인터스티셜 광고 단가 요청
{ "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 }}