このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 ironSource の広告経由の メディエーション(ウォーターフォールをカバー) 統合できますironSource 広告を広告ユニットの メディエーションの設定と、ironSource Ads SDK とアダプタを統合する方法について 組み込むことが重要です。 Flutter
サポートされている統合と広告フォーマット
ironSource Ads 用の AdMob メディエーション アダプタは次のとおりです。 次のような機能があります。
統合 | |
---|---|
単価設定 | 1 |
滝 | |
フォーマット | |
バナー | 2 |
インタースティシャル | |
特典 | |
リワード インタースティシャル | 2 |
1入札の統合が始まりました クローズド ベータ版。アクセス権をリクエストするには、アカウント マネージャーにお問い合わせください。
2 この形式は、 ウォーターフォール統合でサポートされています
要件
- 最新の Google Mobile Ads SDK
- Flutter 3.7.0 以降
- Android にデプロイする
<ph type="x-smartling-placeholder">
- </ph>
- Android API レベル 21 以降
- iOS にデプロイする場合
<ph type="x-smartling-placeholder">
- </ph>
- iOS デプロイ ターゲットが 12.0 以降であること
- Google で構成された Flutter 作業プロジェクト Mobile Ads SDK があります。詳しくは、 スタートガイドをご覧ください。
- メディエーションを完了する スタートガイド
ステップ 1: ironSource Ads UI で設定をセットアップする
ironSource の広告アカウントに登録してログインします。
アプリケーションを ironSource Ads ダッシュボードに追加するには、[New App] ボタンをクリックします。
アプリの詳細を入力
[Live App] を選択し、アプリの URL を入力して [Import App Info] をクリックします。
アプリが利用できない場合は、[App Not Live in the Application Store] を選択し、アプリの仮名を指定します。プラットフォームを選択します。
フォームの残りの部分に記入し、[Add App] をクリックします。
アプリを追加した後に表示される新しいアプリキーをメモしておきます。この値は、AdMob 広告ユニット ID を設定する際に必要になります。アプリがサポートする広告フォーマットを選択します。その後、[続行] をクリックします。
Android
iOS
インスタンスを作成
次に、追加したアプリのネットワーク インスタンスを構成します。
入札
[LevelPlay] > [設定] > [SDK ネットワーク] に移動して、アプリを選択します。[入札] で編集アイコンをクリックして、入札インスタンス ID を表示します。
Android
iOS
インスタンス ID をメモします。
Android
iOS
ウォーターフォール
[Ads] > [Setup] > [Instances] に移動します。アプリを選択して、[インスタンスを作成] をクリックします。
必要な詳細情報を入力し、[保存して閉じる] をクリックします。
インスタンスが作成されると、インスタンス ID が [インスタンス ID] フィールドに表示されます。
Reporting API キーを確認する
入札
入札の統合では、この手順は必要ありません。
ウォーターフォール
AdMob 広告ユニット ID を設定するには、アプリキーとインスタンス ID に加えて、ironSource 広告の秘密鍵と更新トークンも必要です。
ironSource 広告パブリッシャー ダッシュボードの [My Account] に移動し、[API] タブをクリックします。秘密鍵と更新トークンをメモしておきます。
テストモードをオンにする
ironSource Ads のテスト広告を有効にする方法については、ironSource Ads の統合テスト ガイドをご覧ください。
ステップ 2: 管理画面で ironSource の広告デマンドを設定する AdMob
広告ユニットのメディエーション設定を行う
GDPR と米国の州規制の広告パートナー リストに ironSource Mobile 追加
GDPR 設定 米国の州規制の設定 の手順に沿って、 AdMob UI の GDPR および米国の州規制の広告パートナーのリストに ironSource Mobile を追加します。
ステップ 3: ironSource Ads SDK とアダプタをインポートする
pub.dev による統合
(Android のみ)次のリポジトリを内部の build.gradle
ファイルに追加します。
プロジェクトの android
ディレクトリに配置します。
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
最新バージョンの SDK とともに次の依存関係を追加します。
IronSource
パッケージ内の SDK とアダプタ
pubspec.yaml
ファイル:
dependencies:
gma_mediation_ironsource: ^1.0.0
手動統合
最新バージョンの Google モバイル広告メディエーション プラグイン
IronSource
ダウンロードしたファイルを解凍し、抽出したプラグイン フォルダを追加します。
(およびその内容)を Flutter プロジェクトに追加します。次に、Terraform でプラグインを
pubspec.yaml
ファイルに次の依存関係を追加します。
dependencies:
gma_mediation_ironsource:
path: path/to/local/package
ステップ 4: ironSource Ads SDK にプライバシー設定を実装する
EU の同意と GDPR
Google の EU ユーザーの同意 ポリシーに基づき、特定の情報開示が必ず行われるようにし、 欧州経済領域(EEA)のユーザーから、 デバイス ID や個人データの使用。このポリシーは、 EU の e プライバシー指令と一般データ保護規則の要件 規則(GDPR)。同意を求める場合は、各広告ネットワークを特定する必要がある 個人データを収集、受信、または使用する可能性がある 各ネットワークの使用状況に関する情報が表示されます。現在のところ、Google は ユーザーの同意に関する選択をこうしたネットワークに自動的に渡す。
ironSource Ads 用の Google モバイル広告メディエーション プラグイン
含まれる
GmaMediationIronsource().SetConsent()
メソッドを呼び出します。次のサンプルコードは、Python コードを
ironSource Ads SDK に送信されます。このように
メソッドを使って広告をリクエストする前に、
Google Mobile Ads SDK
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setConsent(true);
詳しくは、ironSource Ads のドキュメントを参照してください。 規則の詳細設定 をご覧ください。
米国のプライバシー関連州法
米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトするユーザーの「個人情報」(法律で定められているとおり、 これらの規約を参照)の「Do Not Sell My Personal」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドでは、 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられます各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります
ironSource Ads 用の Google モバイル広告メディエーション プラグイン
含まれる
GmaMediationIronsource().setDoNotSell
メソッドを呼び出します。次のサンプルコードは、Python コードを
ironSource Ads SDK に送信されます。これらのオプションは
Google モバイル広告を
SDK
ironSource Ads SDK に適切に転送されるようにしてください。
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(true);
両方に関する規制の詳細設定については、ironSource Ads のドキュメントを参照してください。 Android および iOS をご覧ください。
ステップ 5: 必要なコードを追加する
Android
ProGuard ルール
アプリの圧縮、難読化、最適化を行う際は、 IronSource Ads を使用するには、プロジェクトに追加の ProGuard ルールが必要です。
コンサルト
IronSource Ads の Android SDK 統合ガイド
プロジェクトで必要な ProGuard ルールについて詳しくは、
それらのルールを proguard-user.txt
ファイルに追加します。
アプリケーションのライフサイクル
それぞれの onPause()
メソッドと onResume()
メソッドをオーバーライドする
アクティビティで、次のように対応する ironSource Ads メソッドを呼び出す必要があります。
Java
@Override
public void onResume() {
super.onResume();
IronSource.onResume(this);
}
@Override
public void onPause() {
super.onPause();
IronSource.onPause(this);
}
Kotlin
public override fun onResume() {
super.onResume()
IronSource.onResume(this)
}
public override fun onPause() {
super.onPause()
IronSource.onPause(this)
}
iOS
SKAdNetwork との統合
ironSource Ads のドキュメントに沿って、SKAdNetwork 識別子を
プロジェクトの Info.plist
ファイルで行います。
ステップ 6: 実装をテストする
テスト広告を有効にする
AdMob にテストデバイスを登録し、 IronSource UI でテストモードを有効にします。
テスト広告を確認する
IronSource からテスト広告を受信していることを確認するには、広告インスペクタで ironSource Ads (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
エラーコード
アダプタが ironSource Ads から広告を受信できない場合、パブリッシャーは
広告レスポンスからの根本的なエラーを
ResponseInfo
クラスがあります。
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
ironSource Ads がスローするコードとそのメッセージは次のとおりです。 広告の読み込みに失敗した場合に表示されます。
Android
エラーコード | 理由 |
---|---|
101 | UI に設定されている AdMob ironSource 広告サーバーのパラメータがないか、無効です。 |
102 | ironSource Ads では、SDK を初期化するために Activity コンテキストが必要です。 |
103 | ironSource 広告は、ironSource インスタンス ID ごとに 1 つの広告しかロードできません。 |
105 | リクエストされたバナー広告のサイズは、ironSource 広告でサポートされていません。 |
106 | ironSource Ads SDK が初期化されていません。 |
501-1056 | ironSource Ads SDK エラー。ドキュメントをご覧ください。 をご覧ください。 |
iOS
エラーコード | 理由 |
---|---|
101 | UI に設定されている AdMob ironSource 広告サーバーのパラメータがないか、無効です。 |
102 | ironSource の広告アダプタは、リクエストされた広告フォーマットをサポートしていません。 |
103 | ironSource 広告はこのネットワーク設定用にすでに読み込まれています。 |
104 | リクエストされたバナー広告のサイズは、ironSource 広告でサポートされていません。 |
508-1037 | ironSource Ads SDK エラー。ドキュメントをご覧ください。 をご覧ください。 |
ironSource の Flutter メディエーション アダプタに関する変更履歴
1.0.0
- 初回リリース。
- ironSource Android アダプター バージョン 8.0.0.0 との互換性を検証済み
- ironSource iOS アダプター バージョン 8.0.0.0.0 との互換性を検証済み
- Google Mobile Ads Flutter プラグインのバージョン 5.1.0 を使って作成、テストしています。