events
nestads.events.Event
이벤트 기본 인터페이스입니다.
속성 요약
이벤트를 트리거한 서비스의 이름입니다.
serviceName
serviceName: string
이벤트를 트리거한 서비스의 이름입니다.
공통 이벤트
nestads.events.SlotImpressionViewableEvent
Event를 상속 받습니다. 광고 소재가 화면에 50% 이상 노출 되면 요청 당 한 번 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
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에서 로드를 시작하면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
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 로드가 완료되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
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를 상속 받습니다. 광고가 요청되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
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를 상속 받습니다. 광고 응답을 받으면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
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를 상속 받습니다. 광고 슬롯 영역의 화면 비율이 변경될 때마다 실행됩니다.
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를 상속 받습니다. 광고 클릭시 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
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를 상속 받습니다. 광고 요청 실패시 실행됩니다.
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.PopupBannerSlotLeftButtonClickedEvent
Event를 상속 받습니다. 팝업 배너 광고에서 왼쪽 버튼 클릭 시 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("popupBannerSlotLeftButtonClicked", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//왼쪽 버튼 눌렸을 시 실행할 코드
}
});nestads.events.PopupBannerSlotRightButtonClickedEvent
Event를 상속 받습니다. 팝업 배너 광고에서 오른쪽 버튼 클릭 시 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("popupBannerSlotRightButtonClicked", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//오른쪽 버튼 눌렸을 시 실행할 코드
}
});nestads.events.PopupBannerSlotOpenedEvent
Event를 상속 받습니다. 팝업 배너 광고에서 팝업이 표시되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("popupBannerSlotOpened", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//팝업이 열리면 실행할 코드
}
});nestads.events.PopupBannerSlotClosedEvent
Event를 상속 받습니다. 팝업 배너 광고에서 팝업이 닫히면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("popupBannerSlotClosed", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//팝업이 닫히면 실행할 코드
}
});동영상 광고 이벤트
nestads.events.VastPlayerClosedEvent
Event를 상속 받습니다. 동영상 광고에서 동영상이 닫히면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerClosed", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//동영상이 닫히면 실행할 코드
}
});nestads.events.VastPlayerPlayedEvent
Event를 상속 받습니다. 동영상 광고에서 동영상이 재생되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerPlayed", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//동영상 재생이 시작되면 실행할 코드
}
});nestads.events.VastPlayerPausedEvent
Event를 상속 받습니다. 동영상 광고에서 동영상이 일시정지 되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerPaused", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//동영상이 일시정지 되면 실행할 코드
}
});nestads.events.VastPlayerEndedEvent
Event를 상속 받습니다. 동영상 광고에서 재생이 완료되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerEnded", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//동영상 재생이 완료 되면 실행할 코드
}
});nestads.events.VastPlayerMutedEvent
Event를 상속 받습니다. 동영상 광고에서 동영상이 음소거 되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerMuted", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//동영상이 음소거 되면 실행할 코드
}
});nestads.events.VastPlayerUnmutedEvent
Event를 상속 받습니다. 동영상 광고에서 동영상이 음소거 해제 되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("vastPlayerUnmuted", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//동영상 음소거 해제 되면 실행할 코드
}
});nestads.events.VastPlayerCtaClickedEvent
Event를 상속 받습니다. 동영상 광고에서 CTA 버튼이 클릭 되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
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 레이아웃에서는 클릭하면 힌트 에셋이 트리거됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerHintAssetTriggered", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//힌트 에셋이 트리거 되면 실행할 코드
}
});nestads.events.PremiumBannerImageExpandedEvent
Event를 상속 받습니다. 프리미엄 배너 광고에서 이미지가 확장되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerImageExpanded", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//이미지가 확장되면 실행할 코드
}
});nestads.events.PremiumBannerExpandedImageClickedEvent
Event를 상속 받습니다. 프리미엄 배너 광고에서 확장 후 이미지가 클릭 되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerExpandedImageClicked", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//확장 후 이미지가 클릭 되면 실행할 코드
}
});nestads.events.PremiumBannerImageClosedEvent
Event를 상속 받습니다. 프리미엄 배너 광고에서 확장 후 이미지가 닫히면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerImageClosed", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//확장 후 이미지가 닫히면 실행할 코드
}
});nestads.events.PremiumBannerVideoExpandedEvent
Event를 상속 받습니다. 프리미엄 배너 광고에서 동영상이 확장되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerVideoExpanded", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//동영상이 확장되면 실행할 코드
}
});nestads.events.PremiumBannerExpandedVideoClickedEvent
Event를 상속 받습니다. 프리미엄 배너 광고에서 확장 후 동영상이 클릭 되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerExpandedVideoClicked", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//확장 후 동영상이 클릭 되면 실행할 코드
}
});nestads.events.PremiumBannerVideoClosedEvent
Event를 상속 받습니다. 프리미엄 배너 광고에서 확장 후 동영상이 닫히면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트를 트리거한 슬롯
예시
const targetSlot = nestads.defineSlot(`${placementCode}`, [160, 600]);
nestads.pubAds().addEventListener("premiumBannerVideoClosed", (event) => {
const slot = event.slot;
if (slot === targetSlot) {
//확장 후 동영상이 닫히면 실행할 코드
}
});nestads.events.LoaderResponseReceivedEvent
Event를 상속 받습니다. 로더가 광고 응답을 받으면 실행됩니다.
예시
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를 상속 받습니다. 로더가 광고 응답을 받는데 실패하면 실행됩니다.
error
error: {code: number, message: string}
에러 발생 코드와 메세지입니다. 에러 코드는 여기를 참조하세요.
예시
const loader = nestads.defineLoader(`${placementCode}`, [creativeSpecId1,creativeSpecId2,...])
nestads.pubAds().addEventListener("loaderRequestFailed", (event) => {
// 광고 응답을 받는데 실패하면 실행할 코드
});nestads.events.CustomAdImpressionRecordedEvent
Event를 상속 받습니다. 커스텀형 광고에서 노출 성과 수집이 완료되면 실행됩니다.
이벤트를 트리거한 서비스의 이름
이벤트가 발생한 광고 객체
예시
// 노출 성과 기록
customAd.recordImpression();
nestads.pubAds().addEventListener("customAdImpressionRecorded", (event) => {
// 노출 성과 수집 완료되면 실행할 코드
});nestads.events.CustomAdClickedEvent
Event를 상속 받습니다. 커스텀형 광고에서 클릭 성과 수집이 완료되면 실행됩니다.
예시
// 클릭 성과 기록
customAd.performClick("Banner");
nestads.pubAds().addEventListener("customAdClicked", (event) => {
// 클릭 성과 수집 완료되면 실행할 코드 (ex. 랜딩 url 열기..등)
});Last updated