View a markdown version of this page

ORTB 필드 참조 - AWS Elemental MediaTailor
필드 범주app 객체device 객체imp (억제) 객체최상위 필드user 객체regs 객체다음 단계

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

ORTB 필드 참조

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

전체 OpenRTB 2.6 사양은 IAB OpenRTB 2.6 사양을 참조하세요.

필드 범주

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

app 객체

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 객체

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 (억제) 객체

템플릿은 배열에 정확히 하나의 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 선택 사항 확장 객체(패스스루).

프로토콜 열거형 참조

값 프로토콜
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+ 대스트

최상위 필드

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 객체

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 객체

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

다음 단계

  • copy-paste 템플릿은 섹션을 참조하세요템플릿 예제.

  • 채우기 속도 최대화에 대한 권장 사항은 섹션을 참조하세요모범 사례.