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

まとめ: ネストされたクラス |継承される定数 |フィールド |メソッド |継承されるメソッド

CustomAudience

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
↳	android.adservices.customaudience.CustomAudience

---

カスタム オーディエンスが広告選択に参加するために必要な情報を表します。

カスタム オーディエンスは、似通った関心を示すユーザーの抽象的なグループです。このクラスは、単一のカスタム オーディエンスをターゲットとする広告を配信するために必要な、デバイスに保存されているデータのコレクションです。

概要

ネストされたクラス
class	CustomAudience.Builder CustomAudience オブジェクトのビルダー。

継承される定数
継承元のインターフェース android.os.Parcelable 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<CustomAudience>	CREATOR

パブリック メソッド
boolean	equals(Object o) 2 つの CustomAudience オブジェクトに同じ情報が含まれているかどうかを確認します。
Instant	getActivationTime() CustomAudience オブジェクトの作成時に、オプションの有効化日時を 対応できるようにする必要があります。
List<AdData>	getAds() この AdData オブジェクトのリストは、変更される広告の完全なリストです。 広告選択プロセス中にこの CustomAudience によって配信されます。
Uri	getBiddingLogicUri() カスタム オーディエンスがオークションに参加したときに入札ロジックを取得するために使用されるターゲット URI を返します。 広告選択プロセスに進みます
AdTechIdentifier	getBuyer() 購入者は「buyerexample.com」という形式のドメインによって識別されます。
Uri	getDailyUpdateUri() この URI は、最新の入札データと広告メタデータをホストする購入者運営のサーバーを指します オンデバイスの広告選択プロセスで使用する必要があります
Instant	getExpirationTime() 有効期限が過ぎると、カスタム オーディエンスは日別 広告/入札データの更新、広告選択プロセスへの参加。
String	getName() カスタム オーディエンスの名前は、作成時に所有者と購入者が指定する任意の文字列です。 CustomAudience オブジェクトの引数。
TrustedBiddingData	getTrustedBiddingData() 信頼できる入札データは、購入者の信頼できるサーバーを指す URI で構成されます入札データ サーバーにクエリするためのキーのリストを指定します。
AdSelectionSignals	getUserBiddingSignals() ユーザー入札シグナルは、購入者によって任意で提供され、購入者提供のシグナルで処理されます。 隔離された実行環境で、広告選択時の JavaScript。
int	hashCode() CustomAudience オブジェクトのデータのハッシュを返します。
void	writeToParcel(Parcel dest, int flags) このオブジェクトを Parcel にフラット化します。

継承されるメソッド
クラス java.lang.Object から 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() 現在のスレッドが起動するまで待機します。通常は 通知や中断される。
継承元のインターフェース android.os.Parcelable abstract int describeContents() この Parcelable に含まれる特殊オブジェクトの種類を説明する 整列化されます abstract void writeToParcel(Parcel dest, int flags) このオブジェクトを Parcel にフラット化します。

フィールド

CREATOR

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

public static final Creator<CustomAudience> CREATOR

パブリック メソッド

equals

API レベル 34 で追加されました

public boolean equals (Object o)

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

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

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

getActivationTime

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

public Instant getActivationTime ()

CustomAudience オブジェクトの作成時、遅延有効化を実現するために、オプションの有効化時刻を未来に設定できます。このフィールドが設定されていない場合、参加時に CustomAudience が有効になります。

たとえば、失効したユーザーのカスタム オーディエンスは、非アクティブのしきい値に達するまでアクティブにならないことがあり、その時点でカスタム オーディエンスの広告が広告選択プロセスに参加し、失効したユーザーを元のオーナー アプリケーションに転送する可能性があります。

有効化の最大遅延は、最初の作成から 60 日です。

指定する場合、有効化時刻は有効期限より前にする必要があります。

戻り値
Instant	ミリ秒単位で切り捨てられるタイムスタンプ Instant。この後、カスタム オーディエンスは有効です この値は null の場合があります。

