Skip to content

보상형 광고 (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 설정
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에 알려 줄 때만 지급돼요. 클라이언트 조작으로 보상을 받을 수 없어요.

© WEBZEN K. All rights reserved.