events

nestads.events.Event

이벤트 기본 인터페이스입니다.

속성 요약

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름입니다.

serviceName

serviceName: string

• 이벤트를 트리거한 서비스의 이름입니다.

---

공통 이벤트

nestads.events.SlotImpressionViewableEvent

Event를 상속 받습니다. 광고 소재가 화면에 50% 이상 노출 되면 요청 당 한 번 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("slotImpressionViewable", (event) => {
  const slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

  if (slot === targetSlot) {
    // logic
  }
});

nestads.events.SlotOnloadEvent

Event를 상속 받습니다. iframe에서 로드를 시작하면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("slotOnload", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // logic
  }
});

nestads.events.SlotRenderEndedEvent

Event를 상속 받습니다. iframe 로드가 완료되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("slotRenderEnded", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

nestads.events.SlotRequestedEvent

Event를 상속 받습니다. 광고가 요청되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("slotRequested", (event) => {
  const slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

  if (slot === targetSlot) {
    // logic.
  }
});

nestads.events.SlotResponseReceived

Event를 상속 받습니다. 광고 응답을 받으면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("slotResponseReceived", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

nestads.events.SlotVisibilityChangedEvent

Event를 상속 받습니다. 광고 슬롯 영역의 화면 비율이 변경될 때마다 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯
inViewPercentage	슬롯이 화면에 보이는 비율 (0~100)

inViewPercentage

inViewPercentage: number

• 슬롯이 화면에 보이는 비율입니다. 0~100 사이 숫자입니다.

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("slotVisibilityChanged", (event) => {
  const slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", `${event.inViewPercentage}%`);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

nestads.events.SlotClickedEvent

Event를 상속 받습니다. 광고 클릭시 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("slotClicked", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

nestads.events.SlotRequestFailedEvent

Event를 상속 받습니다. 광고 요청 실패시 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯
error	에러 발생 메세지와 코드

error

error: {code: number, message: string}

• 에러 발생 코드와 메세지입니다. 에러 코드는 여기를 참조하세요.

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("slotRequestFailed", (event) => {
  const slot = event.slot;
  console.log("Ad request for slot", slot.getSlotElementId(), "is failed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

nestads.events.SlotTouchStartEvent

광고 슬롯에서 터치가 시작될 때 실행됩니다.

속성	설명
serviceName	이벤트를 발생시킨 서비스 이름
slot	이벤트가 발생한 슬롯 객체
touchEvent	터치 정보 객체 (INestAdsTouchEvent 참조)

예시

nestads.pubAds().addEventListener("slotTouchStart", (event) => {
    const { slot, touchEvent } = event;
    const touch = touchEvent.touches[0];

    console.log("[TouchStart]");
    console.log("Slot ID:", slot.id);
    console.log("X:", touch.clientX, "Y:", touch.clientY);
});

nestads.events.SlotTouchMoveEvent

터치된 손가락이 움직일 때 실행됩니다.

속성	설명
serviceName	이벤트를 발생시킨 서비스 이름
slot	이벤트가 발생한 슬롯 객체
touchEvent	터치 정보 객체 (INestAdsTouchEvent 참조)

예시

nestads.pubAds().addEventListener("slotTouchMove", (event) => {
    const { slot, touchEvent } = event;
    const touch = touchEvent.touches[0];

    console.log("[TouchMove]");
    console.log("Slot ID:", slot.id);
    console.log("X:", touch.clientX, "Y:", touch.clientY);
});

nestads.events.SlotTouchEndEvent

손가락이 화면에서 떨어질 때 실행됩니다.

속성	설명
serviceName	이벤트를 발생시킨 서비스 이름
slot	이벤트가 발생한 슬롯 객체
touchEvent	터치 정보 객체 (INestAdsTouchEvent 참조)

예시

nestads.pubAds().addEventListener("slotTouchEnd", (event) => {
    const { slot, touchEvent } = event;
    const touch = touchEvent.changedTouches[0];

    console.log("[TouchEnd]");
    console.log("Slot ID:", slot.id);
    console.log("X:", touch.clientX, "Y:", touch.clientY);
});

nestads.events.SlotTouchCancelEvent

시스템 또는 브라우저가 터치를 강제로 취소할 때 실행됩니다.

속성	설명
serviceName	이벤트를 발생시킨 서비스 이름
slot	이벤트가 발생한 슬롯 객체
touchEvent	터치 정보 객체 (INestAdsTouchEvent 참조)

예시

nestads.pubAds().addEventListener("slotTouchCancel", (event) => {
    const { slot, touchEvent } = event;

    console.log("[TouchCancel]");
    console.log("Slot ID:", slot.id);
    console.log("Reason: System interruption or gesture canceled");
});

INestAdsTouchEvent

touchEvent는 다음과 같은 구조를 갖습니다.

interface INestAdsTouchEvent {
  type: "touchstart" | "touchmove" | "touchend" | "touchcancel";
  timeStamp: number;
  targetId?: string;

  touches: Array<{
    clientX: number;
    clientY: number;
    identifier: number;
  }>;

  changedTouches: Array<{
    clientX: number;
    clientY: number;
    identifier: number;
  }>;

  targetBoundingBox?: {
    top: number;
    left: number;
    width: number;
    height: number;
  };

  elementSize?: {
    width: number;
    height: number;
  };
}

---

팝업 배너 광고 이벤트

nestads.events.PopupBannerSlotLeftButtonClickedEvent

Event를 상속 받습니다. 팝업 배너 광고에서 왼쪽 버튼 클릭 시 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("popupBannerSlotLeftButtonClicked", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //왼쪽 버튼 눌렸을 시 실행할 코드
  }
});

nestads.events.PopupBannerSlotRightButtonClickedEvent

Event를 상속 받습니다. 팝업 배너 광고에서 오른쪽 버튼 클릭 시 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("popupBannerSlotRightButtonClicked", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //오른쪽 버튼 눌렸을 시 실행할 코드
  }
});

nestads.events.PopupBannerSlotOpenedEvent

Event를 상속 받습니다. 팝업 배너 광고에서 팝업이 표시되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("popupBannerSlotOpened", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //팝업이 열리면 실행할 코드
  }
});

nestads.events.PopupBannerSlotClosedEvent

Event를 상속 받습니다. 팝업 배너 광고에서 팝업이 닫히면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("popupBannerSlotClosed", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //팝업이 닫히면 실행할 코드
  }
});

