이 가이드에서는 Android, iOS 및 Web용 BuzzAd SDK로 연동하는 광고의 노출, 클릭, 참여 등 이벤트에 대한 콜백의 정보와 딥링크 URL 광고에 대한 파라미터 전달, 광고와 관련된 API를 확인할 수 있습니다.기타 를 확인할 수 있습니다.

노출형 광고 이벤트 콜백 API

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

Android	JS (Web)	iOS	API 설명
`onImpressed`	`onImpressed`	`didImpressAd`	광고 뷰가 50% 노출되면 호출하며, 광고마다 한 번만 호출합니다.
`onClick`	`onClick`	`didClickAd`	광고 뷰를 클릭하면 호출합니다.
`onRewardRequested`	`onRewardRequested`	`didRequestRewardForAd`	광고 리워드 요청이 시작할 때 호출합니다. 리워드가 없는 경우는 리워드 요청을 하지 않아 호출하지 않습니다. 광고 확인 시간이 너무 짧아 어뷰저로 판단되면 호출하지 않습니다.
`onRewarded`	`onRewarded`	`didRewardForAd:withResult`	리워드 적립 요청에 대한 응답을 수신했을 때 호출합니다. 이때, 호출 조건은 리워드 적립 성공 여부와는 무관합니다.
`onParticipated`	`onParticipated`	`didParticipateAd`	적립 요청 결과가 “성공” 혹은 “이미 적립 받음“이면 호출합니다.

액션형 광고 이벤트 콜백 API

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

Android API	JS (Web) API	설명
`onImpressed`	`onImpressed`	광고 뷰가 50% 노출되면 호출하며, 광고마다 한 번만 호출합니다.
`onClick`	`onClick`	광고 뷰를 클릭하면 호출합니다.
-	`onRewarded`	사용자가 광고 뷰를 클릭하면 실제 참여 여부와 상관없이 호출합니다.
`onParticipated`	`onParticipated`	Android: 사용자가 광고를 확인하고 광고 지면으로 돌아오면 SDK가 버즈빌 서버에 참여 여부를 확인합니다. 사용자가 참여한 것으로 확인 된 경우에만 호출합니다. 단, 서버에서 이미 참여한 경우에는 불리지 않음) JS (Web): 사용자가 광고 뷰를 클릭하면 실제 참여 여부와 상관없이 호출합니다.

iOS API	설명
`didImpressAd`	광고 뷰가 50% 노출되면 호출하며, 광고마다 한 번만 호출합니다.
`didClickAd`	광고 뷰를 클릭하면 호출합니다.
`didRewardForAd:withResult`	Feed 지면으로 돌아왔을 때, 참여 여부 확인 요청을 버즈빌 서버로 보내고, 참여 여부 확인 요청에 대한 응답을 수신했을 때 호출합니다. 호출 조건은 참여 여부와는 무관합니다.
`didParticipateAd`	사용자가 참여한 것으로 확인된 경우에만 호출합니다. 단, 서버에서 이미 참여한 경우에는 호출되지 않습니다.

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

플랫폼	파라미터 필드	전달받는 값
Android	`nativeAd.getAd().getCreative().isDeeplink()`	false: 기본 값 true: 브라우저가 로딩되면 Goolge Play 스토어 또는 광고주 앱으로 이동하며, 이에 대한 적절한 처리가 필요합니다.
iOS	`ad.creative.isDeeplink`

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

플랫폼	메서드
Android	`onClickEvent` : `NativeAdView` 객체 하위에 포함되는 메서드입니다.
iOS	`shouldClickAd` : `AdView` 객체 하위에 포함되는 메서드입니다.