화면 모드
보상형 광고 (AppLovin MAX)
준비
- AppLovin MAX Unity Plugin을 설치하고 Integration Manager에 SDK Key를 넣어요.
- Package Manager → WK Game API → Samples → AppLovin MAX 연동을 Import 해요.
WKMaxAdNetwork가 Assets에 생겨요. - MAX 대시보드에서 보상형 광고 단위마다 Server Side Callback URL을 등록해요 — 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 | 서버가 거부 |
동작 방식
- 서버에 보상 세션을 만들고(
daily_cap이면 여기서 끝), 세션 값을customData로 넣어 광고를 재생해요. - 광고가 닫히면 서버 콜백을 최대 8초(
api.Ads.CallbackWait) 기다려요. - 확인되면 RewardHandler로 지급하고 서버에 완료를 보고해요.
보상은 MAX 서버가 게임 API에 알려 줄 때만 지급돼요. 클라이언트 조작으로 보상을 받을 수 없어요.