メインコンテンツへスキップ

概要

Adrop React Native SDKを使用すると、React Nativeアプリでさまざまな広告フォーマットを簡単に連携できます。

対応広告フォーマット

フォーマット説明
バナー広告画面の一部に表示される長方形の広告
ネイティブ広告アプリコンテンツと自然に調和する広告
インタースティシャル広告全画面を覆う広告
リワード広告報酬を提供する全画面広告
ポップアップ広告ポップアップ形式で表示される広告
スプラッシュ広告アプリ起動時に表示される広告

必要要件

React Native

  • React Native 0.71 以上

Android

  • APIレベル 23 (Android 6.0) 以上
  • compileSdkVersion 34
  • Kotlin 2.1.0 以上
  • Gradle 8.7 以上

iOS

  • iOS 13.0 以上
  • Swift 5.0 以上

インストール

1. パッケージインストール

2. Android設定

android/settings.gradle.ktsにバックフィル広告リポジトリを追加します。
android/settings.gradle.kts
android/app/build.gradleにKotlinプラグインとバックフィル依存関係を追加します。
android/app/build.gradle
android/app/src/main/AndroidManifest.xmlにバックフィルApp IDを追加します。
android/app/src/main/AndroidManifest.xml
App IDの発行についてはAdropにお問い合わせください。

3. iOS設定

ios/Podfileを修正します。
ios/Podfile
Podをインストールします。

4. Info.plistの設定

バックフィル広告のためにios/YourApp/Info.plistに以下の設定を追加します。
  • GADApplicationIdentifier: バックフィル広告用のApp ID
  • SKAdNetworkItems: iOS 14以降で広告コンバージョントラッキングに必要
Info.plist
既存のInfo.plistに既にSKAdNetworkItemsキーがある場合は、新たに追加せず配列(<array>)の項目のみマージしてください。同じキーを2つ置くと、iOSは最初の配列のみを使用します。
SKAdNetworkItemsの全リストとApp IDの発行についてはAdropにお問い合わせください。

初期化

アプリ起動時にSDKを初期化します。通常はApp.tsxまたはindex.jsで呼び出します。
App.tsx

初期化オプション

パラメータ
パラメータタイプ必須説明
productionbooleanYtrue: プロダクションモード、false: テストモード
targetCountriesstring[]N広告を表示する国コード (例: ['KR', 'US'])
useInAppBrowserbooleanNiOSでアプリ内ブラウザを使用するかどうか (デフォルト: false)

テーマ設定

広告UIテーマを設定します。
テーマ説明
AdropTheme.autoシステム設定に応じて自動切り替え
AdropTheme.lightライトモード
AdropTheme.darkダークモード

ユーザー識別子設定

ターゲティング広告のためにユーザー識別子(UID)を設定します。
UIDはSHA-256でハッシュ化されて送信されます。メールアドレス、電話番号などの個人情報を直接渡さないでください。

テストユニットID

開発とテスト時には以下のテストユニットIDを使用してください。
フォーマットテストユニットID
バナー (320x50)PUBLIC_TEST_UNIT_ID_320_50
バナー (320x100)PUBLIC_TEST_UNIT_ID_320_100
ネイティブPUBLIC_TEST_UNIT_ID_NATIVE
インタースティシャル広告PUBLIC_TEST_UNIT_ID_INTERSTITIAL
リワード広告PUBLIC_TEST_UNIT_ID_REWARDED
ポップアップ (Bottom)PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM
ポップアップ (Center)PUBLIC_TEST_UNIT_ID_POPUP_CENTER
スプラッシュPUBLIC_TEST_UNIT_ID_SPLASH
プロダクション配布前に必ず実際のユニットIDに置き換えてください。

エラーコード

SDKで発生する可能性のあるエラーコードです。
エラーコード説明
AdropErrorCode.networkネットワークエラー
AdropErrorCode.internal内部エラー
AdropErrorCode.initializeSDK初期化エラー
AdropErrorCode.invalidUnit無効なユニットID
AdropErrorCode.notTargetCountryターゲット国ではない
AdropErrorCode.inactive非アクティブ広告
AdropErrorCode.adNoFill表示できる広告なし
AdropErrorCode.adDuplicated重複ロードリクエスト
AdropErrorCode.adLoadingロード進行中
AdropErrorCode.adEmpty空の広告
AdropErrorCode.adShownすでに表示された広告
AdropErrorCode.adHideForToday今日は非表示に設定された広告
AdropErrorCode.adLandscapeUnsupported横向きモード非対応
AdropErrorCode.backfillNoFillバックフィル広告なし

トラブルシューティング

iOSビルドエラー

Swiftバージョン互換性の問題が発生した場合、ios/Podfilepost_installブロックに以下を追加してください。
ios/Podfile

Androidビルドエラー

Kotlinバージョンが合わない場合、android/build.gradleでKotlinバージョンを確認してください。
android/build.gradle

次のステップ

バナー広告

バナー広告を実装する

ネイティブ広告

ネイティブ広告を実装する

インタースティシャル広告

インタースティシャル広告を実装する

リワード広告

リワード広告を実装する

WebViewガイド

WebViewでウェブ広告を表示

UMP連携

GDPR/CCPA同意管理

ポップアップ広告

ポップアップ広告を実装する

スプラッシュ広告

スプラッシュ広告を設定する

ターゲティング

ユーザーおよびコンテキストターゲティング設定

リファレンス

完全なAPIリファレンス

サンプル

完全な実装サンプル