전면 광고

전면 광고는 게임 레벨 전환이나 목표 작업 완료와 같은 자연스러운 중단 시 앱 콘텐츠 내에 삽입되는 전체 화면 광고 형식입니다.

앱이 전면 광고를 표시할 때, 사용자는 광고를 클릭하여 광고주 사이트로 이동하거나 광고를 닫고 앱으로 돌아갈 수 있습니다.

전면 광고 노출 중에는 사용자의 관심이 전적으로 광고에 집중되므로 해당 노출에 대한 비용이 증가합니다.

표시 예

이 가이드는 React Native 앱에 전면 광고를 통합하는 과정을 다룹니다. 코드 샘플과 지침 외에도 형식별 권장 사항 및 추가 자료에 대한 링크가 포함되어 있습니다.

사전 준비

빠른 시작에 설명된 Yandex Mobile Ads React Native 플러그인 통합 단계를 수행하세요.
최신 Yandex Mobile Ads React Native 플러그인 버전을 사용하고 있는지 확인하세요. 중재를 사용하는 경우, 최신 단일 빌드 버전으로 업데이트하세요.

실행

전면 광고 통합을 위한 주요 단계:

InterstitialAdLoader를 생성합니다.
AdRequestConfiguration 객체를 사용하여 광고 로드 매개변수를 설정합니다.
InterstitialAd 객체를 로드합니다.
광고의 콜백 함수를 설정합니다.
InterstitialAd 객체를 표시합니다.

전면 광고 통합의 특징

loadAd 메서드가 오류를 반환하면 새로운 광고를 다시 로드하려고 하지 마세요. 다른 옵션이 없는 경우, 광고 로드 재시도 횟수를 제한하세요. 이렇게 하면 제한이 있는 경우 지속적인 실패 요청 및 연결 문제를 방지할 수 있습니다.

광고 로드

전면 광고를 로드하려면 InterstitialAdLoader 객체를 생성하세요. 이를 수행하려면 InterstitialAdLoader.create() 메서드를 호출합니다.

AdRequestConfiguration 클래스 인스턴스를 생성하려면 Partner Interface(adUnitId)의 배치 ID가 필요합니다.

AdRequestConfiguration 객체를 생성할 때 사용자의 관심사, 페이지 컨텍스트, 위치 및 기타 추가 데이터를 제공하여 광고 요청 매개변수를 확장할 수 있습니다. 광고 요청에 추가된 컨텍스트는 광고 품질을 크게 향상할 수 있습니다.

전면 광고를 로드하려면 InterstitialAdLoader 클래스 객체의 loadAd 메서드를 호출합니다.

아래 예시는 전면 광고를 로드하는 방법을 보여줍니다.

let loader = await InterstitialAdLoader.create()
    .catch((error) => {
        // 오류를 적절하게 처리
        return;
    });
if (!loader) {
    return;
}
let adRequestConfiguration = new AdRequestConfiguration(
    'R-M-XXXXXX-Y', // 디버그의 경우 'demo-interstitial-yandex'를 사용할 수 있습니다
    '20',
    'context-query',
    ['context-tag'],
    Gender.Female,
    new Location(55.734202, 37.588063)
);
let ad = await loader.loadAd(adRequestConfiguration)
    .then((ad) => {
        // 광고가 성공적으로 로드됨
        return ad;
    })
    .catch((error) => {
        // 오류를 적절하게 처리
        return;
    });

광고 표시

전면 광고는 앱 사용이 자연스럽게 중단되는 시점에 표시되어야 합니다. 이에 대한 좋은 예시로는 게임 레벨 사이에 발생하는 노출이나 파일 다운로드와 같이 사용자가 작업을 완료했을 때가 있습니다.

전면 광고의 수명 주기 이벤트를 추적하려면 InterstitialAd 클래스 객체에 대한 콜백 함수를 설정하세요.

전면 광고를 표시하려면 show() 메서드를 사용하세요.

ad.onAdShown = () => {
    console.log('Did show');
};
ad.onAdFailedToShow = (error) => {
    console.log(`Did fail to show with error: ${JSON.stringify(error)}`);
};
ad.onAdClicked = () => {
    console.log('Did click');
};
ad.onAdDismissed = () => {
    console.log('Did dismiss');
};
ad.onAdImpression = (impressionData) => {
    console.log(`Did track impression: ${JSON.stringify(impressionData)}`);
};
ad.show();

전면 광고 통합 테스트

Android

