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

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

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

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

統合
入札
ウォーターフォール
形式
バナー
インタースティシャル
特典

要件

  • Unity 5.6 以降
  • 最新の Google Mobile Ads SDK
  • [入札の場合]: AdColony 1.0.5 以降用の Google モバイル広告メディエーション プラグイン（最新バージョンを推奨）
  • Android にデプロイするには
    • Android API レベル 19 以降
  • iOS にデプロイする場合
    • iOS デプロイ ターゲットが 12.0 以降であること
  • Google Mobile Ads SDK を使って動作する Unity プロジェクトが設定されていること。詳しくは、使ってみるをご覧ください。
  • メディエーションのスタートガイドを完了する

ステップ 1: AdColony UI で設定を行う

AdColony アカウントに登録してログインします。[Setup New App] ボタンをクリックして、AdColony パブリッシャー ダッシュボードにアプリを追加します。

AdColony セットアップの新しいアプリ

フォームに入力し、ページの下部にある [Create] をクリックして、アプリを AdColony に追加します。

Android

AdColony アプリ作成

iOS

AdColony アプリ作成

アプリの作成後、アプリの [Basic App Information] セクションで [Monetization] > [Apps] に移動すると、App ID を取得できます。

Android

AdColony アプリ ID

iOS

AdColony アプリ ID

次に、アプリのページの [Ad Zones] セクションにある [Setup New Ad Zone] ボタンをクリックして、新しいゾーンを作成します。すでに作成している場合でも、メディエーション用に新しい AdMob ゾーンを作成することをおすすめします。

Android

AdColony のセットアップ ゾーン

iOS

AdColony のセットアップ ゾーン

広告のプレースメントの作成に関するその他の手順については、ご希望の広告フォーマットに対応するタブをクリックしてください。

  1. [ゾーンはアクティブですか？] を [はい] に設定します。

  2. 広告ゾーンの名前を入力します。

  3. [ゾーンのサイズ] で [バナー] を選択します。

  4. [1 日のプレイ上限] の値を入力します。

インタースティシャル

  1. [ゾーンはアクティブですか？] を [はい] に設定します。

  2. 広告ゾーンの名前を入力します。

  3. [ゾーンタイプ] で [プレロール/インタースティシャル] を選択します。

  4. [1 日のプレイ上限] の値を入力します。

特典

  1. [ゾーンはアクティブですか？] を [はい] に設定します。

  2. 広告ゾーンの名前を入力します。

  3. [Zone Type] で [Value Exchange/V4VC] を選択します。

  4. [Client Side Only?] を [Yes] に設定し、[Virtual Currency Name]、[Daily Max Videos per User]、[Reward Amount] を入力します。

  5. [1 日のプレイ上限] の値を入力します。

完了したら [作成] ボタンをクリックして、アドゾーンを作成します。

ゾーンが作成されたら、ゾーンの [統合] セクションでゾーン ID を確認できます。ゾーン ID は次の手順で使用します。

AdColony ゾーン ID

AdColony API キーを確認する

入札

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

ウォーターフォール

AdMob 広告ユニット ID を設定するには、AdColony API キーが必要です。AdColony のパブリッシャー ダッシュボードの [Account Settings] に移動して、API キーを探します。

AdColony の設定

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

AdColony でテスト広告を有効にするには、AdColony のダッシュボードに移動し、[収益化] > [アプリ] に移動します。アプリの [Ad Zones] セクションで、テスト広告を有効にするゾーンを選択します。テスト広告を有効にするには、[Development] セクションの [Show test ads only?] で [Yes] をオンにします。

AdColony のテスト

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

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

Android

手順については、 Android 向けガイドのステップ 2 をご覧ください。

iOS

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

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

GDPR 設定 米国の州規制の設定 の手順に沿って、 AdMob UI の GDPR および米国の州規制の広告パートナーのリストに AdColony を追加します。

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

変更履歴のダウンロード リンクから AdColony 向け Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsAdColonyMediation.unitypackage を抽出します。

Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsAdColonyMediation.unitypackage ファイルを見つけます。すべてのファイルが選択されていることを確認し、[Import]（インポート）をクリックします。