getAds

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

public List<AdData> getAds ()

この AdData オブジェクトのリストは、広告選択プロセス中にこの CustomAudience によって配信される広告の完全なリストです。

指定されていない場合、または空のリストが指定されている場合、CustomAudience は、カスタム オーディエンスの日次更新によって有効な広告リストが提供されるまで、広告選択に参加しません。

戻り値
List<AdData>	現在ListAdData カスタム オーディエンス この値が null になることはありません。

getBiddingLogicUri

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

public Uri getBiddingLogicUri ()

カスタム オーディエンスが広告選択プロセスに参加したときに入札ロジックを取得するために使用されるターゲット URI を返します。URI には HTTPS を使用する必要があります。

戻り値
Uri	購入者の入札ロジックを取得するための URI この値が null になることはありません。

getBuyer

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

public AdTechIdentifier getBuyer ()

購入者は「buyerexample.com」という形式のドメインによって識別されます。

戻り値
AdTechIdentifier	カスタム オーディエンスの購入者のドメインを含む AdTechIdentifier この値が null になることはありません。

getDailyUpdateUri

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

public Uri getDailyUpdateUri ()

この URI は、デバイス上の広告選択プロセスで使用される最新の入札データと広告メタデータをホストする購入者運営のサーバーを指します。URI には HTTPS を使用する必要があります。

戻り値
Uri	カスタム オーディエンスの日次更新 URI この値が null になることはありません。

getExpirationTime

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

public Instant getExpirationTime ()

有効期限を過ぎると、カスタム オーディエンスは、広告データや入札データの日次更新や、広告選択プロセスへの参加の対象から外れます。カスタム オーディエンスは、次回の日次更新の際にメモリから削除されます。

CustomAudience の作成時に有効期限が指定されていない場合は、期限は有効化から 60 日に設定されます。

最大有効期限は、最初の有効化から 60 日です。

戻り値
Instant	ミリ秒単位で切り捨てられるタイムスタンプ Instant。この後、カスタム オーディエンスを削除する必要があります この値は null の場合があります。

getName

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

public String getName ()

カスタム オーディエンスの名前は、CustomAudience オブジェクトの作成時にオーナーと購入者が指定する任意の文字列です。

戻り値
String	カスタム オーディエンスの名前（文字列） この値が null になることはありません。

getTrustedBiddingData

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

public TrustedBiddingData getTrustedBiddingData ()

信頼できる入札データは、購入者の入札データの信頼できるサーバーを指す URI と、サーバーへのクエリに使用するキーのリストで構成されます。なお、キーは任意の識別子です。広告選択時に購入者の入札ロジックについて信頼できるサーバーにクエリするためにのみ使用されます。

指定されていない場合、CustomAudience は、カスタム オーディエンスの日次更新によって信頼できる入札データが提供されるまで、広告選択に参加しません。

戻り値
TrustedBiddingData	カスタム オーディエンスの信頼できる入札を含む TrustedBiddingData オブジェクト データ この値は null の場合があります。

getUserBiddingSignals

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

public AdSelectionSignals getUserBiddingSignals ()

ユーザー入札シグナルは、購入者によって任意で提供され、隔離された実行環境での広告選択中に購入者提供の JavaScript で処理されます。

ユーザーの入札シグナルが、購入者の JS で処理できる有効な JSON オブジェクトでない場合、カスタム オーディエンスは広告選択の対象となりません。

指定されていない場合、CustomAudience は、カスタム オーディエンスの日次更新によってユーザー入札シグナルが提供されるまで、広告選択に参加しません。

戻り値
AdSelectionSignals	のユーザー入札シグナルを表す AdSelectionSignals オブジェクト。 カスタム オーディエンス この値は null の場合があります。

hashCode

API レベル 34 で追加されました

public int hashCode ()

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

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

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 の組み合わせのいずれかです。