본문으로 건너뛰기

SDK 전역 설정

1. SDK 전역 설정 방법

gfpInstream.setGlobalConfig()를 사용하여 SDK 전역 파라미터를 설정할 수 있습니다.

2. SDK 전역 설정 속성

모든 SDK 전역 설정 속성은 optional 입니다.

requestTimeout

광고 요청 타임아웃 시간(ms) (number, default: 60000)

language

인스트림 광고에 적용할 언어

ko(한국어) | en(영어) | zh-tw(대만, 번체) | zh-hk(홍콩, 번체) | th(태국어) | es(스페인어) | id(인도네시아어) | fr(프랑스어) | ja(일본어) | zh-cn(중국어, 간체) | (default: en).

appName

서비스 이름 (default: domain name)

e.g.) m.naver.com

appVersion

외부 앱의 인앱 브라우저 웹뷰에서 SDK를 로딩 시 외부 앱의 버전 정보 (string)

e.g.) 라인/네이버 앱 버전 정보

webAppVersion

서비스의 버전 정보를 설정. 서비스의 배포에 따른 지표를 확인하기 위해 사용됩니다.

시멘틱 버전 ("1.0.1") 또는 날짜 형타의 버전 정보("2023.01.01") 등 서비스의 배포 버전을 구별할 수 있는 값이면 형식은 무관합니다.

ai

ADID (안드로이드: GAID, iOS: IDFA)

iv

identifierForVendor. iOS IDFA를 대체할 수 있는 identifier로 등록한 서비스 Vendor ID

e.g.) com.navercorp 을 UUID 형태로 추출한 값

uid

user id. 매체에서 자체 정의한 유저 고유 식별자 (string)

yob

출생년도 4자리 (string)

gender

성별 설정값. M(male) | F(female) | O(other)

uct

user country. ISO 3166-1 alpha-2 사용

adMaxVolume

광고의 최대 볼륨 스케일 (광고 볼륨 = 본영상 볼륨 \* adMaxVolume) (number)

contentInitialVolume

광고 음소거 해제 시 설정되는 콘텐츠 볼륨 값 (0 < contentInitialVolume <= 1) (number)

3. 설정 예시

var config = {
requestTimeout: 60000,
language: 'en',
appName: 'm.naver.com',
appVersion: '2.0.1',
webAppVersion: '2023.01.01',
ai: '001bd666-dbc0-4e3c-900f-e2bbb1668c38',
iv: '58F36556-19FD-445B-AF3A-C6D86B15D56C',
uid: 'user id',
yob: '1988',
gender: 'M',
uct: 'KR',
adMaxVolume: 1,
contentInitialVolume: 1,
};

window.gfpInstream.cmd.push(function () {
window.gfpInstream.setGlobalConfig(config);
});