Unity 패키지 보상형 광고 통합

필수 조건

• 레벨플레이 Unity 패키지를 애플리케이션 올바르게 연동했는지 확인합니다. 통합은 여기 설명되어 있습니다.
• 레벨플레이 초기화 API 사용하여 SDK를 초기화해야 합니다.
• 레벨플레이 대시보드에서 AdUnitID를 찾습니다.

보상형 광고 오브젝트 생성

// Create Rewarded Ad object LevelPlayRewardedAd rewardedAd = new LevelPlayRewardedAd(rewardedAdUnitId);

LevelPlayRewardedAd

Config

// 선택적 구성 파라미터 사용LevelPlayRewardedAd(string adUnitId, Config config = null)

Config

adUnitId

단가 기준으로 제작

LevelPlayRewardedAd

Config

// Create Rewarded Ad object with Price Floor in config.var configBuilder = new LevelPlayRewardedAd.Config.Builder();configBuilder.SetBidFloor(1.0); // Minimum bid price in USDvar rvConfig = configBuilder.Build();LevelPlayRewardedAd RewardedAd = new LevelPlayRewardedAd(RewardedAdUnitId, rvConfig);

보상형 광고 이벤트 등록하기

• 보상형 광고 광고를 로드하기 전에 리스너를 설정하는 것이 좋습니다.
• 각 보상형 광고 광고에는 고유한 리스너 구현이 있어야 합니다.
• 콜백은 메인 스레드 실행됩니다.

// Register to Rewarded eventsRewardedAd.OnAdLoaded += RewardedOnAdLoadedEvent;RewardedAd.OnAdLoadFailed += RewardedOnAdLoadFailedEvent;RewardedAd.OnAdDisplayed += RewardedOnAdDisplayedEvent;RewardedAd.OnAdDisplayFailed += RewardedOnAdDisplayFailedEvent;RewardedAd.OnAdRewarded += RewardedOnAdRewardedEvent;RewardedAd.OnAdClosed += RewardedOnAdClosedEvent;// OptionalRewardedAd.OnAdClicked += RewardedOnAdClickedEvent;RewardedAd.OnAdInfoChanged += RewardedOnAdInfoChangedEvent;// Implement the eventsvoid RewardedOnAdLoadedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdLoadFailedEvent(LevelPlayAdError error) {}void RewardedOnAdDisplayedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) {}void RewardedOnAdRewardedEvent(LevelPlayAdInfo adInfo, LevelPlayReward adReward) {}void RewardedOnAdClosedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdClickedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdInfoChangedEvent(LevelPlayAdInfo adInfo) {}

레벨플레이 광고 정보

보상형 광고 세부 정보 가져오기

필수 조건

• SDK Initialization: initSDK를 호출 onInitializationSuccess 콜백 기다려 보상 데이터가 캐싱되었는지 확인합니다.
• 광고 오브젝트 인스턴스: API 호출하기 전에 유효한 광고 유닛 ID로 보상형 광고 광고 오브젝트 인스턴스화.
• Minimum SDK Version: 레벨플레이 SDK 버전 8.1.0 이상(네이티브 또는 Unity 패키지)을 사용합니다.

베스트 프랙티스

• 초기화 성공 시 호출: getReward를 호출 가장 적합한 시점은 초기화 성공 리스너 내부입니다. 이렇게 하면 사용자 화면에 진입할 때마다 UI가 준비됩니다.
• 빈 상태 확인: UI를 업데이트하기 전에 항상 이 양을 0 이상으로 확인해야 합니다. 이렇게 하면 초기화 중에 네트워크 오류가 발생하는 경우 원활한 사용자 경험 보장할 수 있습니다.
• 플레이스먼트 정밀도: getReward("placementName")에 사용된 문자열이 레벨플레이 대시보드에 정의된 이름과 정확히 일치하는지 확인합니다.

API 구조, 구조체

getReward

public LevelPlayReward getReward(String placementName)

null

초안 수립

• 통합 기능: 보상 데이터는 초기 SDK 설정 중에 가져오기 때문에 API 호출 순간적이며 네트워크 요청이 필요하지 않습니다.
• 에디터 설정: 앱이 레벨플레이 SDK와 연동되면 API 즉시 사용할 수 있습니다. 이 기능을 테스트하려면 추가 에셋이나 플러그인이 필요하지 않습니다.

보상 선택 로직 이해

• 플레이스먼트 레벨: 호출 유효한 플레이스먼트 이름이 제공되면 SDK는 대시보드에서 해당 플레이스먼트에 대해 설정된 특정 보상을 반환합니다.
• 광고 유닛 레벨: 플레이스먼트 이름이 null 찾을 수 없는 경우, SDK는 광고 유닛에 정의된 기본 보상으로 폴백합니다.
• 폴백 상태: 초기화가 완료되기 전에 API 호출되면 빈 문자열 이름과 금액이 0인 보상 오브젝트 반환합니다.

UI 동적 업데이트

• 확인 금액: UI 컴포넌트를 업데이트하기 전에 항상 reward.amount > 0을 확인해야 합니다.
• 이벤트 기반 업데이트: 초기화 성공 리스너 내에서 API 호출 사용자 화면에 진입할 때 UI가 정확한지 확인합니다.
• 대소문자 구분: 코드의 플레이스먼트 이름 문자열이 레벨플레이 대시보드와 정확히 일치하는지 확인합니다. 일치하지 않는 문자열은 광고 유닛 폴백 트리거합니다.

