BILLING を表示する
ネイティブ広告が読み込まれると、Google Mobile Ads SDK によって 対応する広告フォーマットですそしてアプリ側で広告を表示するため 必ずしもすぐに行う必要はありません。常に表示されるようにするには SDK には便利なリソースが用意されています。 以下で説明します。
NativeAdView
クラス
NativeAd
形式の場合、対応する
NativeAdView
クラスです。このクラスは
ViewGroup
パブリッシャーが NativeAd
のルートとして使用する必要がある。
1 つの NativeAdView
が 1 つのネイティブ広告に対応します。
広告のアセットの表示に使用されるビュー(ImageView
スクリーンショット アセットなど)は、NativeAdView
の子にする必要があります。
渡されます。
ネイティブ広告のビュー階層には
LinearLayout
アセットビューを表示する場合、次のようになります。
<com.google.android.gms.ads.nativead.NativeAdView
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<LinearLayout
android:orientation="vertical"
... >
<LinearLayout
android:orientation="horizontal"
... >
<ImageView
android:id="@+id/ad_app_icon"
... />
<TextView
android:id="@+id/ad_headline"
... />
</LinearLayout>
// Other assets such as image or media view, call to action, etc follow.
...
</LinearLayout>
</com.google.android.gms.ads.nativead.NativeAdView>
次の例では、NativeAdView
と Chronicle を
次のように NativeAd
を設定します。
Java
AdLoader.Builder builder = new AdLoader.Builder(this, "AD_UNIT_ID")
.forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
// Assumes you have a placeholder FrameLayout in your View layout
// (with id fl_adplaceholder) where the ad is to be placed.
FrameLayout frameLayout =
findViewById(R.id.fl_adplaceholder);
// Assumes that your ad layout is in a file call native_ad_layout.xml
// in the res/layout folder
NativeAdView adView = (NativeAdView) getLayoutInflater()
.inflate(R.layout.native_ad_layout, null);
// This method sets the text, images and the native ad, etc into the ad
// view.
populateNativeAdView(nativeAd, adView);
frameLayout.removeAllViews();
frameLayout.addView(adView);
}
});
Kotlin
val builder = AdLoader.Builder(this, "AD_UNIT_ID")
.forNativeAd { nativeAd ->
// Assumes that your ad layout is in a file call native_ad_layout.xml
// in the res/layout folder
val adView = layoutInflater
.inflate(R.layout.native_ad_layout, null) as NativeAdView
// This method sets the text, images and the native ad, etc into the ad
// view.
populateNativeAdView(nativeAd, adView)
// Assumes you have a placeholder FrameLayout in your View layout
// (with id ad_frame) where the ad is to be placed.
ad_frame.removeAllViews()
ad_frame.addView(adView)
}
なお、ネイティブ広告のすべてのアセットは、
NativeAdView
レイアウト。Google Mobile Ads SDK は、Google 広告が
ネイティブ広告ビュー レイアウトの外部でレンダリングされるネイティブ アセット。
広告ビュークラスには、広告に使用されるビューの登録に使用するメソッドも用意されています。
もう 1 つは NativeAd
オブジェクト自体を登録するためのものです。
この方法でビューを登録すると、SDK が自動的にタスクを処理できるようになります。
例:
- クリックの記録
- 画面に最初のピクセルが表示されたときにインプレッションを記録する
- AdChoices オーバーレイを表示する
AdChoices オーバーレイ
AdChoices オーバーレイは、SDK によって各広告ビューに追加されます。スペースを ご希望の 自動的に挿入された AdChoices ロゴのネイティブ広告ビュー。また、 AdChoices オーバーレイは見やすくすることが重要なので、背景色を選択します。 画像を適切に作成できます。オーバーレイの外観と構造について詳しくは、 [ネイティブ広告] フィールド 説明をご覧ください。
広告の帰属表示
広告の帰属表示を使用して、その視聴が広告であることを示す必要があります。 詳しくは、ポリシー ガイドラインをご覧ください。
サンプルコード
ネイティブ広告を表示する手順は次のとおりです。
NativeAdView
クラスのインスタンスを作成します。- 表示する広告アセットごとに、次の操作を行います。
<ph type="x-smartling-placeholder">
- </ph>
- アセットビューに広告オブジェクトのアセットを入力します。
- アセットビューを
ViewGroup
クラスに登録します。
- まず
MediaView
ネイティブ広告のレイアウトに大きなメディア アセットが含まれている場合。 - 広告オブジェクトを
ViewGroup
クラスに登録します。
次に、NativeAd
を表示する関数の例を示します。
Java
private void displayNativeAd(ViewGroup parent, NativeAd ad) {
// Inflate a layout and add it to the parent ViewGroup.
LayoutInflater inflater = (LayoutInflater) parent.getContext()
.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
NativeAdView adView = (NativeAdView) inflater
.inflate(R.layout.ad_layout_file, parent);
// Locate the view that will hold the headline, set its text, and call the
// NativeAdView's setHeadlineView method to register it.
TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline);
headlineView.setText(ad.getHeadline());
adView.setHeadlineView(headlineView);
...
// Repeat the above process for the other assets in the NativeAd
// using additional view objects (Buttons, ImageViews, etc).
...
// If the app is using a MediaView, it should be
// instantiated and passed to setMediaView. This view is a little different
// in that the asset is populated automatically, so there's one less step.
MediaView mediaView = (MediaView) adView.findViewById(R.id.ad_media);
adView.setMediaView(mediaView);
// Call the NativeAdView's setNativeAd method to register the
// NativeAdObject.
adView.setNativeAd(ad);
// Ensure that the parent view doesn't already contain an ad view.
parent.removeAllViews();
// Place the AdView into the parent.
parent.addView(adView);
}
Kotlin
fun displayNativeAd(parent: ViewGroup, ad: NativeAd) {
// Inflate a layout and add it to the parent ViewGroup.
val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE)
as LayoutInflater
val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView
// Locate the view that will hold the headline, set its text, and use the
// NativeAdView's headlineView property to register it.
val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
headlineView.text = ad.headline
adView.headlineView = headlineView
...
// Repeat the above process for the other assets in the NativeAd using
// additional view objects (Buttons, ImageViews, etc).
...
val mediaView = adView.findViewById<MediaView>(R.id.ad_media)
adView.mediaView = mediaView
// Call the NativeAdView's setNativeAd method to register the
// NativeAdObject.
adView.setNativeAd(ad)
// Ensure that the parent view doesn't already contain an ad view.
parent.removeAllViews()
// Place the AdView into the parent.
parent.addView(adView)
}
個々のタスクは次のとおりです。
レイアウトをインフレートする
Java
LayoutInflater inflater = (LayoutInflater) parent.getContext() .getSystemService(Context.LAYOUT_INFLATER_SERVICE); NativeAdView adView = (NativeAdView) inflater .inflate(R.layout.ad_layout_file, parent);
Kotlin
val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE) as LayoutInflater val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView
このコードは、ネイティブ レイアウトを表示するためのビューを含む XML レイアウトを拡張しています。
NativeAdView
への参照を見つけます。なお、 フラグメントまたはアクティビティに既存のNativeAdView
がある場合は、それを再利用する。 レイアウト ファイルを使用せずにインスタンスを動的に作成することもできます。アセットビューにデータを入力して登録する
このサンプルコードは、見出しの表示に使用されるビューを特定してテキストを設定します。 広告オブジェクトによって提供される文字列アセットを使用し、
NativeAdView
オブジェクト:Java
TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline); headlineView.setText(ad.getHeadline()); adView.setHeadlineView(headlineView);
Kotlin
val headlineView = adView.findViewById<TextView>(R.id.ad_headline) headlineView.text = ad.headline adView.headlineView = headlineView
ビューの場所を特定して値を設定し、ビューに登録するこのプロセスは、 広告ビュークラスは、 アプリが表示するネイティブ広告オブジェクトです。
クリックを処理する
内部または内部のビューにはカスタム クリック ハンドラを実装しないでください。 獲得できますクリック イベントをご自身でモニタリングするには、広告 リスナー。
広告ビューアセットのクリックは、適切に設定されていれば、SDK によって処理されます。 アセットビューを設定して登録します。
以下は広告の 監視する クリック イベント:
Java
AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110") ... .withAdListener(new AdListener() { @Override public void onAdFailedToLoad(LoadAdError adError) { // Handle the failure by logging, altering the UI, and so on. } @Override public void onAdClicked() { // Log the click event or other custom behavior. } }) .build();
Kotlin
val adLoader = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110") ... .withAdListener(object : AdListener() { override fun onAdFailedToLoad(adError: LoadAdError) { // Handle the failure by logging, altering the UI, and so on. } }) .build()
MediaView を登録する
使用するには、
MediaView
を使用します。ImageView
ネイティブのレイアウトにメインの画像アセットを含める場合は、このアセットを使用してください。 表示されます。MediaView
は、メインのメディア アセットを表示するために設計された特別なView
です。 動画か画像かを選択しますMediaView
は、XML レイアウトで定義することも、動的に作成することもできます。これは、 他のモジュールと同様に、NativeAdView
のビュー階層内に配置する 追加できますMediaView
を使用するアプリは、NativeAdView
:Java
MediaView mediaView = adView.findViewById(R.id.ad_media); adView.setMediaView(mediaView);
Kotlin
adView.mediaView = adView.findViewById<MediaView>(R.id.ad_media)
すべてのアセットビューと同様に、メディアビューのコンテンツも入力する必要があります。 これには
getMediaContent()
メソッドを使用して、メディア コンテンツを取得し、MediaView
。メディアのメディア コンテンツを設定するコード スニペットを以下に示します。 view:Java
mediaView.setMediaContent(nativeAd.getMediaContent());
Kotlin
mediaView.mediaContent = nativeAd.mediaContent
ImageScaleType
表示時の
MediaView
クラスはImageScaleType
プロパティである 作成します。MediaView
で画像のスケーリング方法を変更する場合は、 対応するImageView.ScaleType
(setImageScaleType()
を使用)MediaView
のメソッドを使用します。Java
mediaView.setImageScaleType(ImageView.ScaleType.CENTER_CROP);
Kotlin
mediaView.imageScaleType = ImageView.ScaleType.CENTER_CROP
MediaContent
MediaContent
クラスは、コンテンツのメディア コンテンツに関連するデータを保持し、MediaView
クラスを使用して表示されるネイティブ広告GoogleMediaView
mediaContent
プロパティは、MediaContent
インスタンスを使用して設定します。動画アセットがある場合は、その動画アセットがバッファリングされ、
MediaView
。動画アセットがあるかどうかを確認するには、hasVideoContent()
。広告に動画アセットが含まれていない場合は、
mainImage
アセットがダウンロードされます。 代わりにMediaView
内に配置します。
デフォルトでは、
mainImage
が最初にダウンロードされる画像アセットです。条件setReturnUrlsForImageAssets(true)
が使用されています。mainImage
はnull
であるため、次の操作を行う必要があります。mainImage
プロパティを、手動でダウンロードしたイメージに設定します。なお、 使用できる動画アセットがない場合にのみ、画像が使用されます。ネイティブ広告オブジェクトを登録する
この最後のステップで、ネイティブ広告のオブジェクトを 表示を担います。
Java
adView.setNativeAd(ad);
Kotlin
adView.setNativeAd(ad)
広告を破棄
ネイティブ広告の表示が終わったら、広告が ガベージ コレクションの対象になります。
Java
nativeAd.destroy();
Kotlin
nativeAd.destroy()
GitHub の例
ネイティブ広告の完全な実装例:
次のステップ
次のトピックをご覧ください。