AdSelectionConfig

public final class AdSelectionConfig
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionConfig

広告選択プロセスの設定が含まれます。

このクラスのインスタンスは SDK によって作成され、AdSelectionManager の AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) メソッドと AdSelectionManager#reportImpression メソッドに引数として渡されます。

概要

ネストされたクラス

class AdSelectionConfig.Builder

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

継承される定数

フィールド

public static final Creator<AdSelectionConfig> CREATOR

パブリック メソッド

int describeContents()

この Parcelable インスタンスの整列化表現に含まれている特殊オブジェクトの種類を記述します。

boolean equals(Object o)

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

AdSelectionSignals getAdSelectionSignals()
List<AdTechIdentifier> getCustomAudienceBuyers()
Uri getDecisionLogicUri()
Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals()
AdTechIdentifier getSeller()
AdSelectionSignals getSellerSignals()
Uri getTrustedScoringSignalsUri()
int hashCode()

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

void writeToParcel(Parcel dest, int flags)

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

継承されるメソッド

フィールド

CREATOR

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

パブリック メソッド

describeContents

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

この Parcelable インスタンスの整列化表現に含まれている特殊オブジェクトの種類を記述します。たとえば、オブジェクトに writeToParcel(android.os.Parcel, int) の出力のファイル記述子が含まれる場合、このメソッドの戻り値に CONTENTS_FILE_DESCRIPTOR ビットが含まれている必要があります。

戻り値
int この Parcelable オブジェクト インスタンスによって整列化された特殊オブジェクト タイプのセットを示すビットマスク。 値は 0 または CONTENTS_FILE_DESCRIPTOR です。

equals

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

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

equals メソッドは、null 以外のオブジェクト参照に等価関係を実装します。

  • 再帰性: null 以外の参照値 x について、x.equals(x) は true を返します。
  • 対称性: null 以外の参照値 x、y について、y.equals(x) が true を返す場合にのみ、x.equals(y) は true を返します。
  • 推移性: null 以外の参照値 x、y、z について、x.equals(y) が true を返し、かつ y.equals(z) が true を返す場合、x.equals(z) は true を返します。
  • 一貫性: null 以外の参照値 x、y について、オブジェクトの equals 比較に使用する情報が変更されない限り、何度 x.equals(y) を呼び出しても返される値は一貫して true か、一貫して false です。
  • null 以外の参照値 x について、x.equals(null) は false を返します。

Object クラスの equals メソッドは、オブジェクトの等価関係を可能な限り識別しやすく実装します。つまり、null 以外の参照値 x と y について、x と y が同じオブジェクトを参照している場合にのみ、true を返します（x == y の値は true）。

なお、等しいオブジェクトは等しいハッシュコードを持たなければならないという hashCode メソッドの一般的なコントラクトを維持するよう、通常はこのメソッドがオーバーライドされるたびに hashCode メソッドをオーバーライドする必要があります。

パラメータ
o Object: 比較対象の参照オブジェクト。
戻り値
boolean このオブジェクトが obj 引数と同じである場合は true、それ以外の場合は false。

getAdSelectionSignals

API level 34 で追加
Ad Services Extensions 4 にも追加 
public AdSelectionSignals getAdSelectionSignals ()

戻り値
AdSelectionSignals AdSelectionSignals オブジェクトの JSON は、AdSelectionConfig から取得され、DSP から取得された JS ロジックで使用されます。これは、広告選択プロセスとレポート作成プロセスで参加している購入者に与えられるシグナルを表します。 この値が null になることはありません。

getCustomAudienceBuyers

API level 34 で追加
Ad Services Extensions 4 にも追加 
public List<AdTechIdentifier> getCustomAudienceBuyers ()

戻り値
List<AdTechIdentifier> SSP によって広告選択プロセスに参加することを許可されているカスタム オーディエンス購入者のリスト。この値が null になることはありません。

getDecisionLogicUri

API level 34 で追加
Ad Services Extensions 4 にも追加 
public Uri getDecisionLogicUri ()

戻り値
Uri 広告選択プロセスとレポート プロセスで使用される、販売者/SSP scoreAd 関数を含む JS コードの取得に使用する URI。この値が null になることはありません。

getPerBuyerSignals

API level 34 で追加
Ad Services Extensions 4 にも追加 
public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

戻り値
Map<AdTechIdentifier, AdSelectionSignals> AdSelectionConfig から取得され、DSP から取得した JS ロジックで使用される購入者と AdSelectionSignals のマップ。各購入者が広告選択時に参加者に提供する情報を表します（入札下限、広告選択タイプなど）。 この値が null になることはありません。

getSeller

API level 34 で追加
Ad Services Extensions 4 にも追加 
public AdTechIdentifier getSeller ()

戻り値
AdTechIdentifier 販売者の AdTechIdentifier（例: www.example-ssp.com）。この値が null になることはありません。

getSellerSignals

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

戻り値
AdSelectionSignals SSP によって提供され、SSP から取得した JS ロジックで使用される AdSelectionSignals オブジェクトの JSON は、広告選択プロセスの結果を調整するために SSP が広告スコアリング プロセスで使用する情報を表します（ブランド保護チェック、除外されたコンテキスト広告など）。 この値が null になることはありません。

getTrustedScoringSignalsUri

API level 34 で追加
Ad Services Extensions 4 にも追加 
public Uri getTrustedScoringSignalsUri ()

戻り値
Uri クリエイティブ固有のリアルタイム情報を取得できる、セルサイドの信頼できるシグナルの URI エンドポイント。この値が null になることはありません。

hashCode

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

オブジェクトのハッシュコード値を返します。このメソッドは、HashMap で実現するようなハッシュ テーブルの利点を活かすためにサポートされています。

hashCode の一般的なコントラクトは次のとおりです。

  • Java アプリの実行中に同じオブジェクトに対して複数回呼び出された場合、オブジェクトの equals 比較に使用される情報が変更されない限り、hashCode メソッドは一貫して同じ整数を返さなければなりません。この整数は、アプリのある実行から同じアプリの別の実行まで一貫している必要はありません。
  • equals(Object) メソッドから 2 つのオブジェクトが等しい場合、その 2 つのオブジェクトのそれぞれに対して hashCode メソッドを呼び出したとき、同じ整数の結果が生成されなければなりません。
  • equals(java.lang.Object) メソッドから 2 つのオブジェクトが等しくない場合、その 2 つのオブジェクトのそれぞれに対して hashCode メソッドを呼び出したとき、異なる整数の結果が生成されなければならない、ということはありません。ただし、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュ テーブルのパフォーマンスが向上する可能性があることに留意すべきです。

現実的である限り、クラス Object で定義された hashCode メソッドは、異なるオブジェクトに対して異なる整数を返します（hashCode は、ある時点からオブジェクトのメモリアドレスの関数として実装されるかもしれません）。

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