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

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

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

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

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

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

要件

• 最新の Google Mobile Ads SDK
• Flutter 3.7.0 以降
• Android にデプロイするには
  • Android API レベル 21 以降
• iOS にデプロイするには
  • iOS デプロイ ターゲットが 12.0 以降であること
• Google Mobile Ads SDK で構成された Flutter 作業中のプロジェクト。詳しくは、使ってみるをご覧ください。
• メディエーションのスタートガイドを完了している。

ステップ 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 を設定する際に必要になります。アプリがサポートする広告フォーマットを選択します。その後、[続行] をクリックします。

インスタンスを作成

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

Reporting API キーを確認する

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

ironSource Ads のテスト広告を有効にする方法については、ironSource Ads の統合テスト ガイドをご覧ください。

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

広告ユニットのメディエーション設定を行う

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

GDPR 設定 米国の州規制の設定 の手順に沿って、 AdMob UI の 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 SDK とアダプタの最新バージョンとともに次の依存関係を追加します。

dependencies:
  gma_mediation_ironsource: ^1.0.0

手動統合

IronSource の Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを抽出し、抽出したプラグイン フォルダ（とその内容）を 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 Ads 用の Google モバイル広告メディエーション プラグイン には、 GmaMediationIronsource().SetConsent() メソッドが含まれています。次のサンプルコードは、同意情報を ironSource Ads SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に、呼び出すことをおすすめします。

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

GmaMediationIronsource().setConsent(true);

詳しくは、ironSource Ads のドキュメントで規制の詳細設定をご覧ください。

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

米国のプライバシー関連州法 では、ユーザーに対して「個人情報」の「販売」をオプトアウトする権利（法律で定義される）を提供し、「販売」当事者のホームページに目立つ「個人情報を販売しない」リンクを通じてオプトアウトする権利を提供することが義務付けられています。米国のプライバシー関連州法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にすることができますが、メディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に参加する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに従ってコンプライアンスを確保する必要があります。

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

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

GmaMediationIronsource().setDoNotSell(true);

詳細およびメソッドで指定できる値については、Android と iOS の規則の詳細設定に関する ironSource Ads のドキュメントをご覧ください。

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

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

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

テスト広告を有効にする

AdMob にテストデバイスを登録し、 IronSource UI でテストモードを有効にします。

テスト広告を確認する

IronSource からテスト広告を受信していることを確認するには、広告インスペクタで ironSource Ads (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。

エラーコード

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

広告の読み込みに失敗したときに ironSource Ads アダプタがスローするコードとそのメッセージは次のとおりです。

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 を使って作成、テストしています。