SDK 전역 설정
1. SDK 전역 파라미터 설정
-
gladsdk.setGlobalConfig()를 사용하여 SDK 전역 파라미터를 설정할 수 있습니다.
window.gladsdk.cmd.push(function () {
var config = {
requestTimeout: 60000,
enablePersistAd: false,
language: 'en',
appName: 'm.naver.com',
appVersion: '1.0.0',
};
window.gladsdk.setGlobalConfig(config);
}); -
gladsdk.getGlobalConfig()를 사용하여 설정된 전역 파라미터를 확인할 수 있습니다.
window.gladsdk.cmd.push(function () {
window.gladsdk.getGlobalConfig();
});
2. SDK 전역 설정 속성
모든 SDK 전역 설정 속성은 optional 입니다.
requestTimeout
광고 요청 타임아웃 시간(ms) (number, default: 60000)
enablePersistAd
광고 퍼시스트 설정 여부 (default: false)
debug
디버그 모드 설정 여부. phase 설정이 필요한 경우에만 true 로 설정 (default: false)
phase
광고를 요청할 서버의 phase를 변경. 'dev'
| 'test'
| 'production'
language
네이티브 광고에 적용할 언어
언어 코드값(string) | 'ko'
(Korean) | 'en'
(English) | 'ja'
(Japanese) | 'zh-tw'
(Taiwanese) | 'th'
(Thai) | 'id'
(Indonesian)
appName
서비스 이름. 기본값은 도메인 네임으로 설정됨 (ex. m.naver.com)
appVersion
외부 앱의 인앱 브라우저 웹뷰에서 SDK를 로딩 시 외부 앱의 버전 정보 (string) (ex: 라인/네이버 앱 버전 정보)
webAppVersion
서비스의 버전 정보를 설정. 서비스의 배포에 따른 지표를 확인하기 위해 사용됩니다.
시멘틱 버전 ("1.0.1"
) 또는 날짜 형타의 버전 정보("2023.01.01"
) 등 서비스의 배포 버전을 구별할 수 있는 값이면 형식은 무관합니다.
maxDedupReqCount
광고 중복 제어 를 적용할 광고 슬롯의 개수
dependentService
dependent service 정보. 네이티브 광고에 대해 Line 기본 클릭 핸들러 설정이 필요한 경우 설정
{
serviceName: string;
scheme: string;
}
skAdNetworkInfo
Storekit ad network 요청 정보 (SKAdNetworkInfo)
{
skAdNetworkIds: string | string[]; // 전환 추적 대상 앱 인스톨 광고 ad network (DSP)의 skAdNetwork 고유 식별자
skAdNetworkVersion: string; // skAdNetwork 버전
}
iOS 14.5 이상 사용자에 대해 ATT 프레임워크를 통한 명시적인 사용자 정보 이용 동의를 받지 않은 경우, 기본적으로 IDFA를 수집할 수 없습니다. 인스톨 광고 전환율을 측정하기 위해 iOS에서 특정 ad network(DSP)의 skAdNetwork 정보를 이용하여 해당 기능을 지원할 수 있도록 API 제공하고 있습니다. https://developer.apple.com/documentation/storekit/skadnetwork
limitAdTracking
광고 추적 제한 설정 여부 (boolean)
appTrackingTransparency
app Tracking Transparency 상태값(iOS ATT, number)
3
(authorized) | 2
(denied) | 1
(restricted) | 0
(notDetermined)
activateIframeTouch
해당 설정은 Deprecated 되었습니다. activateIframeEvent.touch
설정을 권장합니다.
자세한 내용을 Iframe 이벤트 전달 페이지를 참고해주세요.
iframe 내 터치 이벤트의 부모 window 전달 활성 여부 (boolean)
activateIframeEvent
iframe 내 이벤트의 부모 window 전달 활성 여부를 설정합니다.
자세한 내용을 Iframe 이벤트 전달 페이지를 참고해주세요.
3. 설정 예시
var config = {
requestTimeout: 60000,
enablePersistAd: false,
debug: false,
phase: 'production',
language: 'en',
appName: 'm.naver.com',
appVersion: '2.0.1',
webAppVersion: '2023.01.01',
maxDedupReqCount: -1,
dependentService: {
serviceName: 'line',
scheme: 'https://line.me/',
},
skAdNetworkInfo: {
skAdNetworkIds: '69825734',
skAdNetworkVersion: '2.0',
},
limitAdTracking: false,
appTrackingTransparency: 3,
activateIframeEvent: {
touch: false,
mouse: false,
wheel: false,
keyboard: false,
},
};
window.gladsdk.cmd.push(function () {
window.gladsdk.setGlobalConfig(config);
});