Skip to main content

시작하기 전에

중요: SDK 초기화 필수배너 광고와 네이티브 광고는 반드시 SDK 초기화가 완료된 후에 렌더링되어야 합니다. 초기화 전에 광고 컴포넌트를 렌더링하면 초기화 오류가 발생할 수 있습니다.인터스티셜 광고, 리워드 광고 등 다른 광고 형식도 SDK 초기화 이후에 로드해야 합니다.

요구사항

  • 안드로이드 minSdkVersion : 23
  • iOS 15.1 이상
[email protected]은 Android so.daro:daro-a , iOS DaroAds 를 사용합니다.
app-ads.txt 파일 설정(링크)이 잘 되었는지 다시 한 번 확인해주세요.

지원 광고 포맷

  • 배너/MREC
  • 네이티브
  • 인터스티셜
  • 리워드
  • 라이트 팝업

패키지 설치하기

Expo 프로젝트 설정하기

react-native-daro 1.0.16 이상에서는 Expo config plugin을 사용할 수 있습니다. Expo 프로젝트에서 Non-Reward 앱을 연동하는 경우 기존 Expo config에 DARO plugin 설정을 추가한 뒤 npx expo prebuild 또는 EAS Build를 실행하세요.
Expo Go에서는 DARO 네이티브 모듈을 사용할 수 없습니다. development build 또는 prebuild된 앱에서 사용해야 합니다.
1

DARO key file 준비

daroKeyFile에 지정할 key file을 Expo 프로젝트 루트에 추가합니다.
2

Expo config에 plugin 추가

기존 Expo config는 유지하고 expo.plugins에 DARO 설정을 추가합니다.
app.json
3

prebuild 또는 EAS Build 실행

설정을 추가한 뒤 npx expo prebuild 또는 EAS Build를 실행합니다.
동적 Expo config를 사용하는 프로젝트에서는 앱 식별자 설정을 기존 Expo/EAS 설정 방식에 맞게 관리하세요.
Expo config plugin은 Android의 Daro SDK 의존성, Daro Gradle plugin, daroAppKey, key file을 설정하고, iOS의 DaroAppKey, GADApplicationIdentifier, SKAdNetworkItems, key file을 설정합니다.
Expo config plugin을 사용했다면 아래 React Native CLI 프로젝트 설정은 건너뛰고 SDK 초기화하기로 이동하세요.

React Native CLI 프로젝트 설정하기

Expo를 사용하지 않는 React Native CLI 프로젝트에서 react-native-daro를 사용하는 경우 Android/iOS 프로젝트 설정을 직접 추가합니다. 네이티브 프로젝트 설정을 마친 뒤 SDK 초기화하기를 진행하세요.

Android 프로젝트 설정하기

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

1

프로젝트 단위 빌드 설정

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

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

  1. build.gradle(root) 파일에 daro 관련 플러그인을 추가합니다.
React Native Android 설정 사용 버전
  • daro-plugin :
3

Daro SDK 추가

  1. Daro SDK를 추가합니다.
React Native SDK 사용 버전
  • 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. 모든 배너 및 네이티브 광고 컴포넌트를 조건부 렌더링으로 보호
    • 초기화가 완료되지 않은 상태에서 광고 컴포넌트가 렌더링되지 않도록 하세요

다음 단계

연동과 초기화를 완료했다면 사용할 광고 포맷의 구현 문서로 이동하세요.