기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# ORTB 필드 참조
<a name="yield-optimization-ortb-reference"></a>

이 페이지는 OpenRTB 입찰 요청의 모든 필드에 대한 전체 참조입니다. 필드는 MediaTailor가 필드를 처리하는 방법과 APS가 최적의 광고 채우기를 위해 필드를 필요로 하는지 또는 추천하는지에 따라 분류됩니다.

전체 OpenRTB 2.6 사양은 [IAB OpenRTB 2.6 사양을](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md) 참조하세요.

## 필드 범주
<a name="yield-optimization-ortb-reference-categories"></a>


| 카테고리 | 의미 | 작업 | 
| --- | --- | --- | 
| 필수 | 템플릿에 있어야 합니다. MediaTailor가 없으면 오류가 발생합니다. | 이를 제공해야 합니다. | 
| EMT에서 하드코딩 | MediaTailor는 항상 콘솔 구성 또는 현재 가용 컨텍스트의 값을 사용하여 이러한 값을 설정합니다. 템플릿 값이 재정의됩니다. | 템플릿에서 이를 설정하지 마십시오. | 
| APS 권장 | MediaTailor에서 반드시 필요한 것은 아니지만 APS는 더 나은 광고 채우기 및 타겟팅을 위해 이를 권장합니다. 권장 필드가 누락되면 채우기 속도가 낮거나 입찰 없는 응답이 발생할 수 있습니다. | 강력히 권장됩니다. | 
| 선택 사항 | 입찰 요청을 제공하는 경우에만 입찰 요청에 포함됩니다. 기본값이 없습니다. | 사용 사례와 관련된 경우를 제공합니다. | 

## `app` 객체
<a name="yield-optimization-ortb-reference-app"></a>


