AdData

public final class AdData
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.common.AdData


広告の選択とレンダリングに必要な、広告固有のデータを表します。

概要

ネストされたクラス

class AdData.Builder

AdData オブジェクトのビルダー。 

継承される定数

int CONTENTS_FILE_DESCRIPTOR

describeContents() で使用される記述子ビット: 以下を示します。 Parcelable オブジェクトのフラット表現にはファイル記述子が含まれます。

int PARCELABLE_WRITE_RETURN_VALUE

writeToParcel(Parcel, int) で使用するフラグ: 書き込まれるオブジェクト は戻り値で、 「Parcelable someFunction()」、 「void someFunction(out Parcelable)」または 「void someFunction(inout Parcelable)」。

フィールド

public static final Creator<AdData> CREATOR

パブリック メソッド

boolean equals(Object o)

2 つの AdData オブジェクトに同じ情報が含まれているかどうかを確認します。

Set<Integer> getAdCounterKeys()

イベントのカウントに使用されるキーのセットを取得します。

AdFilters getAdFilters()

広告に関連付けられているすべての AdFilters を取得します。

String getAdRenderId()

サーバー オークションの広告レンダリング ID を取得します。

String getMetadata()

広告選択プロセスで使用される購入者の広告メタデータを取得します。

Uri getRenderUri()

広告のレンダリング アセットを指す URI を取得します。

int hashCode()

AdData オブジェクトのデータのハッシュを返します。

String toString()

オブジェクトの文字列表現を返します。

void writeToParcel(Parcel dest, int flags)

このオブジェクトを Parcel にフラット化します。

継承されるメソッド

Object clone()

このオブジェクトのコピーを作成して返します。

boolean equals(Object obj)

他のオブジェクトが「次と等しい」かどうかを示します。表示されます。

void finalize()

ガベージ コレクションの実行時に、オブジェクトのガベージ コレクタによって呼び出されます は、そのオブジェクトへの参照がもう存在しないことを確認します。

final Class<?> getClass()

この Object のランタイム クラスを返します。

int hashCode()

オブジェクトのハッシュコード値を返します。

final void notify()

このオブジェクトのスレッドを待機しているスレッドを 1 つ起こします。 モニタリングできます。

final void notifyAll()

このオブジェクトのモニターで待機中のスレッドをすべて起こします。

String toString()

オブジェクトの文字列表現を返します。

final void wait(long timeoutMillis, int nanos)

現在のスレッドが起動するまで待機します。通常は 通知中断される、あるいは 一定の時間が経過したら通知します

final void wait(long timeoutMillis)

現在のスレッドが起動するまで待機します。通常は 通知中断される、あるいは 一定の時間が経過したら通知します

final void wait()

現在のスレッドが起動するまで待機します。通常は 通知中断される。

abstract int describeContents()

この Parcelable に含まれる特殊オブジェクトの種類を説明する 整列化されます

abstract void writeToParcel(Parcel dest, int flags)

このオブジェクトを Parcel にフラット化します。

フィールド

CREATOR

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public static final Creator<AdData> CREATOR

パブリック メソッド

equals

API レベル 34 で追加されました
public boolean equals (Object o)

2 つの AdData オブジェクトに同じ情報が含まれているかどうかを確認します。

パラメータ
o Object: 比較対象の参照オブジェクト。

戻り値
boolean このオブジェクトが obj 引数と同じである場合は true、それ以外の場合は false

getAdCounterKeys

public Set<Integer> getAdCounterKeys ()

イベントのカウントに使用されるキーのセットを取得します。

1 つの広告に関連付けることができる広告カウンタキーは 10 個までです。

キーとキーごとのカウントは、広告選択時に実施されるフリークエンシー キャップ フィルタリングで使用され、上限を超えた関連広告が入札から除外されるようにします。

これらのキーは、カスタム オーディエンスの日次更新の際に、カスタム オーディエンスの広告や他の入札データとともに上書きされる可能性があります。

戻り値
Set<Integer> この値が null になることはありません。

getAdFilters

public AdFilters getAdFilters ()

広告に関連付けられているすべての AdFilters を取得します。

フィルタは、条件が満たされるか超過した場合、関連する広告を広告選択から除外します。省略可能で、null を指定した場合、この広告にはフィルタが適用されません。

戻り値
AdFilters

getAdRenderId

public String getAdRenderId ()

サーバー オークションの広告レンダリング ID を取得します。

サーバー オークションのリクエストを受信すると、AdData ごとに広告レンダリング ID が収集されます。

広告レンダリング ID のない AdData は、サーバーサイド オークションに参加できません。

戻り値
String この値は null であっても構いません。

getMetadata

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public String getMetadata ()

広告選択プロセスで使用される購入者の広告メタデータを取得します。

メタデータには、文字列としてシリアル化された有効な JSON オブジェクトを指定してください。メタデータは、広告固有の入札情報を表します。この入札情報は、広告選択時に入札生成の一環として使用され、隔離された実行環境で実行される購入者の JavaScript ロジックで使用されるものです。

メタデータが、購入者の JS で処理できる有効な JSON オブジェクトでない場合、その広告は広告選択の対象になりません。

戻り値
String この値が null になることはありません。

getRenderUri

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public Uri getRenderUri ()

広告のレンダリング アセットを指す URI を取得します。URI には HTTPS を使用する必要があります。

戻り値
Uri この値が null になることはありません。

hashCode

API レベル 34 で追加されました
public int hashCode ()

AdData オブジェクトのデータのハッシュを返します。

戻り値
int このオブジェクトのハッシュコード値。

toString

API レベル 34 で追加されました
public String toString ()

オブジェクトの文字列表現を返します。toString メソッドは一般に、オブジェクトを「テキストで表現」した文字列を返します。結果は、簡潔でありながら情報量の多い表現になり、人が簡単に読むことができます。すべてのサブクラスでこのメソッドをオーバーライドすることをおすすめします。

クラス ObjecttoString メソッドは、オブジェクトがインスタンスになっているクラスの名前、アットマーク文字「@」、オブジェクトのハッシュコードの符号なし 16 進表現で構成される文字列を返します。つまり、このメソッドは以下の値のような文字列を返します。

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

戻り値
String オブジェクトの文字列表現。

writeToParcel

API レベル 34 で追加されました
public void writeToParcel (Parcel dest, 
                int flags)

このオブジェクトを Parcel にフラット化します。

パラメータ
dest Parcel: この値を null にすることはできません。

flags int: オブジェクトの書き込み方法に関する追加のフラグ。0 または Parcelable.PARCELABLE_WRITE_RETURN_VALUE です。 値は、0 か、Parcelable.PARCELABLE_WRITE_RETURN_VALUE と android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES の組み合わせのいずれかです。