NativeAd

abstract class NativeAd


Google ネイティブ広告。

概要

ネストされた型

abstract class NativeAd.AdChoicesInfo

アトリビューション情報。

abstract class NativeAd.Image

ネイティブ広告の画像アセット。

ネイティブ広告が正常に読み込まれたときに呼び出されるコールバックのインターフェース定義。

確認クリック機能を使用する際に、未確認のクリック イベントを受け取るためにアプリが使用できるリスナー インターフェース。

パブリック コンストラクタ

パブリック関数

abstract Unit

広告に対して以前に記録された未確認のクリックをキャンセルします。

abstract Unit

広告オブジェクトを破棄します。

abstract Unit

この関数は非推奨になりました。

enableCustomClickGestureDirection を使用してください。

abstract NativeAd.AdChoicesInfo?

AdChoices のアトリビューションに関する情報を返します。

abstract String?

広告主を識別するテキストを返します。

abstract String?

本文を返します。

abstract String?

広告の行動を促すフレーズ(「購入」や「インストール」など)を返します。

abstract Bundle!

ネイティブ広告に関連付けられた追加アセットのバンドルを返します。

abstract String?

メインのテキスト見出しを返します。

abstract NativeAd.Image?

広告主を識別する小さな画像を返します。

abstract (Mutable)List<NativeAd.Image!>!

大きい画像のリストを返します。

abstract MediaContent?

この広告に関連付けられている MediaContent を返します。

abstract (Mutable)List<MuteThisAdReason!>!

この広告で利用可能な「この広告を非表示にする」理由を返します。

abstract Long

この NativeAd のプレースメント ID を返します。

abstract String?

アプリに関する広告の場合、アプリの価格を表す文字列を返します。

abstract ResponseInfo?

読み込まれた広告の ResponseInfo オブジェクトを返します。

abstract Double?

アプリに関する広告の場合、アプリが提供されているストアでのアプリの星の数を表す 0 ~ 5 の星評価を返します。

abstract String?

アプリに関する広告の場合、アプリをダウンロードできるストアの名前を返します。

abstract Boolean

この関数は非推奨になりました。

enableCustomClickGestureDirection を使用して広告を読み込むと、返されるすべての広告でカスタム クリック操作がサポートされます。

abstract Boolean

この広告をプログラムでミュートできる場合は true を返します。

abstract Unit
muteThisAd(muteThisAdReason: MuteThisAdReason!)

「この広告をミュート」をプログラムで実行します。

abstract Unit
performClick(clickData: Bundle!)

ユーザーが広告をクリックしたときに呼び出す必要があります。

abstract Unit

この関数は非推奨になりました。

Google Mobile Ads SDK は、enableCustomClickGestureDirection でリクエストされたクリック操作の方向を使用して、カスタム クリック操作をトラッキングするようになりました。

abstract Boolean
recordImpression(impressionData: Bundle!)

広告が初めて表示されたときに呼び出す必要があります。

abstract Unit
reportTouchEvent(touchEventData: Bundle!)

広告でタッチ イベントが発生したときに呼び出す必要があります。

abstract Unit

広告の MuteThisAdListener を設定します。

abstract Unit

この広告で収益が発生したと推定されるときに呼び出されるコールバックを登録します。

abstract Unit
setPlacementId(placementId: Long)

ネイティブ広告のプレースメント ID を設定します。

abstract Unit

広告の UnconfirmedClickListener を設定します。

パブリック コンストラクタ

NativeAd

NativeAd()

パブリック関数

cancelUnconfirmedClick

abstract fun cancelUnconfirmedClick(): Unit

広告に対して以前に記録された未確認のクリックをキャンセルします。

destroy

abstract fun destroy(): Unit

広告オブジェクトを破棄します。 destroy が呼び出された後は、広告オブジェクトで他のメソッドを呼び出さないでください。

enableCustomClickGesture

abstract fun enableCustomClickGesture(): Unit

この NativeAd のカスタム ジェスチャーを使用してクリック数をレポートするパブリッシャーを有効にします。このメソッドを使用するには、広告ユニットが許可リストに登録されている必要があります。

デフォルトでは、SDK はアセットビューのクリックをトラッキングします。このメソッドが呼び出されると、SDK はこの NativeAd のクリックを追跡しなくなります。広告を表示する前に呼び出す必要があります。

getAdChoicesInfo

abstract fun getAdChoicesInfo(): NativeAd.AdChoicesInfo?

AdChoices のアトリビューションに関する情報を返します。

getAdvertiser

abstract fun getAdvertiser(): String?

広告主を識別するテキストを返します。このアセットの表示は必須ではありませんが、推奨されています。

getBody

abstract fun getBody(): String?

本文を返します。アプリはこのアセットを表示する必要があります。

getCallToAction

abstract fun getCallToAction(): String?

広告の行動を促すフレーズ(「購入」や「インストール」など)を返します。このアセットの表示は必須ではありませんが、推奨されています。

getExtras

abstract fun getExtras(): Bundle!

ネイティブ広告に関連付けられた追加アセットのバンドルを返します。メディエーション パートナーの広告に標準アセット(価格、ストアなど)以外の追加アセットがある場合は、setExtras のメソッドを呼び出して設定できます。また、このメソッドで取得できます。メディエーション以外のフローの場合、空のバンドルが返されます。

getHeadline

