게재빈도 설정 필터
public
final
class
FrequencyCapFilters
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.adservices.common.FrequencyCapFilters |
최대 게재빈도에 기반한 광고 필터의 컨테이너입니다.
하나의 광고와 최대 20개의 게재빈도 설정 필터를 연결할 수 있습니다.
최대 게재빈도 필터는 이벤트 유형을 KeyedFrequencyCap
객체 목록과 결합하여 광고 필터 모음을 정의합니다. 특정 광고에서 이러한 최대 게재빈도 중 하나를 초과하면 광고가 구매자 광고 기술의 입찰 기능에 제출된 광고 그룹에서 삭제됩니다.
요약
중첩된 클래스 | |
---|---|
class |
FrequencyCapFilters.Builder
|
상수 | |
---|---|
int |
AD_EVENT_TYPE_CLICK
|
int |
AD_EVENT_TYPE_IMPRESSION
|
int |
AD_EVENT_TYPE_VIEW
|
int |
AD_EVENT_TYPE_WIN
WIN 광고 이벤트 유형은 Protected Audience 광고 선택에서 반환된 낙찰 광고의 Protected Audience 서비스 내에 자동으로 채워집니다. |
상속된 상수 |
---|
필드 | |
---|---|
public
static
final
Creator<FrequencyCapFilters> |
CREATOR
|
공개 메서드 | |
---|---|
boolean
|
equals(Object o)
|
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForClickEvents()
|
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForImpressionEvents()
|
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForViewEvents()
|
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForWinEvents()
|
int
|
hashCode()
|
String
|
toString()
객체의 문자열 표현을 반환합니다. |
void
|
writeToParcel(Parcel dest, int flags)
이 객체를 Parcel에 평면화합니다. |
상속된 메서드 | |
---|---|
상수
광고 이벤트 유형 클릭
public static final int AD_EVENT_TYPE_CLICK
상수 값: 3 (0x00000003)
AD_EVENT_TYPE_IMPRESSION
public static final int AD_EVENT_TYPE_IMPRESSION
상수 값: 1 (0x00000001)
AD_EVENT_TYPE_VIEW
public static final int AD_EVENT_TYPE_VIEW
상수 값: 2 (0x00000002)
AD_EVENT_TYPE_WIN
public static final int AD_EVENT_TYPE_WIN
WIN 광고 이벤트 유형은 Protected Audience 광고 선택에서 반환된 낙찰 광고의 Protected Audience 서비스 내에 자동으로 채워집니다.
광고 카운터 히스토그램을 수동으로 업데이트하는 데 사용해서는 안 됩니다.
상수 값: 0 (0x00000000)
필드
크리에이터
public static final Creator<FrequencyCapFilters> CREATOR
공개 메서드
같음
public boolean equals (Object o)
FrequencyCapFilters
객체에 동일한 정보가 포함되어 있는지 확인합니다.
매개변수 | |
---|---|
o |
Object : 비교할 참조 객체입니다. |
반환 값 | |
---|---|
boolean |
이 객체가 obj 인수와 동일한 경우 true , 동일하지 않은 경우에는 false 입니다. |
getKeyedFrequencyCapsForClickEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()
AD_EVENT_TYPE_CLICK
이벤트 유형을 필터링할 KeyedFrequencyCap
객체의 목록을 가져옵니다.
이러한 최대 게재빈도는 광고 기술에서 해석하는 것처럼 클릭과 상관관계가 있는 이벤트에 적용됩니다. 클릭 이벤트는 AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
API가 AD_EVENT_TYPE_CLICK
이벤트 유형으로 호출될 때 집계됩니다.
반환 값 | |
---|---|
List<KeyedFrequencyCap> |
이 값은 null 일 수 없습니다. |
getKeyedFrequencyCapsForImpressionEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents ()
AD_EVENT_TYPE_IMPRESSION
이벤트 유형을 필터링할 KeyedFrequencyCap
객체의 목록을 가져옵니다.
이러한 최대 게재빈도는 광고 기술에서 해석한 노출과 상관관계가 있는 이벤트에 적용됩니다.
AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver)
를 호출할 때 이벤트가 자동으로 계산되지 않습니다. 대신 AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
API를 사용하여 AD_EVENT_TYPE_IMPRESSION
이벤트 유형을 업데이트해야 합니다.
반환 값 | |
---|---|
List<KeyedFrequencyCap> |
이 값은 null 일 수 없습니다. |
getKeyedFrequencyCapsForViewEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()
AD_EVENT_TYPE_VIEW
이벤트 유형을 필터링할 KeyedFrequencyCap
객체의 목록을 가져옵니다.
이러한 최대 게재빈도는 광고 기술에서 해석하는 대로 조회와 상관관계가 있는 이벤트에 적용됩니다. 조회 이벤트는 AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
API가 AD_EVENT_TYPE_VIEW
이벤트 유형으로 호출될 때 집계됩니다.
반환 값 | |
---|---|
List<KeyedFrequencyCap> |
이 값은 null 일 수 없습니다. |
getKeyedFrequencyCapsForWinEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents ()
AD_EVENT_TYPE_WIN
이벤트 유형을 필터링할 KeyedFrequencyCap
객체의 목록을 가져옵니다.
이 최대 게재빈도는 광고 선택 시 낙찰된 광고의 이벤트에 적용됩니다. 낙찰된 광고는 낙찰 이벤트 유형에서 연결된 카운터 키를 자동으로 증가시키는 데 사용됩니다.
AD_EVENT_TYPE_WIN
이벤트 유형은 AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
API를 사용하여 수동으로 업데이트할 수 없습니다.
반환 값 | |
---|---|
List<KeyedFrequencyCap> |
이 값은 null 일 수 없습니다. |
toString
public String toString ()
객체의 문자열 표현을 반환합니다. 일반적으로 toString
메서드는 이 객체를 '텍스트로 표현'하는 문자열을 반환합니다. 결과는 사람이 읽기 쉬우며 간결하지만 정보를 제공하도록 표현되어야 합니다.
모든 서브클래스는 이 메서드를 재정의하는 것이 좋습니다.
Object
클래스의 toString
메서드는 객체가 인스턴스인 클래스의 이름, at 기호 문자 `@
' 및 객체 해시 코드의 부호 없는 16진수 표현으로 구성된 문자열을 반환합니다. 즉, 이 메서드는 다음 값과 동일한 문자열을 반환합니다.
getClass().getName() + '@' + Integer.toHexString(hashCode())
반환 값 | |
---|---|
String |
객체의 문자열 표현입니다. |
writeToParcel
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의 조합입니다. |