Vungle OpenRTB 2.3 통합 설명서

Vungle OpenRTB 2.3 통합 안내서 버전 2.1.0(2017년 8월)입니다. 여기서는 OpenRTB 2.3을 사용해서 Vungle Exchange를 통합하는 방법을 구체적으로 설명합니다.

목차

1. 요청 및 응답

1.1 엔티티

이 섹션의 엔티티는 모두 OpenRTB 2.3.1 사양의 하위 집합입니다. 필드나 요구 사항이 누락된 경우, 사양 자체에 대한 기본 요구 사항을 따르십시오.

1.2 확장

Vungle Exchange는 보다 좋은 광고를 제공하기 위해서 표준 OpenRTB 프로토콜 이상의 정보를 제공합니다. 이러한 확장은 기존 OpenRTB 구현과 겹치지 않으며, 오히려 기존 확장을 보완합니다. 가장 효과적인 개별 객체로 확장을 구분합니다.

모든 확장 필드는 OpenRTB 'ext' 객체의 'vungle'라는 첫 번째 확장 필드로 JSON 객체에 캡슐화됩니다. 이 문서의 후속 섹션에서는 'vungle' 필드를 생략했습니다. 다음은 Vungle 확장이 포함된 OpenRTB JSON 객체의 샘플입니다.

{
...
"ext": {
"vungle": {
// 아래 다양한 행의 개별 확장 필드.
}
}
}

예를 들어, 최상위 입찰 요청 객체는 다음과 같이 표시될 수 있습니다.

{
"id": "572c3535ab0af400011a721a",
"imp": [{<impression object>}],
"app": {<application object>},
"device": {<device object>},
"user": {<user object>},
"at": 2,
"tmax": 2000,
"cur": ["USD"],
"bcat": ["IAB7-3"],
"badv": ["google.com"],
"ext": {
"vungle": {
"badvid": ["2f00ca35ab0abe4df11da700c"]
}
}
}

1.3 버전 관리

일부 필드는 시간이 지남에 따라 무의미해지므로 Vungle Exchange는 최고의 호환성을 유지하기 위해 최신 Vungle OpenRTB 사양에서 지정된 "사용되지 않음" 필드를 준수합니다. "사용되지 않음" 필드는 모두 다음 사양 업데이트시 제거될 예정이며, 사용되지 않는 필드를 유지 관리해야 하는 Vungle Exchange의 책임도 이 시점에서 면제됩니다.

제거된 필드는 사양에 계속 남아 있을 것이며, 해당 필드가 지원되지 않음을 나타내는 "제거됨" 레이블이 부착됩니다. "제거됨" 레이블을 사용하여 의미 명세를 적용합니다. 모든 정의된 필드는 명세의 수명 동안 정의된 범위 내에서 고유합니다. 즉, 'id' 필드는 앞으로 사용되지 않을 것이며 특정 명세에서 제거됩니다. 또한, 향후 개정판에서 다른 의미로 부활하지도 않을 것입니다.

1.3.1 의미 버전 관리

명세 버전 역시 Semver 2.0.0 가이드라인에 따릅니다. 즉,

  • 주 버전 업데이트로 인해 이전 버전과의 호환성이 손상될 수 있습니다. 예를 들어, 버전 X에서 "사용되지 않음" 필드는 버전 X+1에서 "제거"됩니다.
  • 부 버전 업데이트는 이전 버전과의 호환성을 손상시키지 않아야 합니다. 예를 들면 사용 중인 필드는 "사용되지 않음"으로 표시됩니다. 또는 필수 필드는 필수가 아니며 사용되지 않는 필드로 표시됩니다.
  • 패치 버전 업데이트는 이전 버전과의 호환성을 손상시키지 않아야 합니다. 예를 들어, 명세 설명에서 오타를 수정합니다.

1. 요청

2.1 필수 및 선택 필드

