Slot

단일 광고 슬롯을 나타내는 객체입니다.

nestads.Slot

메서드 요약

메서드	설명
addService	이 슬롯에 Service를 추가합니다.
clearTargeting	이 슬롯에 대한 특정 또는 모든 타겟팅 매개변수를 삭제합니다.
getSlotElementId	슬롯이 정의되었을 때 제공된 슬롯 div의 ID를 반환합니다.
getTargeting	이 슬롯에 설정된 특정 타겟팅 매개변수를 반환합니다.
getTargetingKeys	이 슬롯에 설정된 모든 타겟팅 키의 목록을 반환합니다.
setConfig	이 슬롯의 일반 구성 옵션을 설정합니다.
setForceSafeFrame	iframe sandbox 속성을 활성화 시킵니다.
setTargeting	이 슬롯에 대한 타겟팅 매개변수를 설정합니다.

---

addService

addService(service: Service): Slot

이 슬롯에 Service를 추가합니다.

예시

nestads.defineSlot(`${placementCode}`, [160, 600], `${divId}`)
       .addService(nestads.pubAds());

매개변수	설명
service: Service	추가할 서비스입니다.

반환 값	설명
Slot	메서드가 호출된 슬롯 객체입니다.

---

clearTargeting

clearTargeting(key?: string): Slot

슬롯별 타겟팅 매개변수를 삭제합니다.

예시

const slot = nestads
  .defineSlot(`${placementCode}`, [160, 600], `${divId}`)
  .setTargeting("age", 30)
  .setTargeting("gender", "MALE")
  .addService(nestads.pubAds());

slot.clearTargeting("gender");
slot.clearTargeting(); //All targeting cleared

매개변수	설명
key?: string	타겟팅 매개변수 키. 키는 선택사항입니다. 지정하지 않으면 모든 타겟팅 매개변수가 삭제됩니다.

반환 값	설명
Slot	메서드가 호출된 슬롯 객체입니다.

---

getSlotElementId

getSlotElementId(): string

슬롯이 정의되었을 때 제공된 슬롯 div의 ID를 반환합니다.

예시

const slot = nestads
  .defineSlot(`${placementCode}`, [160, 600], `${divId}`)
  .addService(nestads.pubAds());

slot.getSlotElementId(); // Returns 'divId'.

반환 값	설명
string	슬롯 div ID

---

getTargeting

getTargeting(key: string): string[]

이 슬롯에 설정된 특정 타겟팅 매개변수를 반환합니다.

예시

const slot = nestads
  .defineSlot(`${placementCode}`, [160, 600], `${divId}`)
  .setTargeting("age", 30)
  .addService(nestads.pubAds());

slot.getTargeting("age");
// Returns [30].

slot.getTargeting("test");
// Returns [] (empty array).

매개변수	설명
key: string	찾을 타겟팅 키입니다.

반환 값	설명
string[]	이 키와 연결된 값 또는 키가 없는 경우 빈 배열입니다.

---

getTargetingKeys

getTargetingKeys(): string[]

슬롯에 설정된 모든 타겟팅 키의 목록을 반환합니다.

예시

const slot = nestads
  .defineSlot(`${placementCode}`, [160, 600], `${divId}`)
  .setTargeting("age", 30)
  .setTargeting("gender", "MALE")
  .addService(nestads.pubAds());

slot.getTargetingKeys(); // Returns ['age', 'gender'].

반환 값	설명
string[]	타겟팅 키의 배열입니다. 순서는 정의되지 않습니다.

---

---

setConfig

setConfig(slotConfig: SlotSettingsConfig): void

광고 구성 옵션을 설정합니다.

매개변수	설명
slotConfig: SlotSettingsConfig	광고 구성 옵션 객체입니다.

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot

해당 속성을 사용해 iframe sandbox 속성을 활성화 시킵니다.

예시

nestads
  .defineSlot(`${placementCode}`, [160, 600], `${divId})
  .setForceSafeFrame(true)
  .addService(nestads.pubAds());

---

setTargeting

setTargeting(key: string, value: string | string[] | Object): Slot

슬롯에 대한 타겟팅 매개변수를 설정합니다.

유효한 타겟팅 key 값은 아래에서 참고해주세요.

예시

const slot = nestads
  .defineSlot(`${placementCode}`, [160, 600], `${divId}`)
  .addService(nestads.pubAds());

slot.setTargeting("age", 30);
slot.setTargeting("customTargeting", {"custom1":"custom1Value", "custom2":"custom2Value"});
slot.setTargeting("audienceParameters", {"region": ["265700", "245422"], "career_period": [120]});

매개변수	설명
key: string	타겟팅 매개변수 키
value: string | string[] | Object	타겟팅 매개변수 값입니다.

타겟팅 매개변수 유효한 값

Key	Value Type	설명
appVersion	string	클라이언트 앱/웹 버전
country	string	광고 요청한 유저 국가코드(3자리) ISO-3166-1-alpha-3 UNKNOWN default: PC - 브라우저 설정 국가 Mobile - 디바이스의 시스템 설정 국가
language	string	광고 요청한 유저 언어 설정값(2자리) ISO-639-1-alpha-2 UNKNOWN default: PC - 브라우저 표시 언어 Mobile - 디바이스의 시스템 설정 언어
deviceBrand	string	광고 요청한 유저 디바이스의 브랜드
deviceModel	string	광고 요청한 유저 디바이스의 모델명
carrier	string	광고 요청한 유저 기기의 통신사 식별자
lat	boolean	광고 요청한 유저 기기의 광고추적제한 (LAT, Limit Ad Tracking) 설정 여부 true : 광고 추적 불가 false : 광고 추적 가능
adid	string	광고 요청한 디바이스 식별자 (for Android)
idfa	string	광고 요청한 디바이스 식별자 (for iOS)
idfv	string	광고 요청한 벤더 식별자 (for iOS)
loginId	string	매체 서비스에서 이용하는 고유 로그인아이디
gender	string	광고 요청한 유저 성별 MALE : 남성 FEMALE : 여성 UNKNOWN : 알 수 없음
age	number	광고 요청한 유저 연령
customTargeting	Object(JSON)	매체의 맞춤 타겟팅 값 {customTargetingKey: customTargetingValue} 형태로 넣어 줍니다.
audienceParameters	Object(JSON)	오디언스 파라미터 값 {[key: string]: string[] | number[]} 형태로 넣어 줍니다.

반환 값	설명
Slot	메서드가 호출된 슬롯 객체입니다.