Skip to content

보상형 광고 ​

AppLovin MAX의 **서버 콜백(S2S)**으로 광고를 끝까지 봤는지 확인한 뒤 보상해요. 앱의 "보상 받음" 이벤트만 믿지 않으므로, 조작으로 보상을 받을 수 없어요.

MAX 설정 ​

  1. 운영 담당자에게 MAX 대시보드의 S2S 이벤트 키를 전달하면, 게임 전용 콜백 주소를 받아요.
  2. MAX 대시보드에서 보상형 광고 단위마다 Server Side Callback URL에 그 주소를 넣어요.
  3. 앱에서 광고 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}&currency={CURRENCY}

흐름 ​

  1. 광고를 보여 주기 전에 보상 세션을 만들어요. 하루 한도를 넘었으면 여기서 알려 줘요(AD_DAILY_CAP) — 광고를 띄우지 마세요.
  2. 세션의 custom_data를 넣어서 광고를 재생해요.
  3. 광고가 끝나면 세션 상태를 확인해요. 콜백은 보통 몇 초 안에 와요. rewarded가 되면 보상을 지급해요.
  4. 지급 완료를 보고해요 → claimed

콜백이 늦게 와서 앱이 기다리다 끝냈더라도, 다음 로그인 때 "콜백은 왔지만 지급 안 된 보상"을 받아서 지급하면 돼요. SDK는 이 과정을 자동으로 해요.

보상 상태 ​

상태뜻
pending광고사 확인(콜백) 대기
rewarded확인됨, 지급 전
claimed지급 완료
rejected거부 (한도 초과, 다른 유저 세션 등)
expired콜백 없이 세션 만료 (기본 1시간)

하루 보상 횟수는 게임별 설정이에요(기본 placement별 20회).

HTML5 플랫폼 광고

삼성 Instant Plays 등 HTML5 플랫폼 광고는 서버 콜백이 없어서, SDK가 알려 주는 결과(rewarded)로 게임이 판단해요.

관련 문서 · 광고 API · Unity + MAX · HTML5 광고

© WEBZEN K. All rights reserved.