메인 콘텐츠로 건너뛰기

개요

보상형 광고는 사용자가 광고를 끝까지 시청하면 보상을 받는 형태의 풀스크린 광고입니다. 게임 내 아이템, 추가 콘텐츠 등의 보상을 제공할 때 사용합니다.

주요 특징

  • 화면 전체를 덮는 풀스크린 광고
  • 동영상 광고 지원
  • 보상 이벤트 콜백 제공
  • 보상 타입과 수량 정보 전달
  • 로드와 표시를 분리하여 유연한 타이밍 제어
개발 환경에서는 테스트 유닛 ID를 사용하세요: PUBLIC_TEST_UNIT_ID_REWARDED

AdropRewardedAd

생성자

파라미터

속성

메서드


기본 사용법


AdropRewardedListener

보상형 광고 이벤트를 처리하는 리스너입니다.

콜백 함수

콜백 설명


보상 처리

보상 콜백

onAdEarnRewardHandler 콜백에서 보상 정보를 받아 처리합니다.

보상 지급 시점

보상은 반드시 onAdEarnRewardHandler 콜백에서 지급해야 합니다. 광고가 완전히 시청되기 전에 닫히면 이 콜백이 호출되지 않습니다.

광고 재생성

보상형 광고는 일회성입니다. 한 번 표시된 광고는 다시 표시할 수 없으므로, 새로운 광고를 로드하려면 인스턴스를 재생성해야 합니다.

에러 처리


모범 사례

1. 미리 로드하기

사용자가 보상을 요청할 때 즉시 광고를 보여줄 수 있도록 미리 로드합니다.

2. 사용자에게 보상 안내

광고 시청 전 받을 수 있는 보상을 명확히 안내합니다.

3. 광고 가용성 표시

광고가 준비되었을 때만 보상 버튼을 활성화합니다.

4. 보상 지급 신뢰성

보상 지급은 서버에서 검증하는 것이 좋습니다.

5. 리소스 관리

사용하지 않는 광고 인스턴스는 반드시 해제하세요.

전체 예제


서버 측 검증 (SSV)

서버 측 검증을 사용하면 서버에서 보상 지급을 안전하게 검증할 수 있습니다. 광고가 로드될 때 서버 간 콜백에 userIdcustomData를 포함하려면 ServerSideVerificationOptions를 설정하세요.
서버에서 SSV 콜백을 수신하려면 콘솔 [관리] > [연동] > 리워드 광고 SSV에서 콜백 URL을 등록해야 해요. 여기서 설정한 userIdcustomData는 해당 URL로 전송되는 암호화 페이로드에 포함됩니다. 페이로드 복호화 및 설정 방법은 리워드 광고 SSV 가이드를 참고하세요.

설정

load()를 호출하기 전에 serverSideVerificationOptions를 설정하세요.

ServerSideVerificationOptions

전체 예제

serverSideVerificationOptionsload() 호출 전에 설정해야 합니다. load() 이후에 설정한 옵션은 해당 광고 요청에 적용되지 않습니다.

백필 광고

백필 광고가 활성화된 경우, 직광고가 없을 때 자동으로 백필 광고가 로드됩니다. 에러 코드를 통해 백필 관련 상태를 처리할 수 있습니다.
백필 광고를 사용하려면 네이티브 플랫폼에 백필 의존성을 추가해야 합니다. 시작하기를 참고하세요.

다음 단계

팝업 광고

팝업 형태로 표시되는 광고 구현하기

타겟팅

맞춤형 광고를 위한 타겟팅 설정하기

레퍼런스

타입, 메서드, 에러 코드 참고하기