Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

バナー広告を設定する

プラットフォームを選択: Android iOS Unity Flutter Android（以前のバージョン）

バナー広告は、アプリのレイアウトの一部に表示される長方形の広告です。アンカーアダプティブバナーは、アスペクト比が固定された広告で、ユーザーがアプリを操作している間、画面の上部または下部に固定された状態で表示されます。

このガイドでは、アンカーアダプティブバナー広告を Android アプリに読み込む方法について説明します。

前提条件

GMA Next-Gen SDK を設定します。

必ずテスト広告でテストする

アプリの開発とテストでは必ずテスト広告を使用し、配信中の実際の広告は使用しないでください。実際の広告を使用すると、アカウントが停止される可能性があります。

テスト広告は、次に示す Android バナー広告向けのテスト専用広告ユニット ID を使うと簡単に読み込むことができます。

/21775744923/example/adaptive-banner

この ID は、すべてのリクエストに対してテスト広告を返す特殊な設定になっており、アプリのコーディング、テスト、デバッグで使用できます。なお、テスト専用広告ユニット ID は、アプリを公開する前に必ずご自身の広告ユニット ID に置き換えてください。

GMA Next-Gen SDK のテスト広告の仕組みについて詳しくは、テスト広告を有効にするをご覧ください。

`AdView` オブジェクトを作成する

バナーを表示する手順は次のとおりです。

Kotlin

AdView オブジェクトを作成します。
アプリのレイアウトに AdView オブジェクトを追加します。

次の例では、AdView オブジェクトを作成してアプリのレイアウトに追加します。

private fun createAdView(adViewContainer: FrameLayout, activity: Activity) {
  val adView = AdView(activity)
  adViewContainer.addView(adView)
}
BannerSnippets.kt

Java

AdView オブジェクトを作成します。
AdView オブジェクトをアプリのレイアウトに追加します。

次の例では、AdView オブジェクトを作成してアプリのレイアウトに追加します。

private void createAdView(FrameLayout adViewContainer, Activity activity) {
  AdView adView = new AdView(activity);
  adViewContainer.addView(adView);
}
BannerSnippets.java

XML レイアウト

レイアウト XML ファイルに AdView 要素を追加します。

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

  <com.google.android.libraries.ads.mobile.sdk.banner.AdView
      android:id="@+id/adView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      app:layout_constraintBottom_toBottomOf="parent"
      app:layout_constraintEnd_toEndOf="parent"
      app:layout_constraintStart_toStartOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

Jetpack Compose

remember ブロック内に AdView オブジェクトを作成します。
Compose UI に AndroidView 要素を追加して、AdView オブジェクトを表示します。

val context = LocalContext.current
val adView = remember { AdView(context) }

// The AdView is placed at the bottom of the screen.
Column(modifier = modifier.fillMaxSize(), verticalArrangement = Arrangement.Bottom) {
  Box(modifier = modifier.fillMaxWidth()) {
    // Display the ad within an AndroidView.
    AndroidView(modifier = modifier.wrapContentSize(), factory = { adView })
  }
}ComposeBannerFragment.kt

広告を読み込む

次の例では、幅 360 のアンカーアダプティブバナー広告を AdView オブジェクトに読み込んでいます。

Kotlin

private fun loadBannerAd(adView: AdView, activity: Activity) {
  // Get a BannerAdRequest for a 360 wide large anchored adaptive banner ad.
  val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360)
  val adRequest = BannerAdRequest.Builder(AD_UNIT_ID, adSize).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.d(TAG, "Banner ad loaded.")
      }

      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Banner ad failed to load: $adError")
      }
    },
  )
}
BannerSnippets.kt

Java

private void loadBannerAd(AdView adView, Activity activity) {
  // Get a BannerAdRequest for a 360 wide large anchored adaptive banner ad.
  AdSize adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360);
  BannerAdRequest adRequest = new BannerAdRequest.Builder(AD_UNIT_ID, adSize).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd bannerAd) {
          Log.d(TAG, "Banner ad loaded.");
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Banner ad failed to load: " + adError);
        }
      });
}
BannerSnippets.java

