このページは Cloud Translation API によって翻訳されました。

ironSource Ads をメディエーションと統合する

このガイドでは、Google Mobile Ads SDK を使用して、ウォーターフォール統合をカバーするメディエーションを使用して ironSource Ads の広告を読み込んで表示する方法について説明します。ここでは、広告ユニットのメディエーション構成に ironSource Ads を追加する方法と、ironSource Ads SDK とアダプターを Flutter アプリに統合する方法について説明します。

サポートされている統合と広告フォーマット

ironSource Ads 用の AdMob メディエーションアダプタには、次の機能があります。

統合
単価設定	¹
滝
フォーマット
バナー	²
インタースティシャル
特典
リワードインタースティシャル	²

¹ 入札の統合はクローズドベータ版です。アクセス権をリクエストするには、アカウントマネージャーにお問い合わせください。

² この形式はウォーターフォール統合でのみサポートされます。

要件

最新の Google Mobile Ads SDK
Flutter 3.7.0 以降
[入札の場合]: サポートされているすべての広告フォーマットを入札に統合するには、IronSource 用 Google Mobile Ads メディエーションプラグイン 3.0.0 以降（最新バージョンを推奨）を使用します。
Android にデプロイするには
- Android API レベル 21 以降
iOS にデプロイするには
- iOS デプロイターゲットが 12.0 以降
Google Mobile Ads SDK で構成された動作する Flutter プロジェクト。詳細については、スタートガイドをご覧ください。
メディエーションのスタートガイドを完了していること

ステップ 1: ironSource 広告の管理画面で設定を行う

ironSource 広告アカウントに登録してログインします。

アプリケーションを ironSource 広告ダッシュボードに追加するには、[New App] ボタンをクリックします。

アプリの詳細を入力

[ライブアプリ] を選択し、アプリの名前を入力して、[アプリ情報をインポート] をクリックします。

アプリが利用できない場合は、[App Not Live in the Application Store] を選択し、アプリの一時的な名前を入力します。プラットフォームを選択します。

フォームの残りの部分に記入し、[アプリを追加] をクリックします。

アプリの追加後に表示される新しいアプリキーをメモします。この値は、AdMob 広告ユニット ID の設定に必要になります。アプリがサポートする広告フォーマットを選択します。その後、[続行] をクリックします。

Android

iOS

インスタンスを作成

次に、追加したアプリのネットワークインスタンスを構成します。

単価設定

[LevelPlay] > [設定] > [SDK ネットワーク] に移動し、アプリを選択します。[入札] で編集アイコンをクリックして、入札インスタンス ID を表示します。

Android

iOS

インスタンス ID をメモしておきます。

Android

iOS

滝

[広告] > [設定] > [インスタンス] に移動します。アプリを選択し、[インスタンスを作成] をクリックします。

必要な情報を入力し、[保存して閉じる] をクリックします。

インスタンスが作成されると、インスタンス ID が [インスタンス ID] フィールドに表示されます。

Reporting API キーを確認する

単価設定

この手順は、入札の統合では必要ありません。

滝

AdMob 広告ユニット ID を設定するには、アプリキーとインスタンス ID に加えて、ironSource Ads のシークレットキーと更新トークンも必要です。

ironSource 広告パブリッシャーダッシュボードの [マイアカウント] に移動し、[API] タブをクリックします。シークレットキーと更新トークンをメモします。

テストモードをオンにする

ironSource 広告のテスト広告を有効にする方法については、ironSource 広告の統合テストガイドの手順に沿って操作してください。

ステップ 2: AdMob の管理画面で ironSource 広告のデマンドを設定する

広告ユニットのメディエーション設定を構成する

Android

手順については、Android のガイドの手順 2 をご覧ください。

iOS

手順については、iOS 向けガイドの手順 2 をご覧ください。

GDPR と米国の州規制の広告パートナーリストに ironSource Mobile を追加

GDPR の設定と米国の州規制の設定の手順に沿って、AdMob 管理画面の GDPR と米国の州規制の広告パートナーリストに ironSource Mobile を追加します。

ステップ 3: ironSource Ads SDK とアダプタをインポートする

pub.dev による統合

（Android のみ）プロジェクトの android ディレクトリ内の build.gradle ファイルに、次のリポジトリを追加します。

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://android-sdk.is.com/")
      }
  }

パッケージの pubspec.yaml ファイルに、最新バージョンの ironSource Ads SDK とアダプタを含む次の依存関係を追加します。

dependencies:
  gma_mediation_ironsource: ^1.0.0

手動による統合

ironSource Ads 用の Google Mobile Ads メディエーションプラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを解凍して、解凍したプラグインフォルダ（とその内容）を Flutter プロジェクトに追加します。次に、次の依存関係を追加して、pubspec.yaml ファイルでプラグインを参照します。

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

ステップ 4: ironSource Ads SDK にプライバシー設定を実装する

EU の同意と GDPR

Google の EU ユーザーの同意ポリシーに基づき、デバイス ID と個人データの使用について、欧州経済領域（EEA）のユーザーに対して特定の情報を開示し、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。同意を求める際は、個人データを収集、受領、または使用する可能性があるメディエーションチェーン内の各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、Google はユーザーの同意に関する選択を自動的にこのようなネットワークに渡すことはできません。

ironSource 広告用の Google Mobile Ads メディエーションプラグインには、GmaMediationIronsource().SetConsent() メソッドが含まれています。次のサンプルコードは、同意情報を ironSource Ads SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK で広告をリクエストする前に呼び出すことをおすすめします。

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setConsent(true);

