Skip to main content

SDK Global Settings

1. SDK global parameter settings​

  • Use gladsdk.setGlobalConfig() to set SDK global parameters.

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

  • Use gladsdk.getGlobalConfig() to check the set global parameters.

    window.gladsdk.cmd.push(function () {
      window.gladsdk.getGlobalConfig();
    });

2. SDK global parameter settings​

All SDK global setting properties are optional.

requestTimeout

Ad request timeout time (ms) (number, default: 60000)

enablePersistAd

Ad persistence settings status (default: false)

language

Language to apply to native ad.

Language code value(string) | 'ko'(Korean) | 'en'(English) | 'ja'(Japanese) | 'zh-tw'(Taiwanese) | 'th'(Thai) | 'id'(Indonesian)

appName

Service name. The default is set to the domain name. (ex. m.naver.com)

appVersion

The external app version when loading a SDK in the in-app browser web view from an external app (string) (ex: Line/Naver app version)

webAppVersion

Set the service version. This is used to check indicators according to the deployment of the service.

The value format is irrelevant as long as the value distinguishes the deployment version of the service, such as the semantic version ("1.0.1") or the date-type version ("2023.01.01").

maxDedupReqCount

Number of ad slots to apply AD duplicate control.

dependentService

Dependent service information. Set this property, if the Line default click handler(implemented within a SDK) is required for native ads.

{
  serviceName: string;
  scheme: string;
}

skAdNetworkInfo

Storekit ad network request information (SKAdNetworkInfo)

{
  skAdNetworkIds: string | string[]; // The skAdNetwork unique identifiers which conversions are being tracked.
  skAdNetworkVersion: string;
}

For users of OS 14.5 or higher, IDFA cannot be collected by default if explicit consent to use user information is not obtained through the ATT framework. To measure the install Ad conversion rate, iOS provides an API to support the function via the skAdNetwork information from a specific ad network (DSP). https://developer.apple.com/documentation/storekit/skadnetwork

limitAdTracking

Ad tracking restriction settings (boolean)

appTrackingTransparency

App Tracking Transparency status(iOS ATT, number)

3(authorized) | 2(denied) | 1(restricted) | 0(notDetermined)

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

activateIframeTouch

caution

This setting has been deprecated. The activateIframeEvent.touch settings are recommended.

For more information, please refer to the Iframe event delivery page.

Setting for dispatch activation of touch event within an iframe to the parent window (boolean)

activateIframeEvent

Set the event dispatch activation settings for dispatching events from an iframe window to the parent window.

For more information, please refer to the Iframe event delivery page

yob

Year of birth in 4 digits (string)

gender

Gender settings. M(male) | F(female) | O(other)

uct

User country. Use ISO 3166-1 alpha-2.

uid

User ID.

ai

ADID (Android: GAID, iOS: IDFA)

iv

identifierForVendor. Service Vendor ID registered as an identifier that can replace iOS IDFA.

e.g.) Value extracted from com.navercorp in UUID format

3. Setting example​

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