次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolver] を選択します。External Dependency Manager ライブラリは、依存関係の解決をゼロから行い、宣言された依存関係を Unity アプリの Assets/Plugins/Android ディレクトリにコピーします。

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

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

AdColony バージョン 2.6.1 向けの Google Mobile Ads メディエーション プラグインでは、SetPrivacyFrameworkRequired() メソッドと SetPrivacyConsentString() メソッドを含む AdColonyAppOptions クラスが追加され、AdColony SDK に同意を渡せるようになりました。次のサンプルコードは、同意情報を AdColony アダプタに渡す方法を示しています。この受け渡しは、AdColony の初期化メソッドで使用されます。これらのオプションは、AdColony の SDK に正しく転送されるように、Google Mobile Ads SDK を初期化する前に設定する必要があります。

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");

このメソッドの詳細と、このメソッドで指定できる値については、AdColony の消費者プライバシーに関する記事とプライバシー法の実装ガイドをご覧ください。

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

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

AdColony バージョン 2.6.1 向けの Google Mobile Ads メディエーション プラグインでは、SetPrivacyFrameworkRequired() メソッドと SetPrivacyConsentString() メソッドを含む AdColonyAppOptions クラスが追加され、AdColony SDK に同意を渡せるようになりました。次のサンプルコードは、同意情報を AdColony アダプタに渡す方法を示しています。この後、この情報は AdColony の初期化メソッドで使用されます。これらのオプションは、AdColony の SDK に正しく転送されるように、Google Mobile Ads SDK を初期化する前に設定する必要があります。

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");

このメソッドの詳細と、このメソッドで指定できる値については、AdColony の消費者プライバシーに関する記事とプライバシー法の実装ガイドをご覧ください。

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

Android

AdColony との統合には、追加のコードは必要ありません。

iOS

SKAdNetwork との統合

AdColony のドキュメントに沿って、プロジェクトの Info.plist ファイルに SKAdNetwork ID を追加します。

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

テスト広告を有効にする

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

テスト広告を確認する

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

省略可能なステップ

Android

権限

最適なパフォーマンスを実現するために、AdColony では Unity プロジェクトの Assets/Plugins/Android/GoogleMobileAdsPlugin ディレクトリにある AndroidManifest.xml ファイルに次のオプションの権限を追加することをおすすめします。

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />

iOS

iOS との統合に追加の手順は必要ありません。

ネットワーク固有のパラメータ

AdColony メディエーション パッケージは、追加の設定パラメータとリクエスト パラメータをサポートしています。これらのパラメータは、AdColonyMediationExtras クラスと AdColonyAppOptions クラスを使用してアダプタに渡すことができます。

AdColonyMediationExtras クラスには次のメソッドが含まれます。

SetShowPrePopup(bool)
広告を表示する前にポップアップを表示するかどうかを設定します。広告を表示する前にポップアップを表示しない場合は、false に設定します。
SetShowPostPopup(bool)
広告の表示後にポップアップを表示するかどうかを設定します。広告の表示後にポップアップを表示しない場合は、false に設定します。

AdColonyAppOptions クラスには次のメソッドが含まれます。

SetUserId(string)
AdColony 広告サーバーに詳細な分析を提供する AdColony SDK のユーザー ID を設定します。
SetTestMode(bool)
AdColony SDK のテストモードを有効にするかどうかを設定します。

以下は、これらの構成と広告リクエスト パラメータを設定する方法のコード例です。

// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);

// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

エラーコード

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

Android

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

iOS

GADMAdapterAdColony
GADMediationAdapterAdColony

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

Android

エラーコード 理由
100 AdColony SDK からエラーが返されました。
101 サーバー パラメータが無効です（ゾーン ID が指定されていないなど）。
102 同じゾーン ID の広告がすでにリクエストされています。
103 AdColony SDK から初期化エラーが返されました。
104 リクエストされたバナーサイズが、有効な AdColony 広告サイズにマッピングされていません。
105 広告が読み込まれていないため、表示エラーが発生しました。
106 AdColony SDK の初期化に使用されるコンテキストが Activity インスタンスではありませんでした。

