---
url: https://developers.webzenk.kr/sdk/unity/ads.md
---
# 보상형 광고 (AppLovin MAX)

## 준비

1. **AppLovin MAX Unity Plugin**을 설치하고 Integration Manager에 SDK Key를 넣습니다.
2. Package Manager → WK Game API → Samples → **AppLovin MAX 연동**을 Import 합니다. `WKMaxAdNetwork`가 Assets에 생깁니다.
3. MAX 대시보드에서 보상형 광고 단위마다 **Server Side Callback URL**을 등록합니다 — [MAX 설정](/guide/ads#max-설정)

```csharp
var api = await WKGameApi.InitAsync(new WKGameApiOptions
{
    AppKey = "…", AppSecret = "…",
    AdNetwork = new WKMaxAdNetwork(rewardedAdUnitId: "…", interstitialAdUnitId: "…"),
});
api.Ads.RewardHandler = async r => { save.gold += 10; await api.Storage.SetAsync("save", save); };
await api.Auth.LoginAsync();   // MAX User ID = player_id 자동 설정, 늦게 온 보상 자동 지급
```

## 보여 주기

```csharp
var r = await api.Ads.ShowRewardedAsync("daily_chest");
if (!r.Rewarded) Debug.Log(r.Reason);

await api.Ads.ShowInterstitialAsync();
api.Ads.Preload(WKAdFormat.Rewarded);
bool ready = api.Ads.IsReady(WKAdFormat.Rewarded);
```

| `Reason` | 뜻 |
|---|---|
| `not_ready` | 광고 로드 전 (SDK가 로드를 시작함) |
| `daily_cap` | 오늘 보상 한도 도달 — 광고를 띄우지 않았습니다 |
| `show_error` | 재생 실패 |
| `pending` | 광고는 봤지만 서버 콜백이 아직 — 다음 로그인 때 자동 지급 |
| `rejected` | 서버가 거부 |

## 동작 방식

1. 서버에 보상 세션을 만들고(`daily_cap`이면 여기서 끝), 세션 값을 `customData`로 넣어 광고를 재생합니다.
2. 광고가 닫히면 서버 콜백을 최대 8초(`api.Ads.CallbackWait`) 기다립니다.
3. 확인되면 **RewardHandler**로 지급하고 서버에 완료를 보고합니다.

보상은 MAX 서버가 게임 API에 알려 줄 때만 지급됩니다. 클라이언트 조작으로 보상을 받을 수 없습니다.