nestads.events.PopupBannerListViewClickedEvent

Event를 상속 받습니다. 팝업 배너 광고에서 모아보기를 클릭하면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯
adList: IAdType[]	콜백으로 받을 광고 객체 데이터 광고, 이미지, 애드뱃지, 노출url 정보들의 객체가 배열로 들어옵니다.

광고 객체의 인터페이스

interface IAdType {
  adInfo: {
    adProductId: number, // 광고상품 ID
    campaignId: number, // 캠페인 ID
    adGroupId: number, // 광고그룹 ID
    adId: number, // 광고 ID
  },
  image: {
    clickUrls: string[], // 클릭수 트래킹 URL
    landingUrl: string, // 랜딩 URL
    landingUrlType: string, // 랜딩 URL 타입 (ex: OUTLINK)
    width: number, // 이미지 가로 길이
    height: number, // 이미지 세로 길이
    resourceUrl: string, // 이미지 경로
    backgroundColor: string, // 이미지 백그라운드 색상
  },
  adBadge: {
    value: string, // 애드뱃지 값
  },
  impressionUrls: string[], // 노출수 트래킹 URL
}

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("popupBannerListViewClicked", (event) => {
  const slot = event.slot;
  const ad: IAdType = event.adList[0];

  if (slot === targetSlot) {
    // 모아보기 버튼을 클릭하면 실행할 코드
  }
});

---

동영상 광고 이벤트

nestads.events.VastPlayerClosedEvent

Event를 상속 받습니다. 동영상 광고에서 동영상이 닫히면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerClosed", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //동영상이 닫히면 실행할 코드
  }
});

---

nestads.events.VastPlayerPlayedEvent

Event를 상속 받습니다. 동영상 광고에서 동영상이 재생되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerPlayed", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //동영상 재생이 시작되면 실행할 코드
  }
});

---

nestads.events.VastPlayerPausedEvent

Event를 상속 받습니다. 동영상 광고에서 동영상이 일시정지 되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerPaused", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //동영상이 일시정지 되면 실행할 코드
  }
});

---

nestads.events.VastPlayerEndedEvent

Event를 상속 받습니다. 동영상 광고에서 재생이 완료되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerEnded", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //동영상 재생이 완료 되면 실행할 코드
  }
});

---

nestads.events.VastPlayerMutedEvent

Event를 상속 받습니다. 동영상 광고에서 동영상이 음소거 되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerMuted", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //동영상이 음소거 되면 실행할 코드
  }
});

---

nestads.events.VastPlayerUnmutedEvent

Event를 상속 받습니다. 동영상 광고에서 동영상이 음소거 해제 되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerUnmuted", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //동영상 음소거 해제 되면 실행할 코드
  }
});

---

nestads.events.VastPlayerCtaClickedEvent

