VAMP SDK

Video Ad Mediation Platform Software Development Kit

AdMobの統合

このガイドではAndroidアプリにVAMP SDKのAdMobアダプターを導入する方法について説明します。

最新のアダプター

現在リリースされているVAMPAdMobAdapterの最新バージョンはこちらになります。

Note

アダプターによってサポートされているOSバージョンでも、VAMP SDKによってサポートされているOSバージョンでなければ、広告を表示することはできません。

最新アダプターバージョン 対応アドネットワークバージョン 最低サポートOS 更新日
23.4.0 23.4.0
[公式リリースへ]		 Lollipop(5.0) 2024-10-09

gradleでアダプターをインストール

まずは、gradleでアダプターをインストールします。

build.gradle(project-level)に以下を追記します。

allprojects {
    repositories {
        ・・・(省略)・・・
        maven {
            url "https://maven.google.com"
        }
    }
}

build.gradle(app-level)に以下を追記します。

dependencies {
    ・・・(省略)・・・
    implementation 'com.google.android.gms:play-services-base:[Version]'
    implementation 'jp.supership.vamp:vamp-admob-adapter:[Version]'
}

AndroidManifest.xmlの設定

<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="[ADMOB_APP_ID]"/>

[ADMOB_APP_ID]にAdMobのAppIDを指定してください。

Note

この<meta-data>タグはAdMob 17.0.0から必須です。
この設定に失敗した場合は以下のメッセージがログに表示され、アプリはクラッシュします。
"The Google Mobile Ads SDK was initialized incorrectly."

proguardの設定

SDKを導入したアプリを難読化する際は以下の設定値をproguardの設定ファイルに追加してください。
難読化後の表示確認も必ず行ってください。

-keep class com.google.android.gms.** { *; }
-dontwarn com.google.android.gms.**

注意事項

VAMP SDKよりも先にAdMob SDKを初期化した場合に、AdMobロード時にタイムアウトになる事象が確認されております。
AdMobの初期化を行う場合は、完了通知が受け取れるコールバックを指定できる初期化APIを使用していただくことを推奨します。

VAMPAdMobAdapterの更新履歴

Version 23.4.0（2024-10-09）

  • AdMob SDK 23.4.0と互換性があります。
  • AdMob変更内容（2024‑09‑30）：Ad load failures now invoke a logcat message that says ad failed to load in the failure’s stack trace. The stack trace logs this message as an error, but doesn’t imply a crash. Consult Debug common error logging messages to interpret common ad loading failures. If you see a recurring error related to ad serving that’s not documented, share the stack trace with Mobile Ads SDK support.Added addCustomTargeting() methods to AdRequest.

Version 23.2.0（2024-08-14）

Version 23.0.0.0（2024-06-03）

Version 22.4.0.1（2023-10-18）

  • AdMob SDK 22.4.0と互換性があります。
  • VAMPAdMobAdapterのみアップデート

Version 22.4.0.0（2023-09-14）

  • AdMob SDK 22.4.0と互換性があります。
  • AdMob変更内容（2023-09-13）：Ad inspector: Added SDK support for requesting and showing ads requested through Ad Inspector UI.Note: The ad inspector UI will roll out this feature at a later date, requiring a minimum SDK version of 21.4.0.Added a new QueryInfo.generate() method that takes an ad unit ID.Enables initial testing of the Attribution Reporting Beta and Topics Beta privacy-preserving APIs. See the AdMob Privacy Sandbox on Android guide for more information.

Version 22.2.0.0（2023-07-10）

  • AdMob SDK 22.2.0と互換性があります。
  • AdMob変更内容（2023-07-05）：Custom events: Deprecated AdRequest.Builder.addCustomEventExtrasBundle(). Extend Adapter and interact with the extra parameters through AdRequest.Builder.addNetworkExtrasBundle() instead.Deprecated AdRequest.getCustomEventExtrasBundle(). Extend Adapter and interact with the extra parameters through AdRequest.getNetworkExtrasBundle() instead.

Version 22.1.0.0（2023-05-22）

  • AdMob SDK 22.1.0と互換性があります。
  • AdMob変更内容（2023-05-18）：Ad inspector: Enabled ability to trigger ad requests from the ad inspector UI on devices that don’t have Google Play services.

Version 21.5.0.0（2023-02-01）

  • AdMob SDK 21.5.0と互換性があります。
  • AdMob変更内容（2023-01-31）：アプリ起動時広告: 向きの入力パラメータを受け入れる AppOpenAd.load()メソッドのサポートが終了し、向きの入力を受け取らない新しいメソッドが追加されました。新しいメソッドは、リクエスト時に方向を判別し、他の全画面フォーマットの動作と一致します。メディエーション: アプリ起動時広告でメディエーションがサポートされるようになりました。

Version 21.4.0.0（2022-12-26）

  • AdMob SDK 21.4.0と互換性があります。
  • AdMob変更内容（2022-12-14）：アド マネージャー アプリ ID はすべてのアドマネージャー アプリで必須になり、ca-app-pub-################~########## 形式が必要となります。詳細については、アプリを構成するをご覧ください。広告インスペクタ: 広告インスペクタ UI を通じてリクエストされたバナー広告とネイティブ広告を表示する SDK のサポートを拡張します。

Version 21.3.0.0（2022-10-25）

  • AdMob SDK 21.3.0と互換性があります。 -Ad Inspector: Added SDK support for requesting and showing ads requested through Ad Inspector UI.Note: The Ad Inspector UI will roll out this feature at a later date, requiring a minimum SDK version of 21.3.0.Native Ads:Added getMediaContent() to MediaView.Custom Native Ads:Added getMediaContent() to NativeCustomFormatAd.Deprecated getVideoMediaView(). Create your own MediaView and use NativeCustomFormatAd.getMediaContent() instead.Deprecated getVideoController(). Use NativeCustomFormatAd.getMediaContent().getVideoController() instead

Version 21.2.0.0（2022-09-07）

  • AdMob SDK 21.2.0と互換性があります。

Version 21.1.0.0（2022-08-02）

  • AdMob SDK 21.1.0と互換性があります。

Version 20.6.0.0

  • AdMob SDK 20.6.0と互換性があります。

Version 20.5.0.0

  • AdMob SDK 20.5.0と互換性があります。

Version 20.3.0.0

  • AdMob SDK 20.3.0と互換性があります。

Version 20.2.0.0

  • AdMob SDK 20.2.0と互換性があります。

Version 20.1.0.0

  • AdMob SDK 20.1.0と互換性があります。

Version 19.8.0.1

  • AdMob SDK 19.8.0と互換性があります。
  • VAMP SDK v4.1.0以降が必要です。