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 です

次と等しい

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

public AdSelectionSignals getAdSelectionSignals ()

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

getCustomAudienceBuyers

public List<AdTechIdentifier> getCustomAudienceBuyers ()

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

getDecisionLogicUri

public Uri getDecisionLogicUri ()

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

getPerBuyerSignals

public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

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

getSeller

public AdTechIdentifier getSeller ()

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

getSellerSignals

public AdSelectionSignals getSellerSignals ()

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

getTrustedScoringSignalsUri

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