React ネイティブプラグインのインテグレーション

前提条件

• React ネイティブプラグインは、Android 用のネイティブ SDK バージョン 7.2.4.1 および iOS 用の 7.2.4 からサポートされています。
• このプラグインは JavaScript と TypeScript の両方をサポートします。型宣言は パッケージに含まれています。
• React ネイティブ 0.66 以降をサポート。
• iOS バージョン サポートはネットワークごとに定義されます。 LevelPlay 広告と LevelPlay メディエーションは、iOS バージョン 12 以上、XCode バージョン 15.4 以上をサポートします。
• Android オペレーティング システム バージョン 5.0（API レベル 21）以上

ステップ 1. Unity LevelPlay React Mediation プラグインをプロジェクトに追加します。

NPM インテグレーション

1. npm CLI コマンドの実行

   npm install Unity-levelplay-mediation

2. パッケージ.json ファイルの更新:Unity レベルの play-mediation 定義をパッケージ.json ファイルに追加します。

   "dependencies": {    "unity-levelplay-mediation":"9.1.0"}

3. 広告品質 SDK の追加
   注

   React ネイティブプラグイン バージョン 3.1.1 以降、Ad 品質 は LevelPlay SDK に統合され、LevelPlay が実装されると自動的に初期化されます。LevelPlay がビルドに実装されていない場合、または 3.1.1 より前のバージョンの React ネイティブプラグイン を使用している場合は、以下の手順が適用されます。
   Android:

   dependencies {    implementation 'com.unity3d.ads-mediation:adquality-sdk:9.3.1'}

   iOS:

   pod 'IronSourceAdQualitySDK','9.3.1'

1. React ネイティブプラグインバージョンのダウンロード
2. Unity レベルの play-mediation 定義をパッケージ.json ファイルに追加します。

"dependencies": {  "unity-levelplay-mediation":"Path/To/Local/Directory"}

Unity LevelPlay アプリケーション

ステップ 2. iOS の追加設定

SKAdNetworkサポート

1. Xcode のプロジェクトナビゲーターで Info.plist を選択します。
2. プロパティリストエディタのキーの横にある追加ボタン (+) を選択し、Return キーを押します。
3. キー名 SKAdNetworkItems を入力します
4. 「型」列のポップアップメニューから配列を選択します。
5. ディクショナリ項目を作成し、その下に 1 つの項目を作成します。  
6. キー名 SKAdNetworkIdentifier とキー値を入力します。

   su67r6k2v3.skadnetwork

<key>SKAdNetworkItems</key><array>   <dict>      <key>SKAdNetworkIdentifier</key>      <string>su67r6k2v3.skadnetwork</string>   </dict></array>

ユニバーサルSKANレポート

1. Xcode のプロジェクトナビゲーターで Info.plist を選択します。
2. プロパティリストエディタでキーの横にある追加ボタン (+) を選択し、Return キーを押します。
3. キー名 NSAdvertisingAttributionReportEndpoint を入力します。
4. Type カラムのポップアップメニューから文字列を選択します。
5. URL を入力します。

   https://postbacks-is.com

アプリケーション転送のセキュリティ設定

• 「NSAppTransportSecurity」というディクショナリを追加します。このディクショナリは「トップレベルキー」に追加してください。
•  このディクショナリ内に「NSAllowsArbitraryLoads」というブーリアンを追加し、YES に設定します。
• info.plist に NSAllowsArbitraryLoads 以外の例外が含まれていないことを確認してください。競合が発生する可能性があります。
• ATS の詳細については、こちらを参照してください。

ステップ 3. Android の追加設定

再生サービスの依存関係

dependencies {    implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'    implementation 'com.google.android.gms:play-services-basement:18.3.0'    implementation 'com.google.android.gms:play-services-appset:16.0.2'}

Android 12 サポート

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

ステップ 4. LevelPlay SDK の初期化

LevelPlay SDK 8.7.0+

1. 初期化の成功と失敗のコールバックを実装します。
2. LevelPlayInitRequest.Builder を使用して init リクエストを作成します。Builder は以下のパラメータを受け取ります。
   • appKey (必須)
   • ユーザーID(任意:サーバー間のコールバックまたは広告品質ユーザー ジャーニーを使用している場合に必要)
3. LevelPlay.init を呼び出し、コンテキストと init リクエストを渡します。

const initListener：LevelPlayInitListener = {    onInitFailed: (エラー:LevelPlayInitError) => {        // Provided when init fails    },    onInitSuccess:(設定:LevelPlayConfiguration) => {        // Provided when init is successfully executed    }}// Init the SDK when implementing the Multiple Ad Units APIs for all ad formatsconst initRequest：LevelPlayInitRequest = LevelPlayInitRequest.builder(APP_KEY)      .withUserId("userId") // required for server-to-server callbacks or Ad Quality user journey (optional otherwise)      .build();LevelPlay.init(initRequest, initListener)

LevelPlay SDK before 8.7.0

1. 初期化の成功と失敗のコールバックを実装します。
2. 古い機能のIronsource APIからのサポートを必要とする広告フォーマットのリストを定義します。これには REWARDED が含まれます。 
3. appKey、広告フォーマット、およびユーザー ID (必要な場合) を使用して LevelPlay init API を呼び出します。

const initListener：LevelPlayInitListener = {   onInitFailed: (エラー:LevelPlayInitError) => {    // Provided when init is failed   },   onInitSuccess:(設定:LevelPlayConfiguration) => {    // Provided when init is successfully executed   }}// Init the SDK when implementing the Multiple Ad Units Interstitial and Banner APIs, and Rewarded using legacy APIs  const legacyAdFormats = [AdFormat.REWARDED];const initRequest：LevelPlayInitRequest = LevelPlayInitRequest.builder(APP_KEY)      .withLegacyAdFormats(legacyAdFormats)      .withUserId("userId") // required for server-to-server callbacks or Ad Quality user journey (optional otherwise)      .build();await LevelPlay.init(initRequest, initListener)

LevelPlay Init リスナー

• onInitSuccess – init が正常に完了し、広告をロードできるときにトリガーされます。
• **onInitFailed：**設定が正常に受信されず、広告をロードできません。後で LevelPlay SDK を初期化してみることをお勧めします。

ステップ 5.インテグレーションの確認

LevelPlay.setMetaData('is_test_suite', ['enable'])

LevelPlay.launchTestSuite()

Adapters デバッグ

LevelPlay.setAdaptersDebug(true);

ProGuard ユーザーのみ

-keepclassmembers class com.ironsource.sdk.controller.IronSourceWebView$JSInterface {    public *;}-keepclassmembers class * implements android.os.Parcelable {    public static final android.os.Parcelable$Creator *;}-keep public class com.google.android.gms.ads.** {   public *;}-keep class com.ironsource.adapters.** { *;}-keep class com.ironsource.unity.androidbridge.** { *;}-dontwarn com.ironsource.mediationsdk.**-dontwarn com.ironsource.adapters.**-keepattributes JavascriptInterface-keepclassmembers class * {    @android.webkit.JavascriptInterface <methods>;}

次のステップ

1. インテグレーション ガイドに従って広告フォーマットを実装
   • 動画リワード
   • Interstitial (インタースティシャル)
   • Banner
   • ネイティブ広告
2. 動画リワード広告、インタースティシャル広告、バナー広告をアプリケーションに統合します。メディエーションに関する記事を参照してください。
3. インテグレーションテストスイートとのインテグレーションを確認します。