다음 섹션의 필수 열에 대한 참고 사항:

  • 예: 이러한 필드의 하향 소비가 항상 지정된 형식을 기반으로, 포멧이 올바르고 비어 있지 않은 값을 기대할 수 있습니다.
  • 아니오: 하향 소비가 이러한 필드의 존재 또는 값의 유효성을 기대할 수 없습니다. 값에 대한 소비자 검증은 필수이며, 유형에 대한 검증은 필요하지 않습니다.
  • 기본값: OpenRTB 2.3.1에서 언급되지 않은 필드는 필요하지 않음으로 기본 설정되어 있습니다.

2.2 프로토콜 협상

Vungle Exchange는 프로토콜 협상을 통해 HTTP/2를 사용하는 통신을 지원하며, 그렇지 않은 경우 기본값은 HTTP/1.1입니다.

2.3 요청 헤더

각 입찰 요청에는 다음과 같이 OpenRTB 프로토콜에 지정된 맞춤 HTTP 헤더가 있습니다.

X-OpenRTB-Version: 2.3

Vungle Exchange는 사용자 지정 HTTP 헤더 외에도 다음과 같은 표준 헤더를 연결합니다.

Content-Type: application/json; charset=utf-8
Accept: application/json 

끝으로, Vungle Exchange는 Vungle OpenRTB 명세 버전을 나타내는 사용자 지정 헤더를 첨부합니다.

X-Vungle-OpenRTB-Version: 2

2.4 BidRequest 객체

필드 유형 필수 설명
id 문자열

Vungle Exchange에서 생성한 입찰 요청 ID입니다. 예: '570b0eb14e67c98f761a0ca0'.

imp

객체 배열

노출 객체를 참조하십시오.
app 객체 애플리케이션 객체를 참조하십시오.
device 객체 장치 객체를 참조하십시오.
at 정수

경매 유형입니다. 예: 2차 가격 경매의 경우 '2' Vungle Exchange는 2차 가격 경매만 실행하므로 이 값은 항상 '2'입니다.

tmax 정수

전체 입찰 응답을 제출할 수 있는 시간(밀리 초)입니다. 이 값은 항상 '250'입니다.

cur 문자열 배열 아니오

ISO-4217-alpha 경매에 사용할 수 있는 통화 목록입니다. 예: ["USD", "CNY", "EUR"]. 현재는 "USD"만 지원됩니다.

bcat 문자열 배열 아니오 OpenRTB 2.3.1 섹션 5.1을 참조하십시오.
regs 객체 아니오 OpenRTB 2.3.1 섹션 3.2.16을 참조하십시오.
test 정수 아니오

경매가 테스트 모드(1)건 실시간 모드(0)건, 테스트 경매에는 입찰할 수 없습니다.

2.4.1 노출 객체

필드 유형 필수 설명
id 문자열 Vungle Exchange에서 생성한 노출 ID입니다. 예: '3a06eb14e67c98f761add01'.
displaymanager 문자열 공급측 디스플레이 관리자. Vungle은 SDK 모바일 플랫폼을 구분하므로 어떤 SDK 기술이 사용되었는지 이 필드에서 지정합니다. 예를 들어 Windows의 경우 'Vungle' for iOS, 'VungleDroid' for Android, and 'VungleWindows', 다음 필드에는 SDK 버전이 들어갑니다.
displaymanagerserver 문자열 공급측 디스플레이 매니저 버전. Vungle은 이 기능을 사용하여 SDK 버전을 지정합니다. 예: '3.3.1'
bidfloor float 적격한 입찰로 인정받을 수 있는 최소 입찰 가격입니다. 예: '8.72'.
bidfloorcur 문자열 ISO-4217-alpha의 노출에 사용할 수 있는 통화 목록입니다. 예: 'USD'.
video 객체 아니오 비디오 객체를 참조하십시오.
tagid 문자열 아니오 지정된 노출에 대한 광고위치 참조 ID입니다. 예: 'placement_name_1af44fda'.
instl 정수 아니오 노출이 전체 화면/삽입 광고(1)인지 또는 아닌지 (0)를 나타냅니다. 현재 Vungle Exchange는 전체 화면/삽입 광고(1)만 지원합니다.
secure 정수 아니오 노출에 대한 보안 HTTPS URL 광고 소재 자산 및 마크업 필요 여부를 나타내는 플래그입니다. 0=비보안, 1=보안.
ext 객체 아니오 Vungle에서는 항상 보안(1) 자산 및 마크업을 사용해야 합니다.

