NativeAd

public abstract class NativeAd


Google ネイティブ広告。

概要

ネストされた型

public abstract class NativeAd.AdChoicesInfo

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

public abstract class NativeAd.Image

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

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

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

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

パブリック メソッド

abstract void

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

abstract void

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

abstract void

このメソッドは非推奨です。

enableCustomClickGestureDirection を使用してください。

abstract @Nullable NativeAd.AdChoicesInfo

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

abstract @Nullable String

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

abstract @Nullable String

本文を返します。

abstract @Nullable String

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

abstract Bundle

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

abstract @Nullable String

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

abstract @Nullable NativeAd.Image

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

abstract List<NativeAd.Image>

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

abstract @Nullable MediaContent

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

abstract List<MuteThisAdReason>

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

abstract long

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

abstract @Nullable String

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

abstract @Nullable ResponseInfo

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

abstract @Nullable Double

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

abstract @Nullable String

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

abstract boolean

このメソッドは非推奨です。

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

abstract boolean

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

abstract void
muteThisAd(MuteThisAdReason muteThisAdReason)

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

abstract void
performClick(Bundle clickData)

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

abstract void

このメソッドは非推奨です。

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

abstract boolean
recordImpression(Bundle impressionData)

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

abstract void
reportTouchEvent(Bundle touchEventData)

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

abstract void

広告の MuteThisAdListener を設定します。

abstract void

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

abstract void
setPlacementId(long placementId)

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

abstract void

広告の UnconfirmedClickListener を設定します。

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

NativeAd

public NativeAd()

パブリック メソッド

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

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

destroy

public abstract void destroy()

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

enableCustomClickGesture

public abstract void enableCustomClickGesture()

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

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

getAdChoicesInfo

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

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

getAdvertiser

public abstract @Nullable String getAdvertiser()

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

getBody

public abstract @Nullable String getBody()

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

getCallToAction

public abstract @Nullable String getCallToAction()

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

getExtras

public abstract Bundle getExtras()

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

getHeadline

public abstract @Nullable String getHeadline()

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

getIcon

public abstract @Nullable NativeAd.Image getIcon()

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

getImages

public abstract List<NativeAd.ImagegetImages()

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

getMediaContent

public abstract @Nullable MediaContent getMediaContent()

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

getMuteThisAdReasons

public abstract List<MuteThisAdReasongetMuteThisAdReasons()

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

getPlacementId

public abstract long getPlacementId()

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

getPrice

public abstract @Nullable String getPrice()

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

getResponseInfo

public abstract @Nullable ResponseInfo getResponseInfo()

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

getStarRating

public abstract @Nullable Double getStarRating()

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

getStore

public abstract @Nullable String getStore()

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

isCustomClickGestureEnabled

public abstract boolean isCustomClickGestureEnabled()

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

isCustomMuteThisAdEnabled

public abstract boolean isCustomMuteThisAdEnabled()

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

muteThisAd

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

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

パラメータ
MuteThisAdReason muteThisAdReason

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

performClick

public abstract void performClick(Bundle clickData)

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

パラメータ
Bundle clickData

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

recordCustomClickGesture

public abstract void recordCustomClickGesture()

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

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

recordImpression

public abstract boolean recordImpression(Bundle impressionData)

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

パラメータ
Bundle impressionData

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

戻り値
boolean

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

reportTouchEvent

public abstract void reportTouchEvent(Bundle touchEventData)

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

パラメータ
Bundle touchEventData

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

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

public abstract void setMuteThisAdListener(MuteThisAdListener listener)

広告の MuteThisAdListener を設定します。

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

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

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

パラメータ
long placementId

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

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

広告の UnconfirmedClickListener を設定します。