게재빈도 설정 필터

public final class FrequencyCapFilters
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.common.FrequencyCapFilters


최대 게재빈도에 기반한 광고 필터의 컨테이너입니다.

하나의 광고와 최대 20개의 게재빈도 설정 필터를 연결할 수 있습니다.

최대 게재빈도 필터는 이벤트 유형을 KeyedFrequencyCap 객체 목록과 결합하여 광고 필터 모음을 정의합니다. 특정 광고에서 이러한 최대 게재빈도 중 하나를 초과하면 광고가 구매자 광고 기술의 입찰 기능에 제출된 광고 그룹에서 삭제됩니다.

요약

중첩된 클래스

class FrequencyCapFilters.Builder

FrequencyCapFilters 객체를 만들기 위한 빌더입니다. 

상수

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)

FrequencyCapFilters 객체에 동일한 정보가 포함되어 있는지 확인합니다.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents()

AD_EVENT_TYPE_CLICK 이벤트 유형을 필터링할 KeyedFrequencyCap 객체의 목록을 가져옵니다.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents()

AD_EVENT_TYPE_IMPRESSION 이벤트 유형을 필터링할 KeyedFrequencyCap 객체의 목록을 가져옵니다.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents()

AD_EVENT_TYPE_VIEW 이벤트 유형을 필터링할 KeyedFrequencyCap 객체의 목록을 가져옵니다.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents()

AD_EVENT_TYPE_WIN 이벤트 유형을 필터링할 KeyedFrequencyCap 객체의 목록을 가져옵니다.

int hashCode()

FrequencyCapFilters 객체 데이터의 해시를 반환합니다.

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 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일 수 없습니다.

hashCode

public int hashCode ()

FrequencyCapFilters 객체 데이터의 해시를 반환합니다.

반환 값
int 이 객체의 해시 코드 값입니다.

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의 조합입니다.