Google Mobile Ads SDK はメンテナンスモードです。最新のアップデートと機能を利用するには、移行して GMA Next-Gen SDK を設定してください。

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

ピクチャーインピクチャー広告を実装する（ベータ版）

ピクチャーインピクチャー

ピクチャーインピクチャー（PIP）広告は、記事、フィード、ゲームプレイなど、画面上のコンテンツの上に表示されるフローティングウィンドウに表示されます。このフォーマットでは、広告が表示されたまま、ユーザーがアプリを操作できます。画面全体を占有しない広告を表示するには、このフォーマットを選択します。

このガイドでは、GMA Next-Gen SDK を使用してアプリでピクチャーインピクチャー広告をリクエストして表示する方法について説明します。

始める前に

続行する前に、次のことを実施してください。

GMA Next-Gen SDK を設定します。
GMA Next-Gen SDK バージョン 1.4.0 以降をインストールします。
テスト広告を有効にして、次のテスト広告ユニット ID を使用します。 /21775744923/example/picture-in-picture

広告を読み込む

PictureInPictureAd を読み込むには、広告リクエストを作成して load メソッドを呼び出します。

Kotlin

private fun loadPictureInPictureAd() {
  val request = PictureInPictureAdRequest.Builder(AD_UNIT_ID).build()

  PictureInPictureAd.load(
    request,
    object : AdLoadCallback<PictureInPictureAd> {
      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.w(TAG, "Picture-in-Picture ad failed to load: $adError")
      }

      override fun onAdLoaded(ad: PictureInPictureAd) {
        Log.d(TAG, "Picture-in-Picture ad loaded.")

        // Capture the PictureInPictureAd reference for later use.
        pipAd = ad
        setAdEventCallback(ad)
      }
    },
  )
}

Java

private void loadPictureInPictureAd() {
  PictureInPictureAdRequest request = new PictureInPictureAdRequest.Builder(AD_UNIT_ID).build();

  PictureInPictureAd.load(
      request,
      new AdLoadCallback<PictureInPictureAd>() {
        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.w(TAG, "Picture-in-Picture ad failed to load: " + adError);
        }

        @Override
        public void onAdLoaded(@NonNull PictureInPictureAd ad) {
          Log.d(TAG, "Picture-in-Picture ad loaded.");

          // Capture the PictureInPictureAd reference for later use.
          pipAd = ad;
          setAdEventCallback(ad);
        }
      });
}

AD_UNIT_ID は、実際の広告ユニット ID に置き換えてください。

広告を表示する

ピクチャーインピクチャー広告を画面に表示するには、ピクチャーインピクチャーオプションを構成して show メソッドを呼び出します。次の例では、広告のデフォルトの表示位置とプレゼンテーションスコープを画面に設定しています。

Kotlin

private fun showPictureInPictureAd(activity: Activity) {
  // Capture the ad reference saved from the onAdLoaded callback.
  val ad = pipAd
  if (ad != null) {
    val options =
      PictureInPictureAdOptions.Builder()
        // Uses the Google Mobile Ads SDK's default screen position.
        .setPosition(PictureInPictureAdPosition.DEFAULT)
        // Binds the ad lifecycle to the host screen.
        .setPresentationScope(PictureInPictureAdPresentationScope.SCREEN)
        .build()
    ad.show(activity, options)
  } else {
    Log.d(TAG, "No ad to show.")
  }
}

Java

private void showPictureInPictureAd(@NonNull Activity activity) {
  // Use the ad reference saved from the onAdLoaded callback.
  if (pipAd != null) {
    PictureInPictureAdOptions options =
        new PictureInPictureAdOptions.Builder()
            // Uses the Google Mobile Ads SDK's default screen position.
            .setPosition(PictureInPictureAdPosition.DEFAULT)
            // Binds the ad lifecycle to the host screen.
            .setPresentationScope(PictureInPictureAdPresentationScope.SCREEN)
            .build();
    pipAd.show(activity, options);
  } else {
    Log.d(TAG, "No ad to show.");
  }
}

位置を設定する

デフォルトでは、GMA Next-Gen SDK は最初に表示されるときに画面の右下隅に、以前に表示されたことがある場合は最後に表示された位置に、ピクチャーインピクチャー広告を表示します。広告の表示位置をカスタマイズするには、ピクチャーインピクチャーのオプションで位置を設定します。次の例では、画面の左上隅にあるコンテンツの上に位置を設定します。

Kotlin

private fun createTopLeftPositionOptions(): PictureInPictureAdOptions {
  return PictureInPictureAdOptions.Builder()
    // Sets the ad position to the top-left corner of the screen.
    .setPosition(PictureInPictureAdPosition.TOP_LEFT)
    .build()
}

Java

private PictureInPictureAdOptions createTopLeftPositionOptions() {
  return new PictureInPictureAdOptions.Builder()
      // Sets the ad position to the top-left corner of the screen.
      .setPosition(PictureInPictureAdPosition.TOP_LEFT)
      .build();
}

募集中のすべての職種については、PictureInPictureAdPosition をご覧ください。

プレゼンテーションのスコープを設定する

デフォルトでは、GMA Next-Gen SDK はピクチャーインピクチャー広告を現在のホスト画面にバインドします。GMA Next-Gen SDK は、ホスト画面のビュー階層がメモリに存在しなくなったときに広告を閉じます。ホスト画面がメモリから削除された後も広告を表示し続けるには、プレゼンテーションスコープをアプリケーションに設定します。

Kotlin

