적응형 스티키 배너

앱 화면의 상단 또는 하단에 배치되어 자동으로 업데이트되는 작은 광고입니다. 주요 앱 콘텐츠와 겹치지 않으며 게임 앱에서 자주 사용됩니다.

적응형 스티키 배너는 각 장치에서 광고 크기를 최적화하여 최대 효율성을 제공합니다. 이 광고 유형은 개발자가 허용 가능한 최대 광고 너비를 설정할 수 있게 하지만, 최적의 광고 크기는 여전히 자동으로 결정됩니다. 적응형 스티키 배너의 높이는 화면 높이의 15%를 초과해서는 안 됩니다.

표시 예

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

사전 준비

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

실행

적응형 스티키 배너 통합을 위한 주요 단계:

배너 크기를 가져옵니다.
AdRequest 객체를 사용하여 광고 로드 매개변수를 설정합니다.
광고 수명 주기 내의 이벤트를 처리하는 데 필요한 속성과 콜백 함수를 설정하여 광고를 표시합니다.

적응형 스티키 배너 통합의 특징

onAdFailedToLoad 콜백에서 오류를 수신할 때 새로운 광고를 로드하려고 시도하지 않는 것을 적극 권장합니다. onAdFailedToLoad에서 광고를 로드해야 하는 경우, 네트워크 연결 제약이 있을 때 반복적으로 광고 요청이 실패하지 않도록 광고 로드 재시도를 제한하세요.
적응형 스티키 배너가 제대로 작동하려면 앱 레이아웃을 적응형으로 만드세요. 그렇지 않으면 광고가 잘못 렌더링될 수 있습니다.
적응형 스티키 배너는 사용 가능한 전체 너비를 활용할 때 가장 잘 작동합니다. 대부분의 경우에는 장치 화면의 전체 너비에 해당합니다. 앱에 설정된 패딩 매개변수와 디스플레이의 안전 영역을 고려하세요.
광고의 크기를 가져오려면 광고 컨테이너의 사용 가능한 너비를 인수로 받아들이는 메서드 BannerAdSize.stickySize(width)를 사용하세요.
BannerAdSize.stickySize(width) 메서드를 사용하여 계산된 BannerAdSize 객체 내에 포함된 광고 너비 및 높이 값은 동일한 장치 내에 일관되게 적용됩니다. 특정 장치에서 앱의 레이아웃을 테스트할 때 해당 장치의 광고 크기가 동일하게 유지됨을 확신할 수 있습니다.
적응형 스티키 배너의 높이는 화면 높이의 15%를 초과하지 않으며 50dp보다 작을 수 없습니다.

배너 크기 가져오기

광고의 크기를 가져오려면 광고 컨테이너의 사용 가능한 너비와 허용 가능한 최대 광고 높이를 인수로 받아들이는 메서드 BannerAdSize.stickySize(width)를 사용하세요. 앱에 설정된 패딩 매개변수와 디스플레이의 안전 영역을 고려하세요.

let adSize = await BannerAdSize.stickySize(Dimensions.get('window').width);

AdRequest 생성

AdRequest 클래스 객체를 통해 광고 요청 매개변수를 확장할 수 있습니다. 사용자의 관심사, 페이지 컨텍스트, 위치 및 기타 추가 데이터에 대한 정보를 제공할 수 있습니다. 광고 요청에 추가된 컨텍스트는 광고 품질을 크게 향상할 수 있습니다.

광고 표시

광고를 로드하려면 BannerAdSize.stickySize(width) 메서드를 사용하여 계산된 크기와 Partner Interface(adUnitId)에서 얻은 배치 ID가 필요합니다.

광고가 로드되거나 로드에 실패할 때 알림을 활성화하고 적응형 스티키 배너의 수명 주기 이벤트를 추적하려면 BannerView 구성 요소에 대한 콜백 함수를 설정하세요.

또한 BannerView 구성 요소의 adRequest 속성을 AdRequest 클래스 객체에 전달하여 요청 매개변수를 확장할 수 있습니다.

아래 예시는 적응형 인라인 배너 속성과 수명 주기 이벤트를 처리하기 위한 콜백 함수를 설정하는 방법을 보여줍니다. 로드되면 배너가 자동으로 표시됩니다.

const createBanner = async () => {
    let adSize = await BannerAdSize.stickySize(Dimensions.get('window').width);

    let adRequest = new AdRequest({
        age: '20',
        contextQuery: 'context-query',
        contextTags: ['context-tag'],
        gender: Gender.Male,
        location: new Location(55.734202, 37.588063)
    });

    return (
        <BannerView
            size={adSize}
            adUnitId={'R-M-XXXXXX-Y'} // 또는 'demo-banner-yandex'
            adRequest={adRequest}
            onAdLoaded={() => console.log('Did load')}
            onAdFailedToLoad={(event: any) => console.log(`Did fail to load with error: ${JSON.stringify(event.nativeEvent)}`)}
            onAdClicked={() => console.log('Did click')}
            onLeftApplication={() => console.log('Did leave application')}
            onReturnToApplication={() => console.log('Did return to application')}
            onAdImpression={(event: any) => console.log(`Did track impression: ${JSON.stringify(event.nativeEvent.impressionData)}`)}
            onAdClose={() => console.log('Did close')}
        />
    );
}

적응형 스티키 배너 통합 테스트

Android

iOS

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

적응형 스티키 배너 통합 및 앱 자체를 테스트하기 위해 테스트 광고를 사용하는 것이 좋습니다.

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

데모 adUnitId: demo-banner-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 banner was integrated successfully

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

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

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

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

데모 adUnitId: demo-banner-yandex.

Важно

앱을 스토어에 게시하기 전에 데모 광고 단위 ID를 Partner Interface에서 가져온 실제 ID로 교체해야 합니다.

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

광고 통합 테스트

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

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

YMAMobileAds.enableLogging()

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

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

추가 리소스

GitHub 링크.

Was the article helpful?

적응형 인라인 배너

전면 광고