iOS

광고 테스트를 위한 데모 광고 단위 사용

전면 광고 통합 및 앱 자체를 테스트하기 위해 테스트 광고를 사용하는 것이 좋습니다.

모든 광고 요청에 대해 테스트 광고가 반환되도록 보장하기 위해 특별한 데모 광고 배치 ID를 생성했습니다. 광고 통합을 확인하는 데 사용하세요.

데모 adUnitId: demo-interstitial-yandex.

Важно

애플리케이션을 스토어에 게시하기 전에 데모 광고 배치 ID를 Partner Interface에서 가져온 실제 ID로 교체해야 합니다.

사용 가능한 데모 광고 배치 ID 목록은 테스트용 데모 광고 단위 섹션에서 찾을 수 있습니다.

광고 통합 테스트

SDK의 내장 분석기를 사용하여 전면 광고 통합을 확인할 수 있습니다.

이 도구는 전면 광고가 제대로 통합되었는지 확인하고 로그에 상세한 보고서를 출력합니다. 보고서를 보려면 Android 애플리케이션 디버깅에 사용하는 Logcat 도구에서 "YandexAds" 키워드를 검색하세요.

adb logcat -v brief '*:S YandexAds'

통합에 성공하면 다음과 같은 메시지가 표시됩니다.

adb logcat -v brief '*:S YandexAds'
mobileads$ adb logcat -v brief '*:S YandexAds'
I/YandexAds(13719): [Integration] Ad type interstitital was integrated successfully

전면 광고 통합에 문제가 있는 경우, 문제에 대한 상세한 보고서와 해결 방법에 대한 권장 사항을 받게 됩니다.

광고 테스트를 위한 데모 광고 단위 사용

광고 통합 및 앱 자체를 테스트하기 위해 테스트 광고를 사용하는 것이 좋습니다.

모든 광고 요청에 대해 테스트 광고가 반환되도록 보장하기 위해 특별한 데모 광고 배치 ID를 생성했습니다. 광고 통합을 확인하는 데 사용하세요.

데모 adUnitId: demo-interstitial-yandex.

Важно

애플리케이션을 스토어에 게시하기 전에 데모 광고 배치 ID를 Partner Interface에서 가져온 실제 ID로 교체해야 합니다.

사용 가능한 데모 광고 배치 ID 목록은 테스트용 데모 광고 단위 섹션에서 찾을 수 있습니다.

광고 통합 테스트

네이티브 콘솔 도구를 사용하여 광고 통합을 테스트할 수 있습니다.

자세한 로그를 보려면 YMAMobileAds 클래스의 enableLogging 메서드를 호출하세요.

YMAMobileAds.enableLogging()

SDK 로그를 보려면 콘솔 도구로 이동하여 Subsystem = com.mobile.ads.ads.sdk를 설정하세요. 카테고리와 오류 수준별로 로그를 필터링할 수도 있습니다.

광고 통합에 문제가 있는 경우, 문제에 대한 상세한 보고서와 해결 방법에 대한 권장 사항을 받게 됩니다.

팁

광고 사전 로드

광고 로딩은 모바일 중재에 연결된 광고 네트워크 수와 사용자의 인터넷 속도에 따라 몇 초가 걸릴 수 있습니다. 광고를 표시하기 전에 미리 로드하는 것을 권장합니다.

광고가 필요할 때 즉시 표시할 수 있도록 loadAd 메서드를 미리 호출합니다.

현재 광고를 제공한 직후 다음 광고를 미리 로드하기 위해 이 프로세스를 onAdDismissed 이벤트에 바인딩할 수 있습니다.

표시될 가능성이 낮은 너무 많은 화면에 광고를 캐시하면 광고 효과가 떨어질 수 있습니다. 예를 들어 사용자가 세션당 2~3개의 게임 레벨을 완료하는 경우, 6~7개의 화면에 광고를 캐시하면 안 됩니다. 광고 가시성이 감소할 수 있으며, 광고 시스템이 앱의 우선순위를 낮출 수 있습니다.

앱에 적절한 균형을 찾을 수 있도록 파트너 인터페이스에서 "노출 비율" 또는 "가시적 노출 비율" 지표를 추적하세요. 20% 미만인 경우, 캐싱 알고리즘을 수정해야 할 가능성이 있습니다. 노출 비율이 높을수록 효과가 큽니다.

추가 리소스

GitHub 링크.

Was the article helpful?

적응형 스티키 배너

보상형 광고