Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

아래 표에서 플랫봄별로 지원되는 액션형 광고 API를 확인할 수 있습니다.

Info

액션형 광고는 사용자의 참여 여부를 확인하기까지 시간이 걸리는 경우가 있습니다.

Android & JS (Web)

Android API

JS (Web) API

설명

onImpressed

onImpressed

광고 뷰가 50% 노출되면 호출하며, 광고마다 한 번만 호출합니다.

onClick

onClick

광고 뷰를 클릭하면 호출합니다.

onRewardRequested

onRewardRequested

-

-

onRewarded

사용자가 광고 뷰를 클릭하면 실제 참여 여부와 상관없이 호출합니다.

onParticipated

onParticipated

  • Android: 사용자가 광고를 확인하고 광고 지면으로 돌아오면 SDK가 버즈빌 서버에 참여 여부를 확인합니다. 사용자가 참여한 것으로 확인 된 경우에만 호출합니다. 단, 서버에서 이미 참여한 경우에는 불리지 않습니다.

  • JS (Web): 사용자가 광고 뷰를 클릭하면 실제 참여 여부와 상관없이 호출합니다.

...

iOS API

설명

didImpressAd

광고 뷰가 50% 노출되면 호출하며, 광고마다 한 번만 호출합니다.

didClickAd

광고 뷰를 클릭하면 호출합니다.

didRequestRewardForAd

-

didRewardForAd:withResult

  • Feed 지면으로 돌아왔을 때, 참여 여부 확인 요청을 버즈빌 서버로 보내고, 참여 여부 확인 요청에 대한 응답을 수신했을 때 호출합니다.

  • 호출 조건은 참여 여부와는 무관합니다.

didParticipateAd

사용자가 참여한 것으로 확인된 경우에만 호출합니다. 단, 서버에서 이미 참여한 경우에는 호출되지 않습니다.

...

사용자가 딥링크 URL을 사용하는 광고를 클릭하면 launcher가 커스텀 런처가 열리게 됩니다. 그러므로 launcher 커스텀 런처의 사용 여부에 따라 전달되는 파라미터 값을 통해 광고가 딥링크 URL을 사용하고 있는지 확인할 있습니다.

Info

커스텀 런처에 대한 자세한 내용은 BuzzAd SDK 연동 가이드를 참고하세요.

플랫폼

파라미터 필드

전달받는 값

Android

nativeAd.getAd().getCreative().isDeeplink()

  • false: 기본 값

  • true: 브라우저가 로딩되면 Goolge Play 스토어 또는 광고주 앱으로 이동하며, 이에 대한 적절한 처리가 필요합니다.

iOS

ad.creative.isDeeplink

클릭 후킹 API

아래 표의 메서드를 통해 사용자가 광고를 클릭할 때의 이벤트를 후킹(hooking)할 수 있습니다.

플랫폼

메서드

Android

onClickEvent : NativeAdView 객체 하위에 포함되는 메서드입니다.

iOS

shouldClickAd : AdView 객체 하위에 포함되는 메서드입니다.