Flutter의 보상형 광고 통합

필수 조건

• 앱에 Flutter 플러그인을 통합해야 합니다.
• 레벨플레이 초기화 API 사용하여 SDK를 초기화해야 합니다.
• 레벨플레이 대시보드에서 AdUnitID를 찾습니다.

보상형 광고 생성 및 이벤트 등록

onInitSuccess

final LevelPlayRewardedAd _rewardedAd = LevelPlayRewardedAd(adUnitId: [YOUR_AD_UNIT_ID]);@overridevoid initState() {    super.initState();    _rewardedAd.setListener(this);}// LevelPlayRewardedAdListener methods@overridevoid onAdLoaded(LevelPlayAdInfo adInfo) {}@overridevoid onAdLoadFailed(LevelPlayAdError error) {} @overridevoid onAdDisplayed(LevelPlayAdInfo adInfo) {}@overridevoid onAdDisplayFailed(LevelPlayAdError error, LevelPlayAdInfo adInfo) {}@override void onAdClosed(LevelPlayAdInfo adInfo) {}@overridevoid onAdClicked(LevelPlayAdInfo adInfo) {} @overridevoid onAdInfoChanged(LevelPlayAdInfo adInfo) {}@overridevoid onAdRewarded(LevelPlayReward reward, LevelPlayAdInfo adInfo) {}

레벨플레이 보상형 광고 광고 콜백

• onAdLoaded

  : 광고가 성공적으로 로드되면 제공됨

• onAdLoadFailed

  : 광고 로드 실패 시 제공됩니다. 광고 유닛 정보가 포함됩니다.

• onAdDisplayed

  : 광고가 표시될 때 제공됩니다. 이는 노출과 동일합니다.

• onAdDisplayFailed

  (선택 사항): 광고 표시 실패 시 제공됨

• onAdRewarded

  : 광고 보상형 광고 제공될 때 제공됩니다. 광고 유닛 정보와 보상 정보가 포함됩니다.

• onAdClicked

  (선택 사항): 사용자 광고를 클릭할 때 제공됨

• onAdClosed

  : 광고가 닫힐 때 제공됨

• onAdInfoChanged

  (선택 사항): 광고 정보가 업데이트될 때 제공됩니다. 다른 광고가 로드되었을 때 사용 가능하며 더 높은 CPM/Rate를 포함합니다.

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

필수 조건

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

베스트 프랙티스

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

API 구조, 구조체

getReward

• placementName

  : 레벨플레이 대시보드에 정의된 플레이스먼트의 고유 식별자. 광고 유닛의 기본 보상을 가져오는

  null

  전달.

초안 수립

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

보상 선택 로직 이해

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

UI 동적 업데이트

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

getReward API 구현 문제 해결

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

보상형 광고 로드

_rewardedAd.loadAd();

보상형 광고 표시

// Show ad without placement_rewardedAd.showAd();// Show ad with placement_rewardedAd.showAd(placement: [YOUR_PLACEMENT]);

광고 확인 준비

• isAdReady

  : 광고가 성공적으로 로드되고 광고 유닛이 제한되지 않으면 true를, 그렇지 않으면 false를 반환합니다.

• isPlacementCapped

  : 유효한 플레이스먼트가 제한되면 true를 반환합니다. 플레이스먼트가 유효하지 않거나 제한되지 않으면 이 API false를 반환합니다.

// Check that ad is ready and that the placement is not capped if(_rewardedAd.isAdReady() && !LevelPlayRewardedAd.isPlacementCapped([YOUR_PLACEMENT])) {     _rewardedAd.showAd(placement:[YOUR_PLACEMENT]);}

동적 UserId

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

  dynamicUserId

  파라미터가 표시됩니다.

LevelPlay.setDynamicUserId("userId");

사용자 보상

onAdRewarded

onAdRewarded

onAdClosed

onAdClosed

onAdRewarded

@overridevoid onAdRewarded(LevelPlayReward reward, LevelPlayAdInfo adInfo) {    // Implement logic to grant the reward to the user}

여러 광고 유닛 보상형 광고 API

IronSource

LevelPlayRewardedAd

loadRewardedVideo

loadAd

showRewardedVideo

showAd

isRewardedVideoPlacementCapped

isPlacementCapped

isRewardedVideoAvailable

isAdReady

placement.getRewardName

reward.name

placement.getRewardAmount

reward.amount

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

final LevelPlayRewardedAd _rewardedAd = LevelPlayRewardedAd(adUnitId: 'YOUR_AD_UNIT_ID');@overridevoid initState() {    super.initState();    _rewardedAd.setListener(this);    _rewardedAd.loadAd();}@overridevoid onAdRewarded(LevelPlayReward reward, LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdClicked(LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdClosed(LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdDisplayFailed(LevelPlayAdError error, LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdDisplayed(LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdInfoChanged(LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdLoadFailed(LevelPlayAdError error) {    // Implement your logic here...}@overridevoid onAdLoaded(LevelPlayAdInfo adInfo) {    // Implement your logic here, for example showing the ad    _rewardedAd.showAd();}// Rest of the widget// End of widget...