화면 모드
보상형 광고
AppLovin MAX의 **서버 콜백(S2S)**으로 광고를 끝까지 봤는지 확인한 뒤 보상해요. 앱의 "보상 받음" 이벤트만 믿지 않으므로, 조작으로 보상을 받을 수 없어요.
MAX 설정
- 운영 담당자에게 MAX 대시보드의 S2S 이벤트 키를 전달하면, 게임 전용 콜백 주소를 받아요.
- MAX 대시보드에서 보상형 광고 단위마다 Server Side Callback URL에 그 주소를 넣어요.
- 앱에서 광고 SDK의 User ID를 유저의
player_id로 설정해요. SDK는 로그인할 때 자동으로 설정해요.
콜백 주소 형식 (게임 코드만 다름):
text
https://game-api.webzenk.kr/v1/ads/callback/applovin/{게임코드}?user_id={USER_ID}&event_id={EVENT_ID}&token={EVENT_TOKEN}&custom_data={CUSTOM_DATA}&placement={PLACEMENT}&ad_unit={AD_UNIT_ID}&network={NETWORK_NAME}&amount={AMOUNT}¤cy={CURRENCY}흐름
- 광고를 보여 주기 전에 보상 세션을 만들어요. 하루 한도를 넘었으면 여기서 알려 줘요(
AD_DAILY_CAP) — 광고를 띄우지 마세요. - 세션의
custom_data를 넣어서 광고를 재생해요. - 광고가 끝나면 세션 상태를 확인해요. 콜백은 보통 몇 초 안에 와요.
rewarded가 되면 보상을 지급해요. - 지급 완료를 보고해요 →
claimed
콜백이 늦게 와서 앱이 기다리다 끝냈더라도, 다음 로그인 때 "콜백은 왔지만 지급 안 된 보상"을 받아서 지급하면 돼요. SDK는 이 과정을 자동으로 해요.
보상 상태
| 상태 | 뜻 |
|---|---|
pending | 광고사 확인(콜백) 대기 |
rewarded | 확인됨, 지급 전 |
claimed | 지급 완료 |
rejected | 거부 (한도 초과, 다른 유저 세션 등) |
expired | 콜백 없이 세션 만료 (기본 1시간) |
하루 보상 횟수는 게임별 설정이에요(기본 placement별 20회).
HTML5 플랫폼 광고
삼성 Instant Plays 등 HTML5 플랫폼 광고는 서버 콜백이 없어서, SDK가 알려 주는 결과(rewarded)로 게임이 판단해요.
관련 문서 · 광고 API · Unity + MAX · HTML5 광고