Jetpack Compose

// Request a large anchored adaptive banner with a width of 360.
val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(context, 360)

// Load the ad when the screen is active.
val isPreviewMode = LocalInspectionMode.current
LaunchedEffect(adSize) {
  if (!isPreviewMode) {
    val adRequest = BannerAdRequest.Builder(AD_UNIT_ID, adSize).build()
    adView.loadAd(
      adRequest,
      object : AdLoadCallback<BannerAd> {
        override fun onAdLoaded(ad: BannerAd) {
          Log.d(Constant.TAG, "Banner ad loaded.")
        }

        override fun onAdFailedToLoad(adError: LoadAdError) {
          Log.w(Constant.TAG, "Banner ad failed to load: $adError")
        }
      },
    )
  }
}ComposeBannerFragment.kt

広告を更新する

広告ユニットの更新を有効にしていれば、広告の読み込みに失敗しても、別の広告をリクエストする必要はありません。GMA Next-Gen SDK では、アドマネージャーの管理画面で指定した更新頻度が使用されます。更新を有効にしていない場合は、新しいリクエストを発行します。更新頻度の設定など、広告ユニットの更新について詳しくは、モバイルアプリでの広告の更新頻度をご覧ください。

広告リソースを解放する

バナー広告の使用が終了したら、バナー広告のリソースを解放できます。

広告のリソースを解放するには、ビュー階層から広告を削除し、関連するすべての参照も削除します。

Kotlin

private fun destroyBanner() {
  // Remove banner from view hierarchy.
  val parentView = adView?.parent
  if (parentView is ViewGroup) {
    parentView.removeView(adView)
  }

  // Destroy the banner ad resources.
  adView?.destroy()

  // Drop reference to the banner ad.
  adView = null
}
BannerSnippets.kt

Java

private void destroyBanner() {
  // Remove banner from view hierarchy.
  if (adView != null) {
    if (adView.getParent() instanceof ViewGroup) {
      ((ViewGroup) adView.getParent()).removeView(adView);
    }

    // Destroy the banner ad resources.
    adView.destroy();
  }

  // Drop reference to the banner ad.
  adView = null;
}BannerSnippets.java

Jetpack Compose

// Destroy the ad when the screen is disposed.
DisposableEffect(Unit) { onDispose { adView.destroy() } }ComposeBannerFragment.kt

広告イベント

広告のインプレッションとクリック、広告の開始と終了など、広告のライフサイクルで生じるさまざまなイベントをリッスンできます。バナーを表示する前にコールバックを設定することをおすすめします。

Kotlin

override fun onAdLoaded(ad: BannerAd) {
  ad.adEventCallback =
    object : BannerAdEventCallback {
      override fun onAdImpression() {
        // Banner ad recorded an impression.
        Log.d(TAG, "Banner ad recorded an impression.")
      }

      override fun onAdClicked() {
        // Banner ad recorded a click.
        Log.d(TAG, "Banner ad clicked.")
      }

      override fun onAdShowedFullScreenContent() {
        // Banner ad showed.
        Log.d(TAG, "Banner ad showed full screen content.")
      }

      override fun onAdDismissedFullScreenContent() {
        // Banner ad dismissed.
        Log.d(TAG, "Banner ad dismissed full screen content.")
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // Banner ad failed to show.
        Log.w(TAG, "Banner ad failed to show full screen content: $fullScreenContentError")
      }
    }
}
BannerSnippets.kt

Java

@Override
public void onAdLoaded(@NonNull BannerAd bannerAd) {
  bannerAd.setAdEventCallback(
      new BannerAdEventCallback() {
        @Override
        public void onAdImpression() {
          // Banner ad recorded an impression.
          Log.d(TAG, "Banner ad recorded an impression.");
        }

        @Override
        public void onAdClicked() {
          // Banner ad recorded a click.
          Log.d(TAG, "Banner ad clicked.");
        }

        @Override
        public void onAdShowedFullScreenContent() {
          // Banner ad showed.
          Log.d(TAG, "Banner ad showed full screen content.");
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // Banner ad dismissed.
          Log.d(TAG, "Banner ad dismissed full screen content.");
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // Banner ad failed to show.
          Log.w(
              TAG,
              "Banner ad failed to show full screen content: " + fullScreenContentError);
        }
      });
}
BannerSnippets.java

