광고 이벤트 콜백 & 기타 API 가이드

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

노출형 광고 이벤트 콜백 API

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

Android

JS (Web)

iOS

API 설명

Android

JS (Web)

iOS

API 설명

onImpressed

onImpressed

didImpressAd

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

onClick

onClicked

didClickAd

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

onRewardRequested

onRewardRequested

didRequestRewardForAd

광고 리워드 요청이 시작할 때 호출합니다.

  • 리워드가 없는 경우는 리워드 요청을 하지 않아 호출하지 않습니다.

  • 광고 확인 시간이 너무 짧아 어뷰저로 판단되면 호출하지 않습니다.

onRewarded

onRewarded

didRewardForAd:withResult

  • 리워드 적립 요청에 대한 응답을 수신했을 때 호출합니다.

  • 이때, 호출 조건은 리워드 적립 성공 여부와는 무관합니다.

onParticipated

onParticipated

didParticipateAd

적립 요청 결과가 “성공” 혹은 “이미 적립 받음“이면 호출합니다.

액션형 광고 이벤트 콜백 API

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

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

Android & JS (Web)

Android API

JS (Web) API

설명

Android API

JS (Web) API

설명

onImpressed

onImpressed

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

onClick

onClicked

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

onRewardRequested

onRewardRequested

-

-

onRewarded

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

onParticipated

onParticipated

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

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

iOS

iOS API

설명

iOS API

설명

didImpressAd

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

didClickAd

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

didRequestRewardForAd

-

didRewardForAd:withResult

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

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

didParticipateAd

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