UpdateAdCounterHistogramRequest

public class UpdateAdCounterHistogramRequest
extends Object

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

広告カウンタのヒストグラムを更新するために必要な引数をラップするリクエスト オブジェクト。

広告カウンタのヒストグラムは、広告カウンタキーと広告イベントタイプに関連付けられたイベントの履歴ログであり、Protected Audience API 使用時のフリークエンシー キャップ フィルタリングに使用されます。

まとめ

ネストされたクラス

class UpdateAdCounterHistogramRequest.Builder

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

パブリック メソッド

boolean equals(Object o)

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

int getAdEventType()

更新するヒストグラムを特定するために、広告のカウンタキーとともに関連付けられている広告イベントタイプを取得します。

long getAdSelectionId()

レンダリングされた広告のイベントが関連付けられている広告選択 ID を取得します。

AdTechIdentifier getCallerAdTech()

呼び出し元のアドテック エンティティの AdTechIdentifier を取得します。

int hashCode()

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

String toString()

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

継承されるメソッド

パブリック メソッド

次と等しい

public boolean equals (Object o)

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

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

getAdEventType

public int getAdEventType ()

更新するヒストグラムを特定するために、広告のカウンタキーとともに関連付けられている広告イベントタイプを取得します。

戻り値
int 値は、android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_INVALID、FrequencyCapFilters.AD_EVENT_TYPE_WIN、FrequencyCapFilters.AD_EVENT_TYPE_IMPRESSION、FrequencyCapFilters.AD_EVENT_TYPE_VIEW、FrequencyCapFilters.AD_EVENT_TYPE_CLICK、android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_MIN、android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_MAX です。

getAdSelectionId

public long getAdSelectionId ()

レンダリングされた広告のイベントが関連付けられている広告選択 ID を取得します。

広告選択 ID について詳しくは、AdSelectionOutcome をご覧ください。

広告が過去 24 時間以内に Protected Audience の広告選択から選択され、広告選択の呼び出しが現在の呼び出し元アプリと同じアプリから開始されている必要があります。広告選択 ID で指定された広告に関連付けられたすべての広告カウンタキーのイベント ヒストグラムは、getAdEventType() の広告イベントタイプについて更新され、Protected Audience のフリークエンシー キャップ フィルタリングで使用されます。

戻り値
long

getCallerAdTech

public AdTechIdentifier getCallerAdTech ()

呼び出し元のアドテック エンティティの AdTechIdentifier を取得します。

この UpdateAdCounterHistogramRequest オブジェクトを使用するアドテックは、プライバシー サンドボックスに登録され、呼び出し元アプリに代わって動作することが許可されている必要があります。指定されたアドテックは、レンダリングされた広告を所有している購入者または getAdSelectionId() から返された ID に関連付けられた広告選択を開始した販売者と同じアドテックである必要はありません。

API の要件と例外の詳細については、AdSelectionManager.updateAdCounterHistogram(android.adservices.adselection.UpdateAdCounterHistogramRequest, java.util.concurrent.Executor, android.os.OutcomeReceiver) をご覧ください。

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

hashCode

public int hashCode ()

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

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

toString

public String toString ()

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

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

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

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