연동

이 페이지에서는 AppLovin React Native 모듈을 다운로드, 임포트 및 구성하는 방법을 설명합니다.

info

Note

React Native 모듈 버전 5에는 Promise 및 콜백을 지원하기 위한 주요 업그레이드가 포함되어 있습니다. 이 업그레이드는 하위 호환성을 제공하지 않습니다. 변경 사항에 대한 요약은 아래의 React Native v5 마이그레이션 가이드를 참조하십시오.

React Native 모듈 버전 6에는 TypeScript 및 모듈을 지원하기 위한 주요 업데이트가 포함되어 있습니다. TypeScript는 React Native 버전 0.71부터 React Native 기본 애플리케이션 프로그래밍 언어입니다. 이 모듈 업그레이드는 하위 호환성을 제공하지 않습니다. 변경 사항에 대한 요약은 아래의 React Native v6 마이그레이션 가이드를 참조하십시오.

React Native 모듈 버전 9에는 React Native의 새로운 아키텍처에 대한 지원이 도입되었습니다. 기존 API 및 기능은 그대로 유지됩니다. 새로운 아키텍처의 특정 제한 사항으로 인해 일부 기능이 수정되었습니다. 이러한 변경 사항에 대한 요약은 아래의 React Native v9 마이그레이션 가이드를 참조하십시오.

ad review 활성화

MAX Ad Review 서비스를 활성화하려면 아래 지침을 따르십시오.

Android 지침

build.gradle 파일의 끝에 다음을 추가하십시오.

루트 수준 `build.gradle` 파일 추가 사항

buildscript {
  repositories {
    maven { url 'https://artifacts.applovin.com/android' }
  }
  dependencies {
    classpath "com.applovin.quality:AppLovinQualityServiceGradlePlugin:+"
  }
}

buildscript {
  repositories {
    maven { url = uri("https://artifacts.applovin.com/android") }
  }
  dependencies {
    classpath ("com.applovin.quality:AppLovinQualityServiceGradlePlugin:+")
  }
}

앱 수준 `build.gradle` 파일 추가 사항

apply plugin: 'applovin-quality-service'
applovin {
  apiKey "«your-ad-review-key»"
}

plugins {
  id("applovin-quality-service")
}
applovin {
  apiKey = "«your-ad-review-key»"
}

Ad Review Key는 AppLovin 대시보드의 Account > General > Keys 섹션에서 확인할 수 있습니다.

iOS 지침

AppLovinQualityServiceSetup-ios.rb를 다운로드하여 프로젝트 폴더로 이동하십시오. 터미널 창을 열고 프로젝트 디렉토리로 cd한 후 다음을 실행하십시오.

ruby AppLovinQualityServiceSetup-ios.rb

SDK 초기화

앱의 메인 홈 화면에 아래 코드 스니펫을 추가하십시오.

import AppLovinMAX, { Configuration } from "react-native-applovin-max";

⋮

AppLovinMAX.initialize("«your-SDK-key»").then((conf: Configuration) => {
  // SDK is initialized, start loading ads
}).catch(error => {
  // Failed to initialize SDK
});

SDK key는 AppLovin 대시보드의 Account > General > Keys 섹션에서 확인할 수 있습니다.

미디에이션 network가 광고 에셋을 캐시하면 사용자가 더 나은 경험을 할 수 있습니다. 이러한 이유로 항상 시작 시 AppLovin SDK를 초기화하십시오. 이를 통해 미디에이션 network가 광고를 캐시할 수 있는 시간을 확보할 수 있습니다. 이는 비디오 광고에서 특히 중요합니다.

iOS 14 지원

iOS 14에서 Apple은 글로벌 개인정보 보호정책 변경 사항을 도입했습니다. Apple은 애플리케이션이 이러한 새로운 정책을 준수할 것을 요구합니다. 준수하지 않을 경우 수익이 감소할 수 있습니다. 이 섹션에서는 준수 방법을 설명합니다.

SKAdNetwork

앱의 Info.plist를 network 전용 식별자로 업데이트하십시오. 자세한 지침은 SKAdNetwork 문서를 참조하십시오.

동의 및 데이터 API

AppLovin의 수익화 파트너를 대신하여 특정 관할 구역의 사용자로부터 동의를 얻어야 합니다. 또한 동의 값을 AppLovin에 전달해야 합니다. 방법을 알아보려면 Privacy–consent, age-related flags, and data APIs 문서를 검토하십시오.

React Native v5 마이그레이션 가이드

React Native 모듈 버전 5에는 Promise 및 콜백을 지원하기 위한 주요 업데이트가 포함되어 있습니다. 이는 하위 호환성을 제공하지 않습니다. 이 섹션에서는 이러한 업데이트를 요약합니다.

네이티브 UI 컴포넌트(AppLovinMAX.AdView 및 AppLovinMAX.NativeAdView)는 컴포넌트 자체에서 직접 콜백을 선언할 수 있습니다.

