React Native의 보상형 광고 통합

필수 조건

• 앱에 React 네이티브 플러그인 올바르게 연동했는지 확인합니다. 통합은 여기 설명되어 있습니다.
• 레벨플레이 초기화 API 사용하여 SDK를 초기화해야 합니다.
• 레벨플레이 대시보드에서 AdUnitID를 찾습니다.

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

import {    LevelPlayRewardedAd,    type LevelPlayRewardedAdListener,    type LevelPlayAdInfo,    type LevelPlayAdError,    type LevelPlayReward} from 'Mediationconst [rewardedAd, setRewardedAd] = useState<LevelPlayRewardedAd>(new LevelPlayRewardedAd('YOUR_AD_UNIT_ID'))useEffect(() => {    const 리스너: LevelPlayRewardedAdListener = {        onAdLoaded: (adInfo: LevelPlayAdInfo) => {            // Provided when the ad is successfully loaded        },        onAdLoadFailed: (error: LevelPlayAdError) => {            // Provided when the ad fails to load. 광고 유닛 정보가 포함됩니다.        },        onAdInfoChanged(adInfo: LevelPlayAdInfo) => {            // Provided when the ad info is updated. 다른 광고가 로드되었을 때 사용 가능하며 더 높은 CPM/Rate를 포함합니다.        },        onAdDisplayed: (adInfo: LevelPlayAdInfo) => {            // Provided when the ad is displayed        },        onAdDisplayFailed(오류: LevelPlayAdError, adInfo: LevelPlayAdInfo) => {            // Provided when the ad fails to be displayed        },        onAdClicked: (adInfo: LevelPlayAdInfo) => {            // Provided when the user clicks on the ad        },        onAdClosed: (adInfo: LevelPlayAdInfo) => {            // Provided when the ad is closed        },        onAdRewarded: (보상: LevelPlayReward, adInfo: LevelPlayAdInfo) => {            // Provided when the ad is rewarded. 광고 유닛 정보와 보상 정보가 포함됩니다.        }    };    rewardedAd.setListener(listener);}, [rewardedAd]);

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

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

필수 조건

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

베스트 프랙티스

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

API 구조, 구조체

getReward

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 placementrewardedAd.showAd();// Show ad with placementrewardedAd.showAd('YOUR_PLACEMENT');

광고 확인 준비

// Check that ad is ready and that the placement is not capped (both APIs are async)const isReady = await rewardedAd.isAdReady();const isPlacementCapped = await LevelPlayRewardedAd.isPlacementCapped('YOUR_PLACEMENT');if (isReady && !isPlacementCapped) {  await rewardedAd.showAd('YOUR_PLACEMENT');}

동적 UserId

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

  dynamicUserId

  파라미터가 표시됩니다.

LevelPlay.setDynamicUserId("userId");

사용자 보상

onAdRewarded: (보상: LevelPlayReward, adInfo: LevelPlayAdInfo) => {    // Provided when the ad is rewarded. 광고 유닛 정보와 보상 정보가 포함됩니다.}

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

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

import {    LevelPlayRewardedAd,    type LevelPlayRewardedAdListener,    type LevelPlayAdInfo,    type LevelPlayAdError,    type LevelPlayReward} from 'Mediationconst [rewardedAd, setRewardedAd] = useState<LevelPlayRewardedAd>(new LevelPlayRewardedAd('YOUR_AD_UNIT_ID'))const 리스너: LevelPlayRewardedAdListener = {    onAdLoaded: (adInfo: LevelPlayAdInfo) => {        // Implement your logic here, for example showing the ad        rewardedAd.showAd()    },    onAdLoadFailed: (error: LevelPlayAdError) => {        // Implement your logic here...    },    onAdInfoChanged(adInfo: LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdDisplayed: (adInfo: LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdDisplayFailed(오류: LevelPlayAdError, adInfo: LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdClicked: (adInfo: LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdClosed: (adInfo: LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdRewarded: (보상: LevelPlayReward, adInfo: LevelPlayAdInfo) => {        // Implement your logic here...    }};useEffect(() => {    rewardedAd.setListener(listener)    rewardedAd.loadAd()}, []);// Rest of component ...// End of component ...

레벨플레이 Mediation 데모 앱

다음 단계

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