본문으로 건너뛰기

광고 슬롯 설정

1. 광고 슬롯 설정​

gladsdk.defineAdSlot()을 사용하여 광고 슬롯을 생성할 때 광고 슬롯에 대한 설정값을 전달할 수 있습니다.

2. 광고 슬롯 설정 속성​

adUnitId (required)

광고 요청을 위해 해당 매체용으로 발급된 광고 유닛 id

adSlotElementId

광고 노출 영역(HTML Element)의 id

광고 영역을 식별할 목적으로 사용되며 페이지 내에서 유니크한 식별값으로 정의되어야 합니다.

yob

출생년도 4자리 (string)

gender

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

uct

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

uid

user id.

ai

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

iv

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

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

contentInfo

컨텐츠 타게팅을 위한 컨텐츠 정보

{
  "sourceType": "0001",
  "sourceSubType": "menu",
  "sourceId": "30907206:7"
}

2-1. 커스텀 파라미터​

  • gladsdk.defineAdSlot()을 사용하여 광고 슬롯을 생성할 때 커스텀 파라미터를 사용하여 더 세분화된 광고를 요청할 수 있습니다.

    window.gladsdk.cmd.push(function () {
      var adSlot = window.gladsdk.defineAdSlot({
        adUnitId: 'adUnitId',
        customParam: {
          category: 'entertainment',
          hobby: ['music', 'sports'],
        },
      });
    });

  • adSlot.setCustomParam()을 사용하여 기존에 생성된 광고 슬롯에 커스텀 파라미터를 설정할 수 있습니다.

    window.gladsdk.cmd.push(function () {
      adSlot.setCustomParam('category', 'entertainment');
    });

2-2. 모든 광고 슬롯의 커스텀 파라미터 설정​

  • gladsdk.setCustomParam()를 사용하여 전역 커스텀 파라미터를 설정하여 모든 슬롯에 커스텀 파라미터를 적용할 수 있습니다.

    window.gladsdk.cmd.push(function () {
      gladsdk.setCustomParam('category', 'entertainment');
      var adSlot = window.gladsdk.defineAdSlot({
        adUnitId: 'adUnitId',
      });
      // adSlot의 customParam에 category: entertainment가 적용
    });

  • 동일한 key에 대해 전역 커스텀 파라미터와 슬롯 커스텀 파라미터가 모두 적용될 경우 슬롯 설정이 우선 적용됩니다.

    window.gladsdk.cmd.push(function () {
      gladsdk.setCustomParam('category', 'entertainment');
      var adSlot = window.gladsdk.defineAdSlot({
        adUnitId: 'adUnitId',
        customParam: {
          category: 'news',
        },
      });
      // adSlot의 customParam에 category: news가 적용
    });

3. 설정 예시​

window.gladsdk.cmd.push(function () {
  var adSlotInfo = {
    adUnitId: 'adUnitId',
    adSlotElementId: 'division',
    ai: '001bd666-dbc0-4e3c-900f-e2bbb1668c38',
    iv: '58F36556-19FD-445B-AF3A-C6D86B15D56C',
    yob: '1988',
    gender: 'M',
    uct: 'KR',
    uid: 'user id',
    customParam: {
      category: 'entertainment',
      hobby: ['music', 'sports'],
    },
    contentInfo: {
      sourceType: '0001',
      sourceSubType: 'menu',
      sourceId: '30907206:7',
    },
  };

  window.gladsdk.defineAdSlot(adSlotInfo);
});