유형별 이벤트 리스너는 유형을 인수로 받습니다. 이러한 리스너는 일반 이벤트 리스너를 대체합니다. 예를 들어, 이제 AppLovinMAX.addEventListener(type, listener) 대신 AppLovinMAX.addInterstitialLoadedEventListener(listener)를 사용합니다.

이전에 반환 값이 있던 12개의 동기식 메서드가 이제 Promise 아키텍처를 사용합니다. Promise가 전달한 값에 액세스할 때 then/catch 또는 async/await를 통한 체이닝을 사용할 수 있습니다. 다음 표는 업데이트된 메서드를 보여줍니다.

메서드	`resolve` 반환 유형	`reject` 반환 유형
`AppLovinMAX.getAdaptiveBannerHeightForWidth(width)`	height (`float`)	⸺
`AppLovinMAX.hasUserConsent()`	`boolean`	⸺
`AppLovinMAX.initialize(sdkKey)`	Configuration object	`error`
`AppLovinMAX.isAppOpenAdReady(adunitId)`	`boolean`	`error`
`AppLovinMAX.isDoNotSell()`	`boolean`	⸺
`AppLovinMAX.isInitialized()`	`boolean`	⸺
`AppLovinMAX.isInterstitialReady(adUnitId)`	`boolean`	`error`
`AppLovinMAX.isMuted()`	`boolean`	⸺
`AppLovinMAX.isRewardedAdReady(adunitId)`	`boolean`	`error`
`AppLovinMAX.isTablet()`	`boolean`	⸺
`AppLovinMAX.showCmpForExistingUser()`	`null`	`error`

이러한 새로운 메서드를 사용하는 마이그레이션이 어떤 모습일지 보여주는 데모 앱의 이 커밋을 참조할 수도 있습니다.

React Native v6 마이그레이션 가이드

React Native 모듈 버전 6에는 TypeScript 및 모듈을 지원하기 위한 주요 업데이트가 포함되어 있습니다. 이는 하위 호환성을 제공하지 않습니다. 이 섹션에서는 이러한 업데이트를 요약합니다.

TypeScript

TypeScript는 React Native 버전 0.71부터 React Native 기본 애플리케이션 프로그래밍 언어가 되었습니다. React Native 모듈 버전 6은 코드 베이스를 TypeScript로 마이그레이션합니다.

모듈

이전 버전은 MAX의 모든 기능을 포함하는 단일 모듈인 AppLovinMAX를 내보냈습니다. 버전 6은 이러한 기능을 일련의 모듈로 분류합니다. 버전 6의 아키텍처는 버전 5와 유사하지만, 이러한 모듈 도입에 맞게 함수 시그니처를 업데이트합니다. 주요 신규 모듈은 다음과 같습니다.

모듈	기능
`AppLovinMAX` (기본값)	통합 (초기화 및 범용 기능)
`Privacy`	privacy, terms flow
`AppOpenAd`	app open ads
`BannerAd`	banner ads
`InterstitialAd`	interstitial ads
`MRecAd`	medium rectangle (MREC) ads
`NativeAdView`	native ads
`RewardedAd`	rewarded ads
`AdView`	banner 및 MREC (UI 컴포넌트)

마이그레이션 예시

import AppLovinMAX from 'react-native-applovin-max';

AppLovinMAX.addInterstitialLoadedEventListener((adInfo) => {
    const isInterstitialReady = await AppLovinMAX.isInterstitialReady(«ad-unit-ID»);
    if (isInterstitialReady) {
        AppLovinMAX.showInterstitial(«ad-unit-ID»);
    }
});

AppLovinMAX.loadInterstitial(«ad-unit-ID»);

import { InterstitialAd, type AdInfo } from 'react-native-applovin-max';

InterstitialAd.addAdLoadedEventListener((adInfo: AdInfo) => {
    const isInterstitialReady = await InterstitialAd.isAdReady(«ad-unit-ID»);
    if (isInterstitialReady) {
        InterstitialAd.showAd(«ad-unit-ID»);
    }
});

InterstitialAd.loadAd(«ad-unit-ID»);

React Native v9 마이그레이션 가이드

React Native 모듈 버전 9에는 기존 API 및 기능을 유지하면서 React Native의 새로운 아키텍처에 대한 지원이 도입되었습니다. 새로운 아키텍처의 특정 제한 사항으로 인해 일부 기능이 수정되었습니다.

주요 변경 사항

AdInfo에서 waterfall 정보 API 지원 제거: AdInfo 객체는 더 이상 waterfall 정보 API를 지원하지 않습니다.
AdView 및 NativeAdView에서 extraParameters 및 localExtraParameters 변경 사항: 이 파라미터들은 이제 문자열 및 부울 값만 지원합니다. 이전에는 이 값들을 null로 설정했을 수 있는 곳에 빈 문자열("")로 설정하십시오.