Skip to content
This repository has been archived by the owner on Feb 14, 2022. It is now read-only.

導入方法

Jump to bottom
fan-t-fukuoka edited this page Apr 13, 2018 · 24 revisions

対応環境

  • MoPub SDK 4.20.0 or higher
  • Android API level 16 or higher

導入方法

カスタムイベントクラスの登録

Custom SDK Network の説明内容に従い、利用される広告タイプのCUSTOM EVENT CLASSとCUSTOM EVENT CLASS DATAを設定します。

広告タイプ CUSTOM EVENT CLASS CUSTOM EVENT CLASS DATA
バナー net.nend.android.mopub.customevent.NendBannerCustomEvent { "spotId": Your Spot Id, "apiKey": "Your Api Key" }

※ 例）spotIdが「1234」、apiKeyが「ABCDEF」の場合は
{ "spotId": 1234, "apiKey": "ABCDEF" }
となります
インタースティシャル net.nend.android.mopub.customevent.NendInterstitialVideoCustomEvent 同上
動画リワード net.nend.android.mopub.customevent.NendRewardedVideoCustomEvent 同上
動画インタースティシャル net.nend.android.mopub.customevent.NendInterstitialVideoCustomEvent { "spotId": Your Spot Id, "apiKey": "Your Api Key", "video" : true }

nendSDKとカスタムイベント用ライブラリとMoPub SDKをプロジェクトに追加する

Gradleで追加する

この方法で導入した場合、nendSDKとMoPub SDKへの依存関係も自動的に解決することが出来ます。

  1. build.gradleにあるrepositoriesへmavenのURLを追加する 
    maven {
      // nendSDK-MoPub-CustomEvent
      url 'http://fan-adn.github.io/nendSDK-Android-lib/library'
}
  2. アプリのbuild.gradleにあるdependenciesへ以下の1行を追加する 
    implementation 'net.nend.android:nend-custom-event-mopub:1.2.0'

カスタムイベント用ライブラリをjarファイルで追加する

  1. こちらからカスタムイベント用ライブラリをダウンロードします。

  2. app / libs ディレクトリにnendMoPubCustomEvent-x.x.x.jarファイルをコピー&ペーストで追加します。もしlibsディレクトリがない場合は、ディレクトリを作成してからnendMoPubCustomEvent-x.x.x.jarを追加してください。 x.x.xはバージョン番号となります。最新バージョンのものをご利用下さい。

    sc1

    sc2

  3. dependenciesに以下の記述を追加します。（既にある場合は追加不要です）

    dependencies {
    // ~省略~
    compile fileTree(dir: 'libs', include: ['*.jar'])
}

  4. Syncボタンをクリックします。
    sc3

  5. 次にnendSDKとMoPub SDKを導入します。

バナー広告の準備

Banner Adsにならい、バナー広告の使用準備を行います。

バナー広告の対応フォーマット

  • Banner (320x50)
  • Medium (300x250)
  • Leaderboard (728x90)

動画リワードの準備

Rewarded Video Ads にならい、動画リワードの使用準備を行います。

インタースティシャル広告の準備

カスタムイベント用ライブラリv1.2.0から、インタースティシャル広告のカスタムイベントに対応しました。

  1. nendの動画インタースティシャルを利用する場合は、MoPub管理画面のカスタムイベントクラスの登録 でnendの動画インタースティシャル広告のspotIdとapiKey、さらにvideoをtrueにして以下のように設定します。
    通常のnendインタースティシャル広告を利用する場合は、videoの設定は不要です。 image1_android

  2. Interstitial Ads にならい、インタースティシャル広告の使用準備を行います。

オプション設定

以下のオプションは、動画リワードと動画インタースティシャルのみで利用可能です。

ユーザーID

アプリ内のユーザIDをセットすることでnendのユーザー管理に役立ちます。

  • カスタムイベント用ライブラリv1.1.0からNendInstanceMediationSettingsのコンストラクタにユーザIDを設定する方法は非推奨になりました。
  • カスタムイベント用ライブラリv1.2.0からNendRewardedVideoCustomEventクラスのNendInstanceMediationSettingsでユーザーIDを設定する方法は非推奨になりました。

動画リワード

Java 
// ユーザーIDのみ利用する例
NendMediationSettings settings = new NendMediationSettings.Builder()
        .setUserId("your-user-id")  // ユーザーID
        .build();
MoPubRewardedVideos.loadRewardedVideo("your-ad-unit-id", settings);
kotlin 
val settings = NendMediationSettings.Builder()
        .setUserId("you user id") // ユーザーID
        .build()
MoPubRewardedVideos.loadRewardedVideo("your-ad-unit-id", settings)

動画インタースティシャル

Java 
private MoPubInterstitial interstitial;

...

// ユーザーIDのみ利用する例
NendMediationSettings settings = new NendMediationSettings.Builder()
        .setUserId("your-user-id")  // ユーザーID
        .build();

interstitial = new MoPubInterstitial(this, "your-ad-unit-id");
interstitial.load();
kotlin 
private var interstitial: MoPubInterstitial? = null

...

val settings = NendMediationSettings.Builder()
        .setUserId("you user id") // ユーザーID
        .build()

interstitial = MoPubInterstitial(this, "your-ad-unit-id")
interstitial.load()

以下のユーザー属性と一緒に設定することも可能です。

ユーザー属性

  • カスタムイベント用ライブラリv1.2.0からNendRewardedVideoCustomEventクラスのNendInstanceMediationSettingsでユーザー属性を設定する方法は非推奨になりました。

