기본 사항

다음 가이드에서는 NestAds SDK를 활용할 수 있는 기본 개념을 설명합니다.

광고 slot 정의

• nestads.defineSlot()에 placementCode(게재위치 코드), 사이즈, divId를 명시하여 slot을 정의합니다.

• divId 를 명시하지 않으면 광고는 body 하위로 그려집니다.

• setTargeting, setConfig 를 사용하여 slot별 타겟팅 및 광고 표시 설정을 지원합니다.

• 더 자세한 사항은 Reference 를 참고해주세요.

nestads
  .defineSlot(`${placementCode}`, [728, 90], "banner-ad")
  .addService(nestads.pubAds())
  .setTargeting("age", "20")
  .setConfig({httpTimeout: 2000})

---

광고 삭제 및 새로고침

광고 삭제

• nestads.destroySlots() / nestads.destroySlot() 을 사용하여 광고 slot들을 제거할 수 있습니다.

광고 새로고침

• nestads.pubAds().refresh() 를 사용하여 해당 서비스를 사용하는 슬롯을 초기화하고, 새 광고를 요청할 수 있습니다.

---

광고 이벤트 리스너

광고 이벤트 리스너 추가

• nestads.pubAds().addEventListener() 를 사용하여 광고 slot 렌더링 중 발생하는 이벤트에 대해 리스너를 추가할 수 있습니다.

• 이벤트 종류

이벤트명	설명
slotImpressionViewable	광고 slot의 광고 소재가 화면에 50% 이상 노출 되면 요청 당 한 번 발생
slotOnload	광고 slot에 광고 로드 시작시 발생
slotRenderEnded	광고 slot에 광고 렌더링이 완료되면 발생
slotRequested	광고 slot에 광고 요청이 완료되면 발생
slotResponseReceived	광고 slot에 광고 응답을 받으면 발생
slotVisibilityChanged	광고 slot의 visibility 가 변경되면 발생
slotClicked	광고 slot에 렌더링된 소재 클릭 시 발생
slotRequestFailed	광고 slot에 광고 요청이 실패하면 발생

nestads.pubAds().addEventListener("slotOnload", (event) => {
  console.log("Slot has been loaded:");
  console.log(event);
});

광고 이벤트 리스너 해제

• nestads.pubAds().removeEventListener() 를 사용하여 이벤트 리스너를 해제할 수 있습니다.

---

광고 요청 에러 발생시 처리

nestads.display() 및 nestads.load() 를 통해 광고 요청을 진행하고, 이 후 에러 발생 시 이벤트 핸들러를 등록해 처리할 수 있습니다.

• nestads.pubAds().addEventListener()에 slotRequestFailed 를 등록합니다.

• 발생할 수 있는 에러 종류 및 코드는 Reference 를 참고해주세요.

nestads.pubAds().addEventListener("slotRequestFailed", (event) => {
  if (event.error.code === 3000) {
    // 유효한 광고가 없을 때 처리
  }
});