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

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

nend のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。以下のスクリーンショットは翻訳されていません。ただし、このガイドのテキストでは、ラベルとボタンは英語名で参照しています。たとえば、「URL スキーム」は「URL スキーム」のように表されます。

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

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

要件

  • Unity 4 以降
  • 最新の Google Mobile Ads SDK
  • Android にデプロイするには
    • Android API レベル 19 以降
  • iOS にデプロイする場合
    • iOS デプロイ ターゲットが 12.0 以降であること
  • Google Mobile Ads SDK を使って動作する Unity プロジェクトが設定されていること。詳しくは、使ってみるをご覧ください。
  • メディエーションのスタートガイドを完了します。

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

nend アカウントに登録またはログインします。

アプリを nend ダッシュボードに追加するには、まず [プレースメント管理] タブをクリックし、[サイト/アプリ] を選択します。[アプリを追加] ボタンをクリックして、nend にアプリを追加します。

アプリケーションを作成する

アプリの名前を入力し、アプリケーション タイプとしてアプリ プラットフォームを選択します。URL を入力し、適切なアプリストアにアプリが掲載されているかどうかを確認します。

（アプリがまだリリースされていない場合は、nend の未リリースのアプリに関するよくある質問をご覧ください）。アプリのカテゴリを選択し、完了したら [作成] をクリックします。

Android

iOS

アプリケーションが作成されると、ダッシュボードに表示されます。

Android

iOS

プレースメントを作成する

アプリを登録したら、プレースメントの作成に進むことができます。バナー広告のプレースメントを作成するには、[プレースメント管理] タブで [プレースメント] をクリックします。次に、[新しいプレースメントを作成] ボタンをクリックします。

プルダウン メニューからアプリを選択します。次に、使用する広告フォーマットに対応する以下の手順を実施します。

[広告タイプ] で [静止画像] を選択し、[広告枠のタイプ] で [バナー] を選択します。完了したら、プレースメント名を入力し、広告枠の概要に記入し、広告枠のフォーマットを選択して、最後に広告枠のサイズを選択します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

インタースティシャル

[広告タイプ] で [静止画像] を選択し、[広告枠のタイプ] で [インタースティシャル] を選択します。完了したら、プレースメント名を入力し、[広告枠の概要] に入力し、プルダウン リストから [広告の表示頻度] を選択します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

インタースティシャル動画広告の場合は、[広告タイプ] に [動画] を選択し、[広告枠のタイプ] に [インタースティシャル] を選択します。完了したら、[プレースメント名] を入力し、[広告枠の概要] に入力し、プルダウン リストから適切な [カテゴリ] を選択します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

特典

[広告タイプ] で [動画] を選択し、[広告枠のタイプ] で [リワード] を選択します。完了したら、プレースメント名を入力し、[広告枠の概要] に入力し、プルダウン リストから適切なカテゴリを選択します。

[報酬の設定] で、プルダウン リストを使用して [特典コンテンツ] を選択し、お好みの仮想通貨の名前を入力します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

ネイティブ

[広告タイプ] で [静止画像] を選択し、[広告枠のタイプ] で [ネイティブ] を選択します。完了したら、プレースメント名を入力し、[広告枠の概要] に入力して、[広告画像の選択] を選択します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

ネイティブ動画広告の場合は、[広告タイプ] で [動画] を選択し、[広告枠のタイプ] で [ネイティブ（カスタム）] を選択します。完了したら、プレースメント名を入力し、[広告枠の概要] に入力して、プルダウン リストから適切なカテゴリを選択します。

[ネイティブ設定] で、リストから [動画広告の向き] と [ネイティブ広告タイプ] を選択します。完了したら、[作成] ボタンをクリックしてプレースメントを作成します。

次のセクションで AdMob 広告ユニットを設定するには、各プレースメントの apiKey と spotID が必要です。確認するには、[プレースメント管理] タブで、アプリ名の下にある [SDK] ボタンを選択します。

apiKey と spotID をメモしておきます。

また、nend の Reporting API で使用する API キーも必要です。この API は、スクレイピング用の API キーと呼んでいます。この機能は [Tools] タブから利用できます。

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

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

Android

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

iOS

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

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

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

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

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

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

Android

nend との統合にコードを追加する必要はありません。

iOS