Event를 상속 받습니다. 동영상 광고에서 CTA 버튼이 클릭 되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerCtaClicked", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //동영상 광고의 CTA 버튼이 클릭 되면 실행할 코드
  }
});

---

프리미엄 배너 광고 이벤트

nestads.events.PremiumBannerHintAssetTriggeredEvent

Event를 상속 받습니다. 프리미엄 배너 광고에서 힌트 에셋이 트리거 되면 실행됩니다.

PC 레이아웃에서는 마우스 오버, Mobile 레이아웃에서는 클릭하면 힌트 에셋이 트리거됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerHintAssetTriggered", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //힌트 에셋이 트리거 되면 실행할 코드
  }
});

---

nestads.events.PremiumBannerImageExpandedEvent

Event를 상속 받습니다. 프리미엄 배너 광고에서 이미지가 확장되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerImageExpanded", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //이미지가 확장되면 실행할 코드
  }
});

---

nestads.events.PremiumBannerExpandedImageClickedEvent

Event를 상속 받습니다. 프리미엄 배너 광고에서 확장 후 이미지가 클릭 되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerExpandedImageClicked", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //확장 후 이미지가 클릭 되면 실행할 코드
  }
});

---

nestads.events.PremiumBannerImageClosedEvent

Event를 상속 받습니다. 프리미엄 배너 광고에서 확장 후 이미지가 닫히면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerImageClosed", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //확장 후 이미지가 닫히면 실행할 코드
  }
});

---

nestads.events.PremiumBannerVideoExpandedEvent

Event를 상속 받습니다. 프리미엄 배너 광고에서 동영상이 확장되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerVideoExpanded", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //동영상이 확장되면 실행할 코드
  }
});

---

nestads.events.PremiumBannerExpandedVideoClickedEvent

Event를 상속 받습니다. 프리미엄 배너 광고에서 확장 후 동영상이 클릭 되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerExpandedVideoClicked", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //확장 후 동영상이 클릭 되면 실행할 코드
  }
});

---

nestads.events.PremiumBannerVideoClosedEvent

Event를 상속 받습니다. 프리미엄 배너 광고에서 확장 후 동영상이 닫히면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
slot	이벤트를 트리거한 슬롯

예시

const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerVideoClosed", (event) => {
  const slot = event.slot;

  if (slot === targetSlot) {
    //확장 후 동영상이 닫히면 실행할 코드
  }
});

---

nestads.events.LoaderResponseReceivedEvent

Event를 상속 받습니다. 로더가 광고 응답을 받으면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
loader	이벤트를 트리거한 로더
customAds	광고 응답 객체 배열

예시

const loader = nestads.defineLoader(`${placementCode}`, [creativeSpecId1,creativeSpecId2,...])
nestads.pubAds().addEventListener("loaderResponseReceived", (event) => {
 const customAds = event.customAds;
 // 광고 응답을 받으면 실행할 코드
 document.querySelector("#image1").src  = customAds[0].getAdMeta("Banner").resourceUrl;

});

---

nestads.events.LoaderRequestFailedEvent

Event를 상속 받습니다. 로더가 광고 응답을 받는데 실패하면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
loader	이벤트를 트리거한 로더
error	에러 발생 메세지와 코드

error

error: {code: number, message: string}

• 에러 발생 코드와 메세지입니다. 에러 코드는 여기를 참조하세요.

예시

const loader = nestads.defineLoader(`${placementCode}`, [creativeSpecId1,creativeSpecId2,...])
nestads.pubAds().addEventListener("loaderRequestFailed", (event) => {
 // 광고 응답을 받는데 실패하면 실행할 코드

});

---

nestads.events.CustomAdImpressionRecordedEvent

Event를 상속 받습니다. 커스텀형 광고에서 노출 성과 수집이 완료되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
customAd	이벤트가 발생한 광고 객체

예시

// 노출 성과 기록
customAd.recordImpression();

nestads.pubAds().addEventListener("customAdImpressionRecorded", (event) => {
 // 노출 성과 수집 완료되면 실행할 코드

});

---

nestads.events.CustomAdClickedEvent

Event를 상속 받습니다. 커스텀형 광고에서 클릭 성과 수집이 완료되면 실행됩니다.

속성	설명
serviceName	이벤트를 트리거한 서비스의 이름
customAd	이벤트가 발생한 광고 객체
mediaSpecId	이벤트가 발생한 광고 객체의 내부 미디어 스펙 ID

예시

// 클릭 성과 기록
customAd.performClick("Banner");

nestads.pubAds().addEventListener("customAdClicked", (event) => {
 // 클릭 성과 수집 완료되면 실행할 코드 (ex. 랜딩 url 열기..등)

});

---