---
url: https://developers.webzenk.kr/guide/ads.md
---
# 보상형 광고

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회).

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

**관련 문서** · [광고 API](/api/ads) · [Unity + MAX](/sdk/unity/ads) · [HTML5 광고](/sdk/html5/iap-ads)
