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)

language

네이티브 광고에 적용할 언어

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 이벤트 전달 페이지를 참고해주세요.

yob

출생년도 4자리 (string)

gender

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

uct

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

uid

user id.

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

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

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

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,
  },
  ai: '001bd666-dbc0-4e3c-900f-e2bbb1668c38',
  iv: '58F36556-19FD-445B-AF3A-C6D86B15D56C',
  yob: '1988',
  gender: 'M',
  uct: 'KR',
  uid: 'user id',
};

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

1. SDK 전역 파라미터 설정​

2. SDK 전역 설정 속성​

3. 설정 예시​

1. SDK 전역 파라미터 설정

2. SDK 전역 설정 속성

3. 설정 예시