2.4.2 비디오 객체

필드 유형 필수 설명
mimes 문자열 배열 지원되는 MIME 유형입니다. Vungle Exchange는 ["video/mp4"] 만을 지원합니다.
h 정수 비디오의 높이입니다.
w 정수 비디오의 폭입니다.
minduration 정수 아니오 비디오가 재생되어야 하는 최소 시간(초)입니다.
maxduration 정수 아니오 비디오가 재생될 수 있는 최대 시간(초)입니다.
delivery 정수 배열 아니오 지원되는 비디오 전송 방법 목록(프로그레시브 또는 스트리밍)입니다. OpenRTB 2.3.1 섹션 5.13을 참조하십시오.
minbitrate 정수 아니오 최소 전송속도(kbps)입니다. Vungle Exchange는 현재 250만 지원합니다.
maxbitrate 정수 아니오 최대 입찰 속도(kbps)입니다. 예: 500
protocols 정수 배열 아니오 OpenRTB 2.3.1 섹션 5.8을 참조하십시오. 예: [2, 5].
boxingallowed 정수 아니오 비디오 박싱을 사용할 수 있는 경우 (1), 그렇지 않은 경우 (0). 이 값은 항상 '1'입니다.
playbackmethod 정수 배열 아니오 OpenRTB 2.3.1 섹션 5.9를 참조하십시오.
startdelay 정수 아니오 OpenRTB 2.3.1 섹션 5.10을 참조하십시오. 이 값은 항상 '0'입니다.

2.4.3 애플리케이션 객체

필드 유형 필수 설명
id 문자열 Exchange 관련 ID. Vungle의 경우 앱 스토어 ID입니다. 예: '3709293'.
이 ID는 DSP와는 아무 관련이 없지만, DSP가 보고 분쟁을 비교하고 조정할 때 사용할 수 있습니다.
bundle 문자열 고유 마켓 ID는 앱마다 고유하고, Vungle Exchange와는 별개로 사용되는 플랫폼별 애플리케이션 식별자입니다.
- Android에서는 번들 또는 패키지 이름(예: 'com.supercell.hayday')이어야 합니다.
- iOS에서는 숫자 ID입니다.
publisher 객체 퍼블리셔 객체를 참조하십시오.
name 문자열 아니오 애플리케이션 이름입니다. 예: 'Hay Day'.
storeurl 문자열 아니오 앱 스토어 URL입니다. 예: 'https://itunes.apple.com/us/app/hay-day/id506627515?mt=8#'.
cat 문자열 배열 아니오 OpenRTB 2.3.1 섹션 5.1을 참조하십시오.
privacypolicy 정수 아니오 애플리케이션에 개인정보 보호정책이 있는 경우 (1), 없는 경우 (0). Vungle Exchange는 이 필드에서 '1' 만을 지원합니다.
paid 정수 아니오 애플리케이션이 유료인 경우 (1), 그렇지 않은 경우 (0).
keywords 문자열 아니오 쉼표로 구분된 퍼블리셔 애플리케이션용 태그 목록입니다.
ext 객체 아니오 설명

2.4.4 애플리케이션 확장

필드 유형 필수 설명
altid 문자열 아니오 퍼블리셔 애플리케이션을 고유하게 식별하는 부차적인 Vungle Exchange 고유 ID입니다. 예: '3a06eb14e67c98f761add01'.
sdk 객체 아니오 SDK 확장 객체를 참조하십시오.
wtags 문자열 배열 아니오 퍼블리셔 애플리케이션 태그 화이트리스트입니다.
btags 문자열 배열 아니오 퍼블리셔 애플리케이션 태그 블랙리스트입니다.
bundleid 문자열 아니오 애플리케이션 번들 식별자 또는 패키지 이름입니다.
tags 문자열 배열 아니오 사용하지 않음. 키워드를 사용하십시오.