private fun createApplicationScopedOptions(): PictureInPictureAdOptions {
  return PictureInPictureAdOptions.Builder()
    // Keeps the ad visible beyond the host screen's lifecycle.
    .setPresentationScope(PictureInPictureAdPresentationScope.APPLICATION)
    .build()
}

Java

private PictureInPictureAdOptions createApplicationScopedOptions() {
  return new PictureInPictureAdOptions.Builder()
      // Keeps the ad visible beyond the host screen's lifecycle.
      .setPresentationScope(PictureInPictureAdPresentationScope.APPLICATION)
      .build();
}

詳しくは、広告を画面全体に表示したままにするをご覧ください。

広告イベントのコールバックを設定する

ピクチャーインピクチャー広告のライフサイクルイベントを処理するには、広告を表示する前に広告のイベントコールバックを設定します。このコールバックは、クリックやインプレッションなどの標準イベントをレポートします。このコールバックは、広告の表示や非表示など、ピクチャーインピクチャー固有のイベントも報告します。

Kotlin

private fun setAdEventCallback(pipAd: PictureInPictureAd) {
  pipAd.adEventCallback =
    object : PictureInPictureAdEventCallback {
      override fun onAdShown() {
        Log.d(TAG, "Picture-in-Picture ad shown.")
      }

      override fun onAdHidden() {
        Log.d(TAG, "Picture-in-Picture ad hidden.")
      }

      override fun onAdImpression() {
        Log.d(TAG, "Picture-in-Picture ad recorded an impression.")
      }

      override fun onAdClicked() {
        Log.d(TAG, "Picture-in-Picture ad recorded a click.")
      }

      override fun onAdShowedFullScreenContent() {
        Log.d(TAG, "Picture-in-Picture ad showed full screen content.")
      }

      override fun onAdDismissedFullScreenContent() {
        Log.d(TAG, "Picture-in-Picture ad dismissed full screen content.")
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        Log.w(
          TAG,
          "Picture-in-Picture ad failed to show full screen content: $fullScreenContentError",
        )
      }

      override fun onAdPaid(value: AdValue) {
        Log.d(TAG, "Picture-in-Picture ad paid: ${value.valueMicros} ${value.currencyCode}")
      }
    }
}

Java

private void setAdEventCallback(@NonNull PictureInPictureAd pipAd) {
  pipAd.setAdEventCallback(
      new PictureInPictureAdEventCallback() {
        @Override
        public void onAdShown() {
          Log.d(TAG, "Picture-in-Picture ad shown.");
        }

        @Override
        public void onAdHidden() {
          Log.d(TAG, "Picture-in-Picture ad hidden.");
        }

        @Override
        public void onAdImpression() {
          Log.d(TAG, "Picture-in-Picture ad recorded an impression.");
        }

        @Override
        public void onAdClicked() {
          Log.d(TAG, "Picture-in-Picture ad recorded a click.");
        }

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

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

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

        @Override
        public void onAdPaid(@NonNull AdValue value) {
          Log.d(
              TAG,
              "Picture-in-Picture ad paid: "
                  + value.getValueMicros()
                  + " "
                  + value.getCurrencyCode());
        }
      });
}

広告を非表示にする

画面からフローティング広告を削除するには、hide メソッドを呼び出します。このメソッドは、広告非表示イベントのコールバックを呼び出します。

Kotlin

private fun hidePictureInPictureAd() {
  // Capture the ad reference saved from the onAdLoaded callback.
  val ad = pipAd
  if (ad != null) {
    ad.hide()
  } else {
    Log.d(TAG, "No ad to hide.")
  }
}

Java

private void hidePictureInPictureAd() {
  // Use the ad reference saved from the onAdLoaded callback.
  if (pipAd != null) {
    pipAd.hide();
  } else {
    Log.d(TAG, "No ad to hide.");
  }
}

広告リソースをクリーンアップする

メモリリークを回避するには、アプリで広告の使用が終了したら、広告オブジェクトへの参照を削除します。たとえば、アプリで広告が再び表示されなくなったり、操作できなくなったりした場合です。画面スコープの広告の場合は、アプリがホスト画面をメモリから削除するときに参照をドロップします。アプリスコープの広告の場合、ユーザーが画面間を移動している間は広告参照を保持し、ユーザーが広告を閉じたら参照を削除します。

Kotlin

private fun cleanUpPictureInPictureAd() {
  pipAd?.destroy()
  pipAd = null
}

Java

private void cleanUpPictureInPictureAd() {
  // Use the ad reference saved from the onAdLoaded callback.
  if (pipAd != null) {
    pipAd.destroy();
    pipAd = null;
  }
}

広告を画面全体に表示する

プレゼンテーションのスコープをアプリケーションに設定すると、アプリがホスティング画面をメモリから削除しても、ピクチャーインピクチャー広告は表示されたままになります。ユーザーがホスト画面から移動したときに広告を操作したり閉じたりするには、アプリがピクチャーインピクチャー広告へのアクセスを保持している必要があります。広告は、単一の画面のインスタンス変数ではなく、アプリレベルのシングルトンまたは共有状態マネージャーに保持することをおすすめします。

広告を画面全体に表示する方法の例については、サンプルアプリをご覧ください。

Kotlin
Java

ピクチャー イン ピクチャー広告を実装する（ベータ版） コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

広告を読み込む

Kotlin

Java

広告を表示する

Kotlin

Java

位置を設定する

Kotlin

Java

プレゼンテーションのスコープを設定する

Kotlin

Java

広告イベントのコールバックを設定する

Kotlin

Java

広告を非表示にする

Kotlin

Java

広告リソースをクリーンアップする

Kotlin

Java

広告を画面全体に表示する

ピクチャーインピクチャー広告を実装する（ベータ版）