메인 콘텐츠로 건너뛰기

시작하기 전에

중요: SDK 초기화 필수배너 광고와 네이티브 광고는 반드시 SDK 초기화가 완료된 후에 렌더링되어야 합니다. 초기화 전 광고 컴포넌트를 렌더링하면 다음 에러가 발생합니다: AdBannerView | NativeAdView is mounted before the initialization of the DaroM React Native module전면 광고, 보상형 광고 등 다른 광고 형식도 SDK 초기화 이후에 로드해야 합니다.
React Native 프로젝트에 Daro SDK를 통합하기 전에 필요한 사항들을 확인하세요.

요구사항

  • 안드로이드 minSdkVersion : 23
  • iOS 15.1 이상
app-ads.txt 파일 설정(링크)이 잘 되었는지 다시 한 번 확인해주세요.

앱 설정하기

연동하기 전에에서 확인한 Non-Reward / Reward 카테고리에 따라 아래 단계를 진행해주세요.기존에 daro-m을 사용 중이라면, Reward 탭을 선택하여 daro-m 연동 가이드를 따라주세요.

npm 패키지 추가하기

터미널에서 npm 패키지를 추가합니다.
npm i react-native-daro

Android 프로젝트 설정하기

  • 안드로이드 minSdkVersion : 23
minSdk 26 미만일 경우 Desugaring 설정을 필요로 합니다.

1

프로젝트 단위 빌드 설정

  1. settings.gradle 파일에 maven repository 들을 추가합니다.
2

build.gradle(root)에 daro 플러그인 추가

  1. build.gradle(root) 파일에 daro 관련 플러그인을 추가합니다.
Latest version
  • daro-plugin :
3

Daro SDK 추가

  1. Daro SDK를 추가합니다.
Latest version
  • daro-a :
4

android-daro-key.txt 파일 추가

  1. android-daro-key.txt 파일을 추가합니다.
android-daro-key.txt는 DARO 대시보드에서 다운받을 수 있습니다.
5

daroAppKey 설정

  1. daroAppKey 를 설정합니다.
daroAppKey는 DARO 대시보드에서 확인할 수 있습니다.daroAppKey
6

build.gradle(app)에 daro plugin 적용

  1. build.gradle(app)에 daro plugin을 적용합니다.
7

proguard rule 추가히기

  1. proguard rule을 추가합니다.

iOS 프로젝트 설정하기

  • iOS 15.1 이상
  • Xcode 14.0 이상
  • ios/PROJECT_NAME.xcworkspace 을 열고 ios-daro-key.txt 파일을 드래그 앤 드롭으로 추가합니다. ⚠️ SDK를 초기화하기 위해서는 ios-daro-key.txt 파일이 프로젝트에 반드시 포함되어야 합니다.
    GADApplicationIdentifier, DaroAppKey 는 DARO 대시보드에서 ( AdMob Key, App Key ) 확인할 수 있습니다.
    ❗ Info.plist 의 SKAdNetworkItems 들을 앱의 Info.plist 에 복사해 넣어주세요. 등록하지 않으면 광고 디맨드가 전환 성과를 보고 받지 못해 광고 효율이 낮아집니다. 광고 퍼포먼스에 큰 영향을 주기때문에 꼭! 넣어주세요.
  • Info.plist 에 다음 ID들을 추가합니다.

SDK 초기화하기

아래 코드를 참고하여 SDK를 초기화합니다.

베스트 프랙티스

SDK 초기화 관리

SDK를 효율적으로 관리하고 에러를 방지하기 위한 권장 사항입니다.
  1. 앱 시작 시 initialize() 호출
    • 앱의 진입점(App.js 또는 index.js)에서 SDK를 초기화하세요
  2. 초기화 상태를 state로 관리
    • 초기화 완료 여부를 추적하여 광고 렌더링 시점을 제어하세요
  3. 모든 배너 및 네이티브 광고 컴포넌트를 조건부 렌더링으로 보호
    • 초기화가 완료되지 않은 상태에서 광고 컴포넌트가 렌더링되지 않도록 하세요