2.4.5 SDK 확장

필드 유형 필수 설명
name 문자열 호스트 애플리케이션에 설치된 SDK 에이전트의 SDK 제품군을 식별하는 문자열입니다. 예: 'VungleDroid', 'Vungle', or 'VungleWindows'.
ver 문자열 호스트 애플리케이션에 설치된 SDK 에이전트의 버전을 설명하는 문자열입니다.
plugin 문자열 아니오 SDK 에이전트가 빌드된 SDK 플러그인 이름입니다. 예: 'native', 'unity'.
pluginver 문자열 아니오 SDK 에이전트가 빌드된 SDK 플러그인 버전입니다. 예: '1.0'.

2.4.6 퍼블리셔 객체

필드 유형 필수 설명
id 문자열 Vungle Exchange에서 생성한 퍼블리셔 ID입니다. 예: '570ffeb14e67998f761a791c'.
name 문자열 아니오 퍼블리셔 이름입니다. 예: 'Supercell Oy'.
cat 문자열 배열 아니오 OpenRTB 2.3.1 섹션 5.1을 참조하십시오.

2.4.7 장치 객체

필드 유형 필수 설명
ua 문자열 장치의 브라우저 사용자 문자열입니다. 예: 'Mozilla/5.0 (iPhone; CPU iPhone OS 9_1 like Mac OS X) AppleWebKit/601.1.46 (KHTML, like Gecko) Version/9.0 Mobile/13B143 Safari/601.1'.
ip 문자열 ipv6 필드가 있는 경우에는 필요하지 않습니다. 노출의 IP 주소입니다. 예: '212.14.27.104'.
ipv6 문자열 ip 필드가 있는 경우에는 필요하지 않습니다. 노출의 IPv6 주소입니다. 예: '3ffe:1900:4545:3:200:f8ff:fe21:67cf'.
h 정수 장치 화면 높이(픽셀).
w 정수 장치 화면 폭(픽셀).
connectiontype 문자열 OpenRTB 2.3.1 섹션 5.18을 참조하십시오.
ifa 문자열 광고주가 일반 텍스트로 사용할 수 있는 ID입니다. 예: 'e4fe9bdecaa047b6908dffba3fa184f2'.
geo 객체 아니오 지역 객체를 참조하십시오.
make 문자열 아니오 장치 제조사입니다.
model 문자열 아니오 장치 모델입니다.
os 문자열 아니오 장치의 운영 체제입니다. 예: 'iOS', 'Android'. 열거형 값:
- 'iOS'
- 'Android'
- 'Windows'
osv 문자열 아니오 장치의 운영 체제 버전입니다. 예: '9.1', '8.0'.
dnt 정수 아니오 장치가 "위치 추적 금지"를 활성화한 경우 (1), 그렇지 않은 경우 (0).
lmt 정수 아니오 장치가 "광고 추적 제한"을 활성화한 경우 (1), 그렇지 않은 경우 (0).
devicetype 문자열 아니오 OpenRTB 2.3.1 섹션 5.17을 참조하십시오.
language 문자열 아니오 SO-639-1-alpha-2의 장치 언어입니다. 예: 'en'.
carrier 문자열 아니오 이동통신사 또는 ISP입니다. 예: 'VERIZON'.
ext 객체 아니오 장치 확장 객체를 참조하십시오.

2.4.8 장치 확장

필드 유형 필수 설명
tz 문자열 아니오 장치의 시간대 설정은 IANA 표준 시간대 데이터베이스에서 영역 이름으로 지정됩니다. 예: 'America/Los_Angeles'.
vungleua 문자열 아니오 사용하지 않음: Application.ext.vungle.sdk 사용
sdcard 정수 아니오 Android 장치에서 SD 카드 저장장치를 사용할 수 있는 경우 (1), 사용하지 않는 경우 (0).
volume float 아니오 장치 볼륨을 백분율로 나타내는 0과 1 사이의 값입니다.
muted 정수 아니오 0=false 1=true. 열거가 필요합니다.
idfv 문자열 아니오