abstract fun getHeadline(): String?

メインのテキスト見出しを返します。アプリはこのアセットを表示する必要があります。

getIcon

abstract fun getIcon(): NativeAd.Image?

広告主を識別する小さな画像を返します。このアセットの表示は必須ではありませんが、推奨されています。

getImages

abstract fun getImages(): (Mutable)List<NativeAd.Image!>!

大きな画像のリストを返します。このアセットの表示は必須ではありませんが、推奨されています。

getMediaContent

abstract fun getMediaContent(): MediaContent?

この広告に関連付けられている MediaContent を返します。

getMuteThisAdReasons

abstract fun getMuteThisAdReasons(): (Mutable)List<MuteThisAdReason!>!

この広告で利用可能な「この広告を非表示にする」理由を返します。ユーザーに表示するテキストの説明には、クラスのテキスト説明を使用します。

getPlacementId

abstract fun getPlacementId(): Long

この NativeAd のプレースメント ID を返します。

getPrice

abstract fun getPrice(): String?

アプリに関する広告の場合、アプリの費用を表す文字列を返します。このアセットの表示は必須ではありませんが、推奨されています。

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo?

読み込まれた広告の ResponseInfo オブジェクトを返します。広告が正常に読み込まれるまで null を返します。

getStarRating

abstract fun getStarRating(): Double?

アプリに関する広告の場合、アプリが提供されているストアでのアプリの星の数を表す 0 ~ 5 の星評価を返します。このアセットの表示は必須ではありませんが、推奨されています。

getStore

abstract fun getStore(): String?

アプリに関する広告の場合、アプリをダウンロードできるストアの名前を返します。(「Google Play」など)。このアセットの表示は必須ではありませんが、推奨されています。

isCustomClickGestureEnabled

abstract fun isCustomClickGestureEnabled(): Boolean

カスタム クリック操作を使用してクリックをレポートできるかどうかを示します。この機能で広告ユニットを許可リストに登録するには、アカウント マネージャーにお問い合わせください。

isCustomMuteThisAdEnabled

abstract fun isCustomMuteThisAdEnabled(): Boolean

この広告をプログラムでミュートできる場合は true を返します。setRequestCustomMuteThisAd を使用して、カスタムの広告非表示機能の実装をリクエストします。

muteThisAd

abstract fun muteThisAd(muteThisAdReason: MuteThisAdReason!): Unit

「この広告をミュート」をプログラムで実行します。

パラメータ
muteThisAdReason: MuteThisAdReason!

ユーザーが選択したミュートの理由。getMuteThisAdReasons からミュートの理由を取得します。null を使用して、デフォルトの理由で広告を非表示にします。

performClick

abstract fun performClick(clickData: Bundle!): Unit

ユーザーが広告をクリックしたときに呼び出す必要があります。この API を使用するには、広告ユニットが許可リストに登録されている必要があります。このメソッドは、Unity プラグインのパブリッシャーのみが使用する必要があります。

パラメータ
clickData: Bundle!

クリックが発生したときのアプリ環境のバンドル。クリックデータ Bundle を作成する詳細については、NativeAdConstants をご覧ください。

recordCustomClickGesture

abstract fun recordCustomClickGesture(): Unit

カスタム クリック操作を使用して、この NativeAd のクリックをレポートします。このメソッドを使用するには、広告ユニットが許可リストに登録されている必要があります。

このメソッドを呼び出す前に enableCustomClickGesture を呼び出す必要があります。

recordImpression

abstract fun recordImpression(impressionData: Bundle!): Boolean

広告が初めて表示されたときに呼び出す必要があります。この API を使用するには、広告ユニットが許可リストに登録されている必要があります。

パラメータ
impressionData: Bundle!

インプレッション発生時のアプリ環境のバンドル。インプレッション データ Bundle を構築する詳細については、NativeAdConstants をご覧ください。

戻り値
Boolean

インプレッションが正常に記録された場合は true

reportTouchEvent

abstract fun reportTouchEvent(touchEventData: Bundle!): Unit

広告でタッチ イベントが発生したときに呼び出す必要があります。この API を使用するには、広告ユニットが許可リストに登録されている必要があります。この機能の使用をご希望の場合は、アカウント マネージャーにお問い合わせください。

パラメータ
touchEventData: Bundle!

タッチイベントの座標と継続時間のバンドル。

touchEventData Bundle の JSON 表現の例:

  {    "x": "100",  // The x-coordinate of the touch event relative to the window.    "y": "50",  // The y-coordinate of the touch event relative to the window.    "duration_millis": "500",  // The amount of milliseconds the user pressed on the asset.  }

setMuteThisAdListener

abstract fun setMuteThisAdListener(listener: MuteThisAdListener!): Unit

広告の MuteThisAdListener を設定します。

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

この広告で収益が発生したと推定されるときに呼び出されるコールバックを登録します。

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

ネイティブ広告のプレースメント ID を設定します。

このプレースメント ID がレポートに含まれるようにするには、広告を NativeAdView に関連付ける前にこのメソッドを呼び出します。

パラメータ
placementId: Long

構成されたプレースメント用に AdMob 管理画面から提供される長整数。

setUnconfirmedClickListener

abstract fun setUnconfirmedClickListener(
    listener: NativeAd.UnconfirmedClickListener!
): Unit

広告の UnconfirmedClickListener を設定します。