カスタムイベント用ライブラリv1.1.0から動画広告のターゲティングにユーザー属性を利用できるようになりました。
利用可能なユーザー属性は以下の通りです。

  • 性別
  • 生年月日
  • 年齢
  • その他特徴（アプリ側で自由に設定可能）

動画リワード

Java 
// 単一の属性を利用する例
NendMediationSettings settings = new NendMediationSettings.Builder()
        .setBirthday(2000,1,1) // 生年月日 (e.g. 2000年1月1日)
        .build();
MoPubRewardedVideos.loadRewardedVideo("your-ad-unit-id", settings);

...

// ユーザーIDと複数の属性を利用する例
NendMediationSettings settings = new NendMediationSettings.Builder()
        .setUserId("your-user-id")  // ユーザーID
        .setAge(18) // 年齢
        .setBirthday(2000,1,1) // 生年月日 (e.g. 2000年1月1日)
        .setGender(NendMediationSettings.GENDER_MALE) // 性別
        .addCustomFeature("customIntParam", 123)  // key-value形式のカスタムパラメーター
        .addCustomFeature("customDoubleParam", 123.45)
        .addCustomFeature("customStringParam", "test")
        .addCustomFeature("customBooleanParam", true)
        .build();
MoPubRewardedVideos.loadRewardedVideo("your-ad-unit-id", settings);
kotlin 
// 単一の属性を利用する例
val settings = NendMediationSettings.Builder()
        .setBirthday(2000, 1, 1) // 生年月日 (e.g. 2000年1月1日)
        .build()
MoPubRewardedVideos.loadRewardedVideo("your-ad-unit-id", settings)

...

// ユーザーIDと複数の属性を利用する例
val settings = NendMediationSettings.Builder()
        .setUserId("your-user-id") // ユーザーID
        .setAge(18) // 年齢
        .setBirthday(2000, 1, 1) // 生年月日 (e.g. 2000年1月1日)
        .setGender(NendMediationSettings.GENDER_MALE) // 性別
        .addCustomFeature("customIntParam", 123) // key-value形式のカスタムパラメーター
        .addCustomFeature("customDoubleParam", 123.45)
        .addCustomFeature("customStringParam", "test")
        .addCustomFeature("customBooleanParam", true)
        .build()
MoPubRewardedVideos.loadRewardedVideo("your-ad-unit-id", settings)

動画インタースティシャル

Java 
private MoPubInterstitial interstitial;

...

// 単一の属性を利用する例
NendMediationSettings settings = new NendMediationSettings.Builder()
        .setBirthday(2000,1,1) // 生年月日 (e.g. 2000年1月1日)
        .build();

interstitial = new MoPubInterstitial(this, "your-ad-unit-id");
interstitial.load();

...

// ユーザーIDと複数の属性を利用する例
NendMediationSettings settings = new NendMediationSettings.Builder()
        .setUserId("your-user-id")  // ユーザーID
        .setAge(18) // 年齢
        .setBirthday(2000,1,1) // 生年月日 (e.g. 2000年1月1日)
        .setGender(NendMediationSettings.GENDER_MALE) // 性別
        .addCustomFeature("customIntParam", 123)  // key-value形式のカスタムパラメーター
        .addCustomFeature("customDoubleParam", 123.45)
        .addCustomFeature("customStringParam", "test")
        .addCustomFeature("customBooleanParam", true)
        .build();

interstitial = new MoPubInterstitial(this, "your-ad-unit-id");
interstitial.load();
kotlin 
private var interstitial: MoPubInterstitial? = null

...

// 単一の属性を利用する例
val settings = NendMediationSettings.Builder()
        .setBirthday(2000, 1, 1) // 生年月日 (e.g. 2000年1月1日)
        .build()

interstitial = MoPubInterstitial(this, "your-ad-unit-id")
interstitial.load()           
...

// ユーザーIDと複数の属性を利用する例
val settings = NendMediationSettings.Builder()
        .setUserId("your-user-id") // ユーザーID
        .setAge(18) // 年齢
        .setBirthday(2000, 1, 1) // 生年月日 (e.g. 2000年1月1日)
        .setGender(NendMediationSettings.GENDER_MALE) // 性別
        .addCustomFeature("customIntParam", 123) // key-value形式のカスタムパラメーター
        .addCustomFeature("customDoubleParam", 123.45)
        .addCustomFeature("customStringParam", "test")
        .addCustomFeature("customBooleanParam", true)
        .build()

interstitial = MoPubInterstitial(this, "your-ad-unit-id")
interstitial.load()

カスタムイベントアダプター終了のお知らせ

MoPubが2022年3月31日を以て終了するに当り、nendで提供しているMoPub SDKのカスタムイベントアダプターの提供及びサポートも同日2022年3月31日を以て終了いたします。
終了に伴い、アプリ開発者の方はストアに公開しているアプリに対して、終了の期日までにMoPub SDK及びそれに関連するメディエーションアダプター、カスタムイベントアダプター(nend含む)を依存性から完全に削除して下さい。
今後MAXでnendを利用する場合は、以下の移行ガイドに沿って、MAXメディエーション及びnend用のMAXメディエーションアダプターへの移行を行ってください。

MoPub CustomEvent adapter is closed

Due to shutdown of MoPub platform at the end of March 31, 2022, MoPub CustomEvent adapter for MoPub SDK and our support are also closed on the day.
By the end date, App developers should completely remove MoPub SDK and its mediation adapters and custom event adapters (including nend) from dependencies for apps published to store.
If you want to continue using nend via MAX mediation, please migrate to MAX mediation and its adapter for nend following the migration guide below.

日本語

カスタムイベントアダプタについて

導入サポート

English

About nendSDK CustomEvent Adapter

Supports

Clone this wiki locally