iOS 장치 공급업체의 ID입니다. 앱 공급업체가 기기를 고유하게 식별할 수 있는 영숫자 문자열입니다. 예: '00000000-0001-4d3a-8f98-233623cd8d12'.

입찰 요청의 앱이 다른 공급업체에 속하는 경우에는 동일한 장치에서 다른 IDFV 값을 포함할 수 있습니다.

marketplace 문자열 아니오

장치에 설치된 앱 마켓플레이스입니다. 가능한 값은 다음과 같습니다.

  • 'google'
  • 'apple'
  • 'amazon'
is_sideload_enabled 정수 아니오 장치에서 소스를 "알 수 없는" 앱 설치 허용 여부를 나타내는 부울 플래그입니다. '1'(true)인 경우 알 수 없는 마켓플레이스의 앱을 사용할 수 있습니다. '0'(false)인 경우에는 사용할 수 없습니다.

2.4.9 지역 객체

필드 유형 필수 설명
country 문자열 ISO-3166-1-alpha-3의 국가 코드입니다. 예: 'USA'.
lat float 아니오 장치의 위도입니다. 예: '[-90, 90]'.
long float 아니오 장치의 경도입니다. 예: '[-180, 180]'.
type 정수 아니오 OpenRTB 2.3.1 섹션 5.16을 참조하십시오.
region 문자열 아니오 ISO-3166-2의 지역 코드, 미국의 경우 2자리 국가 코드입니다. 예: 'CA'.
city 문자열 아니오 도시 이름(자유 형식)입니다.
zip 문자열 아니오 우편번호입니다.
utcoffset 정수 아니오 UTC 기준 +/- 분으로 나타낸 현지 시간입니다.

2.4.10 규정 객체

필드 유형 필수 설명
coppa 정수 아니오 미국 FTC가 제정한 COPPA 규정이 해당 요청에 적용되는지를 나타내는 플래그입니다. 0=아니오, 1=예입니다.
ext 객체 아니오 Vungle Exchange 고유의 OpenRTB 확장용 플레이스 홀더입니다.

2.4.11 PMP 객체

필드 유형 필수 설명
private_auction 정수 아니오 직거래 대상으로 지정된 경매 참가 자격 표시입니다. 0 = 모든 입찰가 수락, 1 = 지정된 거래 및 해당 거래 조건으로 입찰가 제한.
deal 객체 배열 아니오 해당 노출에 적용 가능한 특정 거래를 전달해주는 거래 배열(섹션 3.2.18) 객체입니다.
ext 객체 아니오 Vungle Exchange 고유의 OpenRTB 확장용 플레이스 홀더입니다.

3. 응답

3.1 필수 및 선택 필드

응답 섹션의 필수 열에 대한 참고 사항:

  • 예: Vungle Exchange는 필수 필드가 항상 지정되어 있고, 비어 있지 않으며, 유형이 지정된 포멧이어야 한다고 가정합니다. 잘못된 값은 경매에 부적격할 수 있습니다.
  • 권장사항: 필드의 값이 지정된 대로 포멧되면 Vungle Exchange가 필드를 사용해서 경매 프로세스를 지원합니다. 누락되었거나 잘못된 필드가 경매 참여 자격에 부정적인 영향을 주지 않습니다.
  • 아니오: Vungle Exchange에 필드가 반드시 존재하지 않아도 됩니다.
  • 기본값: OpenRTB 2.3.1에서 언급되지 않은 필드는 'No'가 기본 요구 사항입니다. 또한, 모든 필드는 지정된 유형과 일치해야 합니다. 그렇지 않으면 입찰 자격에 부정적인 영향이 생길 수 있습니다.

3.2 응답 헤더

응답 헤더에는 "Content-Type" 헤더 및 위의 요청 헤더에서 허용되는 값 중 하나가 있어야 합니다. 예를 들어,

Content-Type: application/json 

3.3 응답 상태 코드

