본문으로 건너뛰기

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)

https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/authorizationstatus

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);
});