詳しくは、ironSource 広告の規制に関する詳細設定に関するドキュメントをご覧ください。

米国のプライバシー関連州法

米国の州のプライバシー法は、ユーザーに「個人情報」の「販売」を拒否する権利を保障する法律で、「販売者」パーティのホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーションチェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に関与する可能性があるメディエーションチェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。

ironSource 広告用の Google Mobile Ads メディエーションプラグインには、GmaMediationIronsource().setDoNotSell メソッドが含まれています。次のサンプルコードは、同意情報を ironSource Ads SDK に渡す方法を示しています。これらのオプションは、Google Mobile Ads SDK を初期化する前に設定する必要があります。そうすることで、ironSource Ads SDK に適切に転送されます。

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setDoNotSell(true);

詳細と、このメソッドで指定できる値については、Android と iOS の両方について、ironSource 広告の規制に関する詳細設定のドキュメントをご覧ください。

ステップ 5: 必要なコードを追加する

Android

Proguard ルール

アプリの圧縮、難読化、最適化を行う場合、IronSource 広告ではプロジェクトに ProGuard ルールを追加する必要があります。

プロジェクトに必要な ProGuard ルールについて詳しくは、IronSource Ads の Android SDK 統合ガイドを参照し、それらのルールを proguard-user.txt ファイルに追加します。

アプリケーションのライフサイクル

各アクティビティの onPause() メソッドと onResume() メソッドをオーバーライドして、対応する ironSource 広告メソッドを次のように呼び出します。

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 ID をプロジェクトの Info.plist ファイルに追加します。

ステップ 6: 実装をテストする

テスト広告を有効にする

AdMob にテストデバイスを登録し、ironSource 広告の管理画面でテストモードを有効にしてください。

テスト広告を確認する

ironSource 広告からテスト広告が配信されていることを確認するには、広告インスペクタで ironSource 広告（入札）と ironSource 広告（ウォーターフォール）の広告ソースを使用して、単一の広告ソースのテストを有効にします。

エラーコード

アダプターが ironSource Ads から広告を受信できない場合、パブリッシャーは次のクラスの ResponseInfo を使用して、広告レスポンスから根本的なエラーを確認できます。

Android

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

広告の読み込みに失敗したときに ironSource 広告アダプタによってスローされるコードと付随するメッセージは次のとおりです。

Android

エラーコード	理由
101	AdMob 管理画面で設定された ironSource 広告サーバーパラメータが存在しないか、無効です。
102	ironSource Ads では、SDK を初期化するためにアクティビティコンテキストが必要です。
103	ironSource Ads では、ironSource インスタンス ID ごとに読み込める広告は 1 つのみです。
105	リクエストされたバナー広告サイズは、ironSource 広告ではサポートされていません。
106	ironSource Ads SDK が初期化されていません。
501-1056	ironSource Ads SDK エラー。詳しくは、こちらのドキュメントをご覧ください。

iOS

エラーコード	理由
101	AdMob 管理画面で設定された ironSource 広告サーバーパラメータが存在しないか、無効です。
102	ironSource 広告アダプターは、リクエストされた広告フォーマットをサポートしていません。
103	このネットワーク構成では、ironSource の広告がすでに読み込まれています。
104	リクエストされたバナー広告サイズは、ironSource 広告ではサポートされていません。
508-1037	ironSource Ads SDK エラー。詳しくは、ドキュメントをご覧ください。

ironSource Flutter メディエーションアダプタの変更履歴

次のバージョン

Google Mobile Ads Flutter プラグインバージョン 5.2.0 でビルド、テスト済み。

1.1.0

ironSource Android アダプターバージョン 8.2.1.0 との互換性が確認されました
ironSource iOS アダプターバージョン 8.2.0.0.0 との互換性が確認されました
Google Mobile Ads Flutter プラグインバージョン 5.1.0 でビルド、テスト済み。

1.0.0

初回リリース。
ironSource Android アダプターバージョン 8.0.0.0 との互換性が確認済み
ironSource iOS アダプターバージョン 8.0.0.0.0 との互換性を確認しました
Google Mobile Ads Flutter プラグインバージョン 5.1.0 でビルド、テスト済み。

ironSource Ads をメディエーションと統合する

サポートされている統合と広告フォーマット

要件

ステップ 1: ironSource 広告の管理画面で設定を行う

アプリの詳細を入力

Android

iOS

インスタンスを作成

単価設定

Android

iOS

Android

iOS

滝

Reporting API キーを確認する

単価設定

滝

テストモードをオンにする

ステップ 2: AdMob の管理画面で ironSource 広告のデマンドを設定する

広告ユニットのメディエーション設定を構成する

Android

iOS

GDPR と米国の州規制の広告パートナー リストに ironSource Mobile を追加

ステップ 3: ironSource Ads SDK とアダプタをインポートする

pub.dev による統合

手動による統合

ステップ 4: ironSource Ads SDK にプライバシー設定を実装する

EU の同意と GDPR

米国のプライバシー関連州法

ステップ 5: 必要なコードを追加する

Android

Proguard ルール

アプリケーションのライフサイクル

Java

Kotlin

iOS

SKAdNetwork の統合

ステップ 6: 実装をテストする

テスト広告を有効にする

テスト広告を確認する

エラーコード

Android

iOS

Android

iOS

ironSource Flutter メディエーション アダプタの変更履歴

次のバージョン

1.1.0

1.0.0

GDPR と米国の州規制の広告パートナーリストに ironSource Mobile を追加

ironSource Flutter メディエーションアダプタの変更履歴