모든 응답은 200 또는 204 둘 중 하나여야 합니다. 다른 HTTP 응답 코드는 DSP의 경매 자격에 부정적인 영향을 줄 수 있습니다.

3.4 무입찰 이유 신호

DSP는 입찰하지 않기로 결정한 경우, 입찰하지 않은 이유를 보내야 합니다. Vungle Exchange가 통합과 관련된 잠재적 문제를 감지하고 해결하는 데 이 정보가 유용하게 사용될 수 있습니다. 무입찰 신호는 OpenRTB 2.3.1 섹션 7.4 사양에 따라야 합니다. 무입찰 이유를 포함한 무입찰 신호를 바르게 생성한 경우 다음과 같이 표시됩니다.


{"id": "1234567890", "seatbid": [], "nbr": 2}

3.5 BidResponse 객체

필드 유형 필수 설명
id 문자열 Vungle Exchange에서 생성한 BidRequest ID입니다. 예: '570ffeb14e67998f761a791c'. 이 값은 BidRequest 객체의 ID와 반드시 일치해야 합니다.
bidid 문자열 아니오 로깅/추적을 지원하는 고유한 입찰자 생성 응답 ID입니다.
cur 문자열 아니오 ISO-4217 alpha 코드를 사용한 입찰 통화입니다. 현재 Vungle Exchange는 USD만 지원하며, 모든 금액을 USD로 취급합니다.
seatbid 객체 배열 seatbid 객체 배열입니다. 입찰이 이루어지려면 1+가 필요합니다.
nbr 정수 아니오 OpenRTB 2.3.1 사양의 5.19에 나열된 무입찰 이유입니다.
ext 객체 아니오  

3.5.1 SeatBid 객체

필드 유형 필수 설명
seat 문자열 아니오 해당 입찰이 이루어진 입찰자 좌석의 ID입니다. OpenRTB 2.3.1을 참조하십시오.
bid 객체 배열 입찰 객체를 참조하십시오. 입찰이 한 개 이상 있어야 합니다.


3.5.2 Bid 객체

필드 유형 필수 설명
id 문자열 개별 DSP가 생성한 입찰 ID입니다.
impid 문자열 입찰 요청의 노출과 관련된 노출 ID입니다. 입찰 요청 노출 객체 ID와 반드시 일치해야 합니다.
price float CPM 단위로 표시된 입찰가입니다. 예: '10.30'.
nurl 문자열 아니오 입찰이 낙찰되었을 때 Vungle Exchange에서 호출하는 Win 통지 URL입니다.
adm 문자열 경매에 낙찰된 후 게재할 광고 마크업입니다. 광고 마크업 사양 섹션을 참조하십시오.
cid 문자열 권장 사항 DSP가 프록시한 캠페인 ID입니다.
crid 문자열 권장 사항 DSP가 프록시한 광고소재 ID입니다.
adomain 문자열 배열 권장 사항 블랙리스트를 검사하는 광고주 도메인입니다. 예: ["supercell.com"].
bundle 문자열 권장 사항 고유 마켓 ID는 앱마다 고유하고, Vungle Exchange와는 별개로 사용되는 플랫폼별 애플리케이션 식별자입니다.
- Android에서는 번들 또는 패키지 이름(예: 'com.supercell.hayday')이어야 합니다.
- iOS에서는 숫자 ID입니다.
h 정수 권장 사항 광고소재의 높이입니다.
w 정수 권장 사항 광고소재의 폭입니다.
cat 문자열 배열 아니오 IAB 콘텐츠 카테고리입니다. OpenRTB 2.3.1 섹션 5.1을 참조하십시오.
iurl 문자열 아니오 분실 알림 URL입니다.
dealid 문자열 아니오 해당 입찰이 비공개 마켓플레이스 직거래와 관련되어 있는 경우, BidRequest 객체에서 deal.id를 참조하십시오.
adid 문자열 아니오 경매에서 낙찰받을 경우 게재할 사전로드 광고의 ID입니다.
ext 객체 아니오  

4. 예

4.1 요청 예