| Field | 카테고리 | 참고 | 
| --- | --- | --- | 
| app | 필수 | app 객체는 템플릿에 있어야 합니다. | 
| app.bundle | 필수 | 앱의 번들 ID(예: G15147002586). 비어 있으면 안 됩니다. | 
| app.storeurl | 필수 | 앱 스토어 URL(예: https://apps.apple.com/us/app/yourapp/id123). | 
| app.publisher.id | EMT에서 하드코딩 | 콘솔 구성PublisherId에서 항상를 로 설정합니다. | 
| app.content | 필수(객체) | 이를 생략하면 MediaTailor가 빈 Content 객체를 전송합니다. 더 나은 타겟팅을 위해 콘텐츠 메타데이터를 제공합니다. | 
| app.name | APS 권장 | 식별을 위한 앱 이름입니다. | 
| app.id | APS 권장 | APS의 앱 식별자입니다. | 
| app.domain | APS 권장 | 앱 도메인. | 
| app.content.genre | APS 권장 | 콘텐츠 장르(예: , "Sport""News"). | 
| app.content.contentrating | APS 권장 | 콘텐츠 등급(예: , "TV-G""TV-14"). | 
| app.content.language | APS 권장 | 콘텐츠 언어(ISO-639-1). | 
| app.content.id | APS 권장 | 콘텐츠 식별자입니다. | 
| app.content.title | APS 권장 | 콘텐츠 제목. | 
| app.content.episode | APS 권장 | 에피소드 번호입니다. | 
| app.content.len | APS 권장 | 초 단위의 콘텐츠 길이입니다. | 
| app.cat | 선택 사항 | 콘텐츠 범주(IAB 분류). | 
| app.sectioncat | 선택 사항 | 섹션 범주. | 
| app.pagecat | 선택 사항 | 페이지 범주. | 
| app.ver | 선택 사항 | 앱 버전. | 
| app.privacypolicy | 선택 사항 | 1 = 개인 정보 보호 정책이 있습니다. | 
| app.paid | 선택 사항 | 1 = 유료 앱. | 
| app.keywords | 선택 사항 | 쉼표로 구분된 키워드입니다. | 
| app.kwarray | 선택 사항 | 키워드를 배열로 사용합니다. | 
| app.inventorypartnerdomain | 선택 사항 | 인벤토리 파트너 도메인. | 
| app.ext | 선택 사항 | 확장 객체(패스스루). | 

## `device` 객체
<a name="yield-optimization-ortb-reference-device"></a>


| Field | 카테고리 | 참고 | 
| --- | --- | --- | 
| device | 필수 | device 객체는 템플릿에 있어야 합니다. | 
| device.ua | 필수 | 사용자 에이전트 문자열입니다. 비어 있으면 안 됩니다. {{session.user\_agent}}를 사용합니다. | 
| device.ip | 필수 | IPv4 주소입니다. 비어 있으면 안 됩니다. {{session.client\_ip}}를 사용합니다. | 
| device.lmt | 선택 사항(기본값: 0) | 광고 추적 제한 플래그. 0 = 추적 허용됨, 1 = 추적 제한. 템플릿에 제공되지 않은 경우 기본값은 입니다0. | 
| device.devicetype | EMT로 하드코딩(기본값: 3) | 제공되지 않은 경우 MediaTailor 세트3(연결된 TV)입니다. 값이 있는 경우 사용됩니다. | 
| device.make | APS 권장 | 디바이스 제조업체(예: , "Samsung""Apple"). | 
| device.model | APS 권장 | 디바이스 모델(예: , "Tizen TV""iPhone"). | 
| device.os | APS 권장 | 운영 체제(예: , "Tizen""iOS"). | 
| device.osv | APS 권장 | OS 버전. | 
| device.h | APS 권장 | 픽셀 단위의 화면 높이입니다. | 
| device.w | APS 권장 | 픽셀 단위의 화면 너비입니다. | 
| device.language | APS 권장 | 디바이스 언어(ISO-639-1). | 
| device.ifa | APS 권장 | 디바이스 광고 ID입니다. 모든 디바이스에 하나(예: 웹 브라우저)가 있는 것은 아닙니다. | 
| device.dnt | APS 권장 | 추적 안 함 플래그. | 
| device.geo | 선택 사항 | country, lat,가 있는 Geo 객체입니다lon. | 
| device.sua | 선택 사항 | 구조화된 사용자 에이전트(UA-CH). | 
| device.ipv6 | 선택 사항 | IPv6 주소입니다. | 
| device.hwv | 선택 사항 | 하드웨어 버전. | 
| device.connectiontype | 선택 사항 | 연결 유형(WiFi, 셀룰러 등). | 
| device.carrier | 선택 사항 | 통신 사업자 이름입니다. | 
| device.mccmnc | 선택 사항 | 모바일 국가/네트워크 코드. | 
| device.ext | 선택 사항 | 확장 객체(패스스루). | 

## `imp` (억제) 객체
<a name="yield-optimization-ortb-reference-imp"></a>

템플릿은 배열에 정확히 **하나의** `imp` 객체를 포함해야 합니다.


| Field | 카테고리 | 참고 | 
| --- | --- | --- | 
| imp[0].video | 필수 | video 객체가 있어야 합니다. | 
| imp[0].video.mimes | 필수 | 지원되는 MIME 유형(예: ["video/mp4"]). | 
| imp[0].video.protocols | 선택 사항 | 지원되는 VAST 프로토콜. 생략하면 MediaTailor는 하드 코딩된 폴백를 사용합니다[1, 2, 3, 4, 5, 6, 7, 8]. 아래 프로토콜 열거형 참조를 참조하세요. | 
| imp[0].video.minduration | EMT에서 하드코딩 | 콘솔MinimumUnfilledDuration에서를 로 설정합니다. | 
| imp[0].video.maxduration | EMT에서 하드코딩 | 를 실제 채워지지 않은 기간(초)으로 설정합니다. | 
| imp[0].video.maxseq | EMT에서 하드코딩 | 계산된 값: floor(unfilled\_duration / 6). APS는 maxseq 또는를 사용하여 여러 광고를 반환poddur할 것을 권장합니다. | 
| imp[0].video.poddur | EMT에서 하드코딩 | 채우지 않은 기간(초)으로 설정합니다. | 
| imp[0].video.startdelay | 선택 사항 | 시작 지연. 0 = 프리롤, -1 = 일반 미드롤, -2 = 포스트롤, > 0 = 초 단위 미드롤 오프셋. 라이브 미드롤 브레이크-1에 사용합니다. 하드 코딩된 대체: 6. | 
| imp[0].video.w | APS 권장 | 픽셀 단위의 비디오 너비입니다. | 
| imp[0].video.h | APS 권장 | 픽셀 단위의 비디오 높이입니다. | 
| imp[0].video.plcmt | APS 권장 | 배치 유형(1 = 인스트림). | 
| imp[0].video.podid | APS 권장 | 포드 식별자입니다. | 
| imp[0].video.slotinpod | APS 권장 | 포드의 슬롯 위치입니다. | 
| imp[0].video.ext.slotId | 선택 사항(기본값: "default\_slot\_id") | APS 콘솔의 APS 슬롯 ID입니다. 기본값은 작동하지만 실제 슬롯 ID를 제공하면 APS가 슬롯별 대상 지정 및 최저 요금을 적용할 수 있습니다. | 
| imp[0].bidfloor | 선택 사항(기본값: 1.0) | CPM의 최소 입찰 가격입니다. | 
| imp[0].secure | 선택 사항(기본값: 1) | 1 = HTTPS 크리에이티브 URLs 필요합니다. | 
| imp[0].id | 선택 사항 | 노출 ID. 제공되지 않은 경우 자동 생성됩니다. | 
| imp[0].tagid | 선택 사항 | 태그/배치 ID. | 
| imp[0].bidfloorcur | 선택 사항 | 입찰 기준 통화(기본 USD). | 
| imp[0].ssai | 선택 사항 | SSAI 표시기입니다. | 
| imp[0].exp | 선택 사항 | 노출의 만료 시간입니다. | 
| imp[0].rqddurs | 선택 사항 | 요청된 기간 배열입니다. | 
| imp[0].mincpmpersec | 선택 사항 | 초당 최소 CPM입니다. | 
| imp[0].pmp | 선택 사항 | 프라이빗 마켓플레이스 객체. | 
| imp[0].ext | 선택 사항 | 확장 객체(패스스루). | 

### 프로토콜 열거형 참조
<a name="yield-optimization-ortb-reference-protocol-enum"></a>


| 값 | 프로토콜 | 
| --- | --- | 
| 1 | VAST 1.0 | 
| 2 | VAST 2.0 | 
| 3 | VAST 3.0 | 
| 4 | VAST 1.0 래퍼 | 
| 5 | VAST 2.0 래퍼 | 
| 6 | VAST 3.0 래퍼 | 
| 7 | VAST 4.0 | 
| 8 | VAST 4.0 래퍼 | 
| 9\+ | 대스트 | 

## 최상위 필드
<a name="yield-optimization-ortb-reference-top-level"></a>


| Field | 카테고리 | 참고 | 
| --- | --- | --- | 
| id | EMT에서 하드코딩 | 자동 생성: {sessionId}\_{availId} 형식(예: abc123-def456\_78901). 입찰 요청을 세션 로그와 상호 연관시키는 데 유용합니다. | 
| cur | 선택 사항(기본값: ["USD"]) | 허용된 통화입니다. | 
| ext.integrationType | EMT에서 하드코딩 | 항상를 로 설정합니다"EMT". | 
| bcat | 선택 사항 | 차단된 광고 범주(IAB 분류). 템플릿 값은 그대로 APS로 전송됩니다. | 
| badv | 선택 사항 | 차단된 광고주 도메인. | 
| bapp | 선택 사항 | 차단된 앱 번들 IDs. | 
| test | 선택 사항 | 테스트 모드 플래그입니다. | 
| at | 선택 사항 | 경매 유형. | 
| tmax | 선택 사항 | 입찰 응답을 기다리는 최대 시간(ms)입니다. | 
| wseat | 선택 사항 | 허용된 구매자 좌석. | 
| bseat | 선택 사항 | 구매자 좌석이 차단되었습니다. | 
| wlang | 선택 사항 | 허용된 크리에이티브 언어입니다. | 
| source | 선택 사항 | 공급망의 소스 객체입니다. | 
| ext | 선택 사항 | 사용자 지정 확장 필드는 EMT의와 병합됩니다integrationType. | 

## `user` 객체
<a name="yield-optimization-ortb-reference-user"></a>


| Field | 카테고리 | 참고 | 
| --- | --- | --- | 
| user | APS 권장(EU) | GDPR 동의가 있는 EU 트래픽에 필요합니다. | 
| user.consent | APS 권장(EU) | GDPR 동의 문자열(TCF). | 
| user.id | 선택 사항 | 사용자 ID입니다. | 
| user.buyeruid | 선택 사항 | 구매자별 사용자 ID입니다. | 
| user.eids | 선택 사항 | 확장 식별자(LiveRamp, UID2 등). | 
| user.data | 선택 사항 | 사용자 데이터 세그먼트. | 
| user.ext | 선택 사항 | 확장 객체. | 

## `regs` 객체
<a name="yield-optimization-ortb-reference-regs"></a>


| Field | 카테고리 | 참고 | 
| --- | --- | --- | 
| regs | APS 권장 | 규정 준수를 위해를 포함합니다. | 
| regs.coppa | APS 권장(미국) | COPPA 플래그(1 = 하위 대상). | 
| regs.us\_privacy | APS 권장(미국) | 미국 개인 정보 보호/CCPA 문자열입니다. | 
| regs.gdpr | APS 권장(EU) | GDPR이 적용됩니다(1 = 예). | 
| regs.gpp | APS 권장 | 글로벌 프라이버시 플랫폼 문자열입니다. us\_privacy 미국 시청자보다 선호되므로 채우기 속도가 향상됩니다. [모범 사례](yield-optimization-best-practices.md)을(를) 참조하세요. | 
| regs.gpp\_sid | APS 권장 | GPP 섹션 IDs(예: 미국 국적[7]의 경우). gpp가 있는 경우 필요합니다. | 
| regs.ext | 선택 사항 | 확장 객체. | 

## 다음 단계
<a name="yield-optimization-ortb-reference-next-steps"></a>
+ copy-paste 템플릿은 섹션을 참조하세요[템플릿 예제](yield-optimization-examples.md).
+ 채우기 속도 최대화에 대한 권장 사항은 섹션을 참조하세요[모범 사례](yield-optimization-best-practices.md).