広告更新のコールバック

バナー広告に自動更新を使用している場合、BannerAdRefreshCallback は広告更新イベントを処理します。広告ビューをビュー階層に追加する前に、必ずコールバックを設定してください。広告の更新について詳しくは、広告を更新するをご覧ください。

Kotlin

adView.loadAd(
  adRequest,
  object : AdLoadCallback<BannerAd> {
    override fun onAdLoaded(ad: BannerAd) {
      ad.bannerAdRefreshCallback =
        object : BannerAdRefreshCallback {
          override fun onAdRefreshed() {
            // Banner ad refreshed.
            Log.d(TAG, "Banner ad refreshed.")
          }

          override fun onAdFailedToRefresh(adError: LoadAdError) {
            // Banner ad failed to refresh.
            Log.w(TAG, "Banner ad failed to refresh: $adError")
          }
        }
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // Banner ad failed to load.
      Log.w(TAG, "Banner ad failed to load: $adError")
    }
  },
)BannerSnippets.kt

Java

adView.loadAd(
    adRequest,
    new AdLoadCallback<BannerAd>() {
      @Override
      public void onAdLoaded(@NonNull BannerAd bannerAd) {
        bannerAd.setBannerAdRefreshCallback(
            new BannerAdRefreshCallback() {
              @Override
              public void onAdRefreshed() {
                // Banner ad refreshed.
                Log.d(TAG, "Banner ad refreshed.");
              }

              @Override
              public void onAdFailedToRefresh(@NonNull LoadAdError adError) {
                // Banner ad failed to refresh.
                Log.w(TAG, "Banner ad failed to refresh: " + adError);
              }
            });
      }

      @Override
      public void onAdFailedToLoad(@NonNull LoadAdError adError) {
        // Banner ad failed to load.
        Log.w(TAG, "Banner ad failed to load: " + adError);
      }
    });BannerSnippets.java

動画広告のハードウェアアクセラレーション

バナー広告で動画広告を正常に表示するには、ハードウェアアクセラレーションを有効にする必要があります。

ハードウェアアクセラレーションはデフォルトで有効になっていますが、一部のアプリでは無効にすることもできます。お客様のアプリで無効にできる場合、広告を使用する Activity クラスのハードウェアアクセラレーションを有効にすることをおすすめします。

ハードウェアアクセラレーションを有効にする

ハードウェアアクセラレーションをグローバルに有効にするとアプリが正しく動作しない場合は、個々のアクティビティでの設定が可能です。ハードウェアアクセラレーションを有効または無効にするには、AndroidManifest.xml の <application> および <activity> 要素で android:hardwareAccelerated 属性を使用できます。次の例では、アプリ全体でハードウェアアクセラレーションを有効にしつつ、1 つのアクティビティで無効にしています。

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

ハードウェアアクセラレーションを制御するオプションについて詳しくは、ハードウェアアクセラレーションガイドをご覧ください。アクティビティが無効の場合、個別の広告ビューではハードウェアアクセラレーションを有効にできないため、アクティビティ自体でハードウェアアクセラレーションが有効になっている必要があります。

GMA Next-Gen SDK の使用方法を示したサンプルアプリをダウンロードし、実行してください。

バナー広告を設定する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

前提条件

必ずテスト広告でテストする

AdView オブジェクトを作成する

Kotlin

Java

XML レイアウト

Jetpack Compose

広告を読み込む

Kotlin

Java

Jetpack Compose

広告を更新する

広告リソースを解放する

Kotlin

Java

Jetpack Compose

広告イベント

Kotlin

Java

広告更新のコールバック

Kotlin

Java

動画広告のハードウェア アクセラレーション

ハードウェア アクセラレーションを有効にする

バナー広告を設定する

`AdView` オブジェクトを作成する

動画広告のハードウェアアクセラレーション

ハードウェアアクセラレーションを有効にする