보상 데이터 검색 예시

/// <summary> /// Retrieves the reward associated with the ad. /// Use this method to obtain the reward configured for the ad unit or placement. The /// placement-specific reward takes precedence over the ad unit reward when a valid placement name /// is provided. /// </summary> /// <param name="placement">The placement name to retrieve the reward for, or null to use the ad unit's reward.</param> /// <returns>A <see cref="LevelPlayReward"/> object. 실패 시 빈 보상을 반환합니다(이름: "" 및 금액: 0).</returns> LevelPlayReward reward = rewardedAd.getReward("battle_screen");// Update UI dynamicallyif (reward.Amount > 0 && !string.IsNullOrEmpty(reward.Name)) {    rewardButton.text = $"{reward.Amount} {reward.Name} 을 클릭합니다";} else {    rewardButton.text = "보상 관찰";}

getReward API 구현 문제 해결

• 보상 금액은 0을 반환합니다. 이는 일반적으로 onInitializationSuccess 콜백 전에 API 호출된 경우에 발생합니다. 보상을 쿼리하기 전에 SDK가 완전히 준비되었는지 확인합니다.
• 잘못된 보상 유형 표시: 여러 플레이스먼트가 있는지 확인합니다. 플레이스먼트 이름의 철자가 잘못되면 SDK는 특정 플레이스먼트 보상 대신 기본 광고 유닛 보상으로 설정됩니다.

보상형 광고 로드

// Load rewarded adRewardedAd.LoadAd();

보상형 광고 표시

• 플레이스먼트를 사용하는 경우 아래의 플레이스먼트 섹션에 표시된 대로 ShowAd API에서 플레이스먼트 이름을 전달합니다.
• 광고가 사용자 성공적으로 표시되면 로딩 단계를 반복하여 다른 광고를 로드할 수 있습니다.

// Show ad without placementRewardedAd.ShowAd();// Show ad with placementRewardedAd.ShowAd(placementName: "placementName");

광고가 준비되었는지 확인

// Check that ad is ready and that the placement is not cappedif (RewardedAd.IsAdReady() && !LevelPlayRewardedAd.IsPlacementCapped(placementName)){    RewardedAd.ShowAd(placementName);}

Placements

// Check that ad is ready and that the placement is not cappedif (RewardedAd.IsAdReady() && !LevelPlayRewardedAd.IsPlacementCapped(placementName)){    RewardedAd.ShowAd(placementName);}

동적 UserId

• 문자열 값은 영숫자 1~64자로 구성되어야 합니다.
• 보상 세부 정보가 포함된 콜백 URL에

  dynamicUserId

  파라미터가 표시됩니다.

LevelPlay.SetDynamicUserId("userId");

사용자 보상

// Subscribe to the OnAdRewarded eventRewardedAd.OnAdRewarded += (adInfo, adReward) =>{    // Grant the reward to the user    Debug.Log($"Ad Completed: {adInfo.PlacementName}, Reward: {adReward.Name} - {adReward.Amount}");    GrantReward(adReward.Name, adReward.Amount);};// Example method to process the rewardprivate void GrantReward(문자열 rewardName, int rewardAmount){    // TODO: 로직을 구현하여 사용자 보상을 부여합니다.    Debug.Log($"Granting reward: {rewardName} with amount: {rewardAmount}");}

보상형 광고 광고의 전체 구현 예시

public class RewardedAdSample {    private LevelPlayRewardedAd RewardedAd;    void CreateRewardedAd() {        // Create RewardedAd instance        RewardedAd = new LevelPlayRewardedAd("RewardedAdUnitId");        // Subscribe RewardedAd events        RewardedAd.OnAdLoaded += RewardedOnAdLoadedEvent;        RewardedAd.OnAdLoadFailed += RewardedOnAdLoadFailedEvent;        RewardedAd.OnAdDisplayed += RewardedOnAdDisplayedEvent;        RewardedAd.OnAdDisplayFailed += RewardedOnAdDisplayFailedEvent;        RewardedAd.OnAdClicked += RewardedOnAdClickedEvent;        RewardedAd.OnAdClosed += RewardedOnAdClosedEvent;        RewardedAd.OnAdRewarded += RewardedOnAdRewardedEvent;        RewardedAd.OnAdInfoChanged += RewardedOnAdInfoChangedEvent;    }    void LoadRewardedAd() {        // Load or reload RewardedAd        RewardedAd.LoadAd();    }    void ShowRewardedAd() {        // Show RewardedAd, check if the ad is ready before showing        if (RewardedAd.IsAdReady()) {            RewardedAd.ShowAd();        }    }    // Implement RewardedAd events    void RewardedOnAdLoadedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdLoadFailedEvent(LevelPlayAdError error) { }    void RewardedOnAdClickedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdDisplayedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) { }    void RewardedOnAdClosedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdRewardedEvent(LevelPlayAdInfo adInfo, LevelPlayReward adReward) { }    void RewardedOnAdInfoChangedEvent(LevelPlayAdInfo adInfo) { }}

레벨플레이 Mediation 데모 앱

다음 단계

• Mediation Networks 추가
• 인터스티셜 광고
• 배너 광고