{
    "id": "58ed309efa8936087efd1349",
    "imp": [{
        "id": "58ed309efa8936087efd134a",
        "video": {
            "mimes": ["video/mp4"],
            "minduration": 5,
            "maxduration": 30,
            "protocols": [2, 5],
            "w": 1080,
            "h": 1920,
            "startdelay": 0,
            "linearity": 1,
            "minbitrate": 250,
            "maxbitrate": 2500,
            "boxingallowed": 1,
            "playbackmethod": [1, 2, 3, 4],
            "delivery": [1, 2],
            "pos": 7
        },
        "displaymanager": "Vungle",
        "displaymanagerver": "3.3.5",
        "instl": 1,
        "bidfloor": 15,
        "bidfloorcur": "USD"
    }],
    "app": {
        "id": "56b8e577819502560b000033",
        "name": "test-pub-app-name",
        "bundle": "1045826890",
        "storeurl": "https://itunes.apple.com/us/app/id1234567?mt=8",
        "cat": [
            "IAB1"
        ],
        "privacypolicy": 1,
        "publisher": {
            "id": "test-pub-app-id",
            "name": "test-pub-app-name",
            "cat": [
                "IAB1"
            ]
        },
        "ext": {
            "vungle": {
                "altid": "5fff577819502560b000033",
                "btags": ["real money gambling", "social casino"],
                "wtags": ["targeted tag", "social"]
            }
        }
    },
    "device": {
        "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 8_4 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Mobile/12H141",
        "geo": {
            "lat": 47.46,
            "lon": -122.16,
            "type": 1,
            "country": "USA",
            "region": "WA",
            "city": "San Francisco",
            "zip": "94103"
        },
        "dnt": 0,
        "lmt": 0,
        "ip": "192.168.1.1",
        "devicetype": 1,
        "make": "Samsung",
        "model": "SM-J200G",
        "connectiontype": 2,
        "os": "iOS",
        "osv": "8.0",
        "w": 1080,
        "h": 1920,
        "js": 1,
        "language": "en",
        "ifa": "test-ifa",
        "ext": {
            "vungle": {
                "isSdCardAvailable": 1,
                "vungleua": "VungleDroid/3.3.5",
                "tz": "Europe/Kaliningrad",
                "sdcard": 1,
                "volume": 0.13333334,
                "muted": 1
            }
        }
    },
    "bcat": ["IAB7-3", "IAB7-5", "IAB7-28", "IAB7-29", "IAB7-30", "IAB7-39", "IAB7-41", "IAB7-42"],
    "at": 2,
    "cur": ["USD"],
    "tmax": 250
}

4.2 응답 예


{
  "id": "58ed309efa8936087efd1349",
  "bidid": "5508",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "7735",
      "bid": [
        {
          "id": "5508",
          "impid": "58ed309efa8936087efd134a",
          "price": 50,
          "nurl": "http://bidder.com/won?price=${AUCTION_PRICE}",
          "adm": "http://bidder.com/vast?id=${AUCTION_ID}",
          "cid": "554d550b418461cc3700014d",
          "crid": "57767c29a63510e75f000073"
        }
      ]
    }
  ]
}

5. 광고 마크업 사양

Vungle Exchange는 기본적으로 VAST, MRAID 및 독점적 Vungle Ad Markup 등 세 가지 유형의 마크업을 지원합니다. 각각의 상위 레벨 사양이 성능상 유효한 마크업으로 간주되려면 아래의 추가 요구 사항을 준수해야 합니다.

5.1 VAST

'adm' 필드의 첫 번째 100바이트 또는 'nurl' 응답의 페이로드에 다음 태그가 반드시 표시되어야 합니다.

<VAST version="2.0">

5.2 매크로 대체

Vungle Exchange는 입찰 응답 내의 입찰 객체에서 nurl 필드에 있는 경매가격 매크로 대체를 지원합니다. 예:


"nurl": "http://bidder.com/won?price=${AUCTION_PRICE}"
또 다른 질문이 있으십니까? 문의 등록

댓글