SKAdNetwork との統合

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

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

テスト広告を有効にする

AdMob。 バナー、インタースティシャル、リワードのテスト広告を取得するには、 nend テスト広告ユニット のページで提供される API キーとスポット ID を使用することをおすすめします。これらの ID は、テスト中は AdMob 広告ユニットの API キーと Spot ID として入力できます。アプリの本番環境の準備が整うと、実際の API キーと Spot ID に置き換えられます。

テスト広告を確認する

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

エラーコード

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

Android

com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter

iOS

GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend

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

Android

エラーコード ドメイン 理由
101 com.google.ads.mediation.nend nend では、広告を読み込んで表示するには、アクティビティのコンテキストが必要です。
102 com.google.ads.mediation.nend UI で設定されている nend サーバーのパラメータが見つからないか、無効です。 AdMob
103 com.google.ads.mediation.nend nend の広告はまだ表示できる準備が整っていません。
104 com.google.ads.mediation.nend nend が広告を再生できませんでした。
105 com.google.ads.mediation.nend リクエストされた広告サイズが、nend でサポートされているバナーサイズと一致しません。
106 com.google.ads.mediation.nend Context オブジェクト参照が null であるか、メモリから最近解放されました。
200-299 net.nend.android nend SDK からインタースティシャル広告の読み込みエラーが返されました。詳しくは、コードをご覧ください。
300-399 net.nend.android nend SDK からインタースティシャル広告の表示エラーが返されました。詳しくは、コードをご覧ください。
400-499 net.nend.android nend SDK から広告エラーが返されました。詳しくは、コードをご覧ください。

iOS

エラーコード ドメイン 理由
101 com.google.mediation.nend nend SDK が、追加のエラー情報なしで読み込み失敗のコールバックを返しました。
102 com.google.mediation.nend nend SDK が、追加のエラー情報なしで障害を示すコールバックを返しました。
103 com.google.mediation.nend UI で設定されている nend サーバーのパラメータが見つからないか、無効です。 AdMob
104 com.google.mediation.nend ネイティブ広告の画像アセットを読み込めませんでした。
105 com.google.mediation.nend 広告の準備ができていないため、nend の広告を表示できませんでした。
106 com.google.mediation.nend リクエストされたバナー広告のサイズが、nend でサポートされているバナーサイズと一致しません。
200 ～ 699 nend SDK から送信されています。 nend SDK からエラーが返されました。詳しくは、nend のドキュメントをご覧ください。

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

バージョン 8.0.0

バージョン 7.0.0

バージョン 6.0.1

バージョン 6.0.0

バージョン 5.2.0

バージョン 5.1.0

バージョン 5.0.0

バージョン 4.0.1

バージョン 4.0.0

バージョン 3.0.0

バージョン 2.3.0

バージョン 2.2.0

バージョン 2.1.0

  • 新しい リワード広告 API をサポートするようにプラグインを更新しました。
  • nend Android アダプター バージョン 5.1.0.2 に対応しています。
  • nend iOS アダプター バージョン 5.1.1.0 に対応しています。

バージョン 2.0.3

  • nend Android アダプター バージョン 5.0.2.1 に対応しています。
  • nend iOS アダプター バージョン 5.0.2.0 に対応しています。

バージョン 2.0.2

  • nend Android アダプター バージョン 5.0.2.0 に対応しています。
  • nend iOS アダプター バージョン 5.0.2.0 に対応しています。

バージョン 2.0.1

  • nend Android アダプター バージョン 5.0.2.0 に対応しています。
  • nend iOS アダプター バージョン 5.0.1.0 に対応しています。

バージョン 2.0.0

  • nend Android アダプター バージョン 5.0.0.0 に対応しています。
  • nend iOS アダプター バージョン 5.0.0.0 に対応しています。

バージョン 1.0.2

  • nend Android アダプター バージョン 4.0.5.0 に対応しています。
  • nend iOS アダプター バージョン 4.0.6.0 に対応しています。

バージョン 1.0.1

  • nend Android SDK バージョン 4.0.4 をサポート。
  • nend iOS SDK バージョン 4.0.4 をサポート。

バージョン 1.0.0

  • 初回リリース
  • nend Android SDK バージョン 4.0.2 をサポート。
  • nend iOS SDK バージョン 4.0.2 をサポート。