Flutter プラグインインテグレーション

前提条件

• Flutter プラグインは、Android および iOS 用の SDK バージョン 7.2.1.2 からサポートされています。
• Flutter 3.0.0+ サポート

LevelPlay Mediation プラグインをプロジェクトに追加する

Pub.dev Integration

1. Flutter CLI コマンドの実行

   flutter pub get unity_levelplay_mediation

2. pubspec.yaml ファイルに

   unity_levelplay_mediation

   定義を追加して、pubspec.yaml ファイルを更新。

   dependencies (依存関係):  flutter:    sdk: flutter   unity_levelplay_mediation: '>=9.1.0 <9.2.0'

3. 広告品質 SDK の追加

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

pod 'IronSourceAdQualitySDK','9.3.1'

手動での統合

LevelPlay アプリケーション

iOS の追加設定

SKAdNetworkサポート

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

   su67r6k2v3.skadnetwork

   以下のコードで Info.plist に

   SKAdNetworkIdentifier

   を追加することもできます。

<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/

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

info.plist

• NSAppTransportSecurity

  というディクショナリを追加します。このディクショナリはトップレベルキーに追加してください。
• このディクショナリ内で、

  NSAllowsArbitraryLoads

  というブーリアンを追加し、YES に設定します。
• info.plist に

  NSAllowsArbitraryLoads

  以外の例外が含まれていないことを確認してください。競合が発生する可能性があります。
• ATS の詳細については、Apple ドキュメントを参照してください。

Android の追加設定

再生サービスの依存関係

dependencies {   implementation 'com.google.android.gms:play-services-ads-identifier:18.2.0'   implementation 'com.google.android.gms:play-services-appset:16.1.0'}

Android 12 サポート

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

AndroidManifest.xml のラベルを置換

• プロジェクトの AndroidManifest.xml に ‘xmls:tools’ を追加します。
• 「アプリケーション」タグに「tools:replace=”Android:ラベル”」を追加します。

LevelPlay SDK の初期化

LevelPlay SDK 8.6.0 以降

1. 初期化の成功と失敗のコールバックを実装します。
2. セッションで初期化する広告フォーマットのリストを定義します。

3. LevelPlayInitRequest.builder

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

class MyLevelPlayInitListener implements LevelPlayInitListener {    @override    void onInitFailed(LevelPlayInitError error) {	      // Provided when init is failed    }    @override    void onInitSuccess(LevelPlayConfiguration configuration) {	      // Provided when init is successfully executed    }}LevelPlayInitRequest initRequest = LevelPlayInitRequest.builder([APP_KEY])                .withUserId("userId") // required for server-to-server callbacks or Ad Quality user journey (optional otherwise)                .build();LevelPlay.init(initRequest, MyLevelPlayInitListener());

LevelPlay SDK before 8.6.0

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

class MyLevelPlayInitListener implements LevelPlayInitListener {  @override  void onInitFailed(LevelPlayInitError error) {	// Provided when init is failed  }  @override  void onInitSuccess(LevelPlayConfiguration configuration) {	// Provided when init is successfully executed  }}// Init the SDK when implementing the Multiple Ad Units Interstitial and Banner APIs, and Rewarded using legacy APIs  List<AdFormat> legacyAdFormats = [AdFormat.REWARDED];LevelPlayInitRequest initRequest = LevelPlayInitRequest.builder([APP_KEY])                .withLegacyAdFormats(legacyAdFormats)                .withUserId("userId") // required for server-to-server callbacks or Ad Quality user journey (optional otherwise)                .build();LevelPlay.init(initRequest, MyLevelPlayInitListener());

LevelPlay Init リスナー

• onInitSuccess

  : init が正常に完了し、広告をロードできるようになったときにトリガーされます。

• onInitFailed

  : 設定が正常に受信されず、広告をロードできません。推奨されるベストプラクティスは、後で LevelPlay SDK を試行して初期化することです。

• init API の前に呼び出されたすべての API は変更されておらず、機能と構文の点ではそのままになっている必要があります。これには、特定の広告形式に関連する詳細設定、規制設定、その他の API が含まれます。
• 初期化に失敗した場合は、SDK の初期化を再試行できます。初期化プロセスが成功した後にのみ、広告をロードできるようになります。

インテグレーションの確認

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. インテグレーションテストスイートとのインテグレーションを確認します。