광고 슬롯 설정

1. 광고 슬롯 설정

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

2. 광고 슬롯 설정 속성

adUnitId (required)

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

adSlotElementId

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

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

contentInfo

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

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

context

컨텍스추얼 타겟팅을 위한 컨텍스트 분석 결과

컨텍스트 분석 스크립트(ctx-sdk.js)의 분석 결과(res.context)를 가공하지 않고 그대로 전달합니다. 분석 결과가 null인 경우 설정하지 않습니다. 자세한 내용은 컨텍스추얼 타겟팅을 참고해주세요.

{
  "top_cat": "자동차>신차·중고차·시세",
  "iab": ["30"],
  "kw": ["GV90", "제네시스"]
}

keyword

매체가 직접 주입하는 단일 키워드

검색어 등 단순 키워드를 문자열로 전달합니다. 문장이 아닌 단어 형태로 전달하며, 아이팟 프로처럼 여러 단어로 된 키워드도 가능합니다. 콘텐츠 제목은 전달하지 않습니다. context와 독립적으로 전달되며, 둘 다 설정하면 두 값 모두 전달됩니다. 자세한 내용은 매체 주입 키워드 설정하기를 참고해주세요.

keyword: '아이팟 프로'

enablePersistAd

광고 슬롯 단위 광고 퍼시스트 설정 여부 (boolean)

설정하지 않으면 전역 설정의 enablePersistAd 값을 따릅니다.

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',
    customParam: {
      category: 'entertainment',
      hobby: ['music', 'sports'],
    },
    contentInfo: {
      sourceType: '0001',
      sourceSubType: 'menu',
      sourceId: '30907206:7',
    },
  };

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