iOS

エラーコード 理由
0 ～ 3 AdColony SDK からエラーが返されました。詳しくは、ドキュメントをご覧ください。
101 サーバー パラメータが無効です（ゾーン ID が指定されていないなど）。
102 広告を表示するルート ビュー コントローラは nil です。
103 AdColony SDK から初期化エラーが返されました。
104 AdColony SDK では、5 秒間に 2 回設定することはできません。
105 広告を表示できませんでした。
106 リワードで使用するゾーンが AdColony ポータルのリワードゾーンではありません。

AdColony Unity メディエーション プラグインに関する変更履歴

バージョン 2.6.3（進行中）

  • MediationExtras の重複定義の警告を修正しました。

バージョン 2.6.2

バージョン 2.6.1

  • AdColonyAppOptions クラスのプライバシー API を、GDPR と CCPA をサポートする次のメソッドに更新しました。
    • SetGDPRRequired(bool) -> SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
    • IsGDPRRequired() -> GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
    • SetGDPRConsentString(string)-> SetPrivacyConsentString(AdColonyPrivacyFramework, string)
    • GetGDPRConsentString() -> GetPrivacyConsentString(AdColonyPrivacyFramework)
  • AdColony Android アダプタ バージョン 4.8.0.1 をサポートします。
  • AdColony iOS アダプター バージョン 4.9.0.2 をサポートします。
  • Google Mobile Ads Unity プラグイン バージョン 7.4.1 でビルドおよびテストされています。

バージョン 2.6.0

バージョン 2.5.0

バージョン 2.4.1

バージョン 2.4.0

バージョン 2.3.0

バージョン 2.2.0

バージョン 2.1.0

バージョン 2.0.3

バージョン 2.0.2

バージョン 2.0.1

バージョン 2.0.0

バージョン 1.0.6

バージョン 1.0.5

  • 以下のメソッドを AdColonyMediationExtras Builder クラスから AdColonyAppOptions クラスに移動しました。
    • SetGDPRRequired()
    • SetGDPRConsentString()
    • SetUserId()
    • SetTestMode()
  • AdColonyAppOptions クラスに次のメソッドを追加しました。
    • IsGDPRRequired()
    • GetGDPRConsentString()
    • GetUserId()
    • IsTestMode()
  • AdColonyMediationExtras Builder クラスから SetZoneId() メソッドを削除しました。
  • AdColony Android アダプタ バージョン 3.3.10.1 をサポートします。
  • AdColony iOS アダプタ バージョン 3.3.7.2 をサポートします。

バージョン 1.0.4

  • 新しいオープンベータ版リワード API をサポートするようにプラグインを更新しました。
  • AdColony Android アダプタ バージョン 3.3.8.1 をサポートします。
  • AdColony iOS アダプタ バージョン 3.3.6.1 をサポートします。

バージョン 1.0.3

  • AdColony Android アダプタ バージョン 3.3.5.1 をサポートします。
  • AdColony iOS アダプタ バージョン 3.3.5.0 をサポートします。

バージョン 1.0.2

  • AdColony Android SDK バージョン 3.3.4 をサポート
  • AdColony iOS SDK バージョン 3.3.4 をサポートします。
  • AdColonyMediationExtras Builder クラスの SetTestMode() が Android で無視されるようになりました。Android 向け AdColony にテスト広告をリクエストできるようになりました。それには、AdRequest Builder クラスの AddTestDevice() でテストデバイスを指定します。
  • AdColonyMediationExtras Builder クラスに次のメソッドを追加しました。
    • SetGDPRRequired()
    • SetGDPRConsentString()

バージョン 1.0.1

  • AdColony Android SDK バージョン 3.3.0-unity をサポートします。
  • AdColony iOS SDK バージョン 3.3.0 をサポートします。

バージョン 1.0.0

  • 初回リリース
  • AdColony Android SDK バージョン 3.3.0 をサポートします。
  • AdColony iOS SDK バージョン 3.3.0 をサポートします。