API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

요약: 중첩된 클래스 | 상속된 상수 | 필드 | 메서드 | 상속된 메서드

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 객체의 빌더입니다.

상속된 상수
android.os.Parcelable 인터페이스에서 상속 int CONTENTS_FILE_DESCRIPTOR describeContents()와 함께 사용되는 설명자 비트: Parcelable 객체의 평면화된 표현에 파일 설명자가 포함되어 있음을 나타냅니다. int PARCELABLE_WRITE_RETURN_VALUE writeToParcel(Parcel, int)와 함께 사용하기 위한 플래그: 작성되는 객체는 반환 값으로, 'Parcelable someFunction()', 'void someFunction(out Parcelable)' 또는 'void someFunction(inout Parcelable)' 같은 함수의 결과입니다.

필드
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에 평면화합니다.

상속된 메서드
java.lang.Object 클래스에서 상속 Object clone() 이 개체의 사본을 만들어 반환합니다. boolean equals(Object obj) 일부 다른 개체가 이 개체와 '같은'지 여부를 나타냅니다. void finalize() 가비지 컬렉션이 더 이상 객체에 관한 참조가 없다고 판단하는 경우 객체의 가비지 컬렉터에서 호출합니다. final Class<?> getClass() 이 Object의 런타임 클래스를 반환합니다. int hashCode() 객체의 해시 코드 값을 반환합니다. final void notify() 이 객체의 모니터에서 대기 중인 단일 스레드의 대기 모드를 해제합니다. final void notifyAll() 이 개체의 모니터에서 대기 중인 모든 스레드의 대기 모드를 해제합니다. String toString() 객체의 문자열 표현을 반환합니다. final void wait(long timeoutMillis, int nanos) 일반적으로 알림을 받거나 중단되어 절전 모드에서 해제될 때까지 또는 일정 시간이 경과할 때까지 현재 스레드가 대기하도록 합니다. final void wait(long timeoutMillis) 일반적으로 알림을 받거나 중단되어 절전 모드에서 해제될 때까지 또는 일정 시간이 경과할 때까지 현재 스레드가 대기하도록 합니다. final void wait() 일반적으로 알림을 받거나 중단되어 절전 모드에서 해제될 때까지 현재 스레드가 대기하도록 합니다.
android.os.Parcelable 인터페이스에서 상속 abstract int describeContents() 이 Parcelable 인스턴스의 마셜링된 표현에 포함된 특수 객체의 종류를 설명합니다. abstract void writeToParcel(Parcel dest, int flags) 이 객체를 Parcel에 평면화합니다.

필드

생성자

API 수준 34에 추가됨
광고 서비스 확장 프로그램 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의 경우 x.equals(y)는 y.equals(x)가 true를 반환하는 경우에만 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 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

public AdSelectionSignals getAdSelectionSignals ()

반환 값
AdSelectionSignals	AdSelectionConfig에서 가져와 DSP에서 가져온 JS 로직에서 사용하는 AdSelectionSignals 객체의 JSON은 광고 선택 및 보고 프로세스에 참여하는 구매자에게 제공된 신호를 나타냅니다. 이 값은 null일 수 없습니다.

getCustomAudienceBuyers

API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

public List<AdTechIdentifier> getCustomAudienceBuyers ()

반환 값
List<AdTechIdentifier>	SSP에서 광고 선택 프로세스에 참여하도록 허용한 맞춤 잠재고객 구매자 목록입니다. 이 값은 null일 수 없습니다.

getDecisionLogicUri

API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

public Uri getDecisionLogicUri ()

반환 값
Uri	광고 선택 및 보고 프로세스 중에 사용되는 판매자/SSP scoreAd 함수가 포함된 JS 코드를 검색하는 데 사용되는 URI입니다. 이 값은 null일 수 없습니다.

getPerBuyerSignals

API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

반환 값
Map<AdTechIdentifier, AdSelectionSignals>	AdSelectionConfig에서 가져오고 DSP에서 가져온 JS 로직에 의해 사용되는 구매자 및 AdSelectionSignals의 맵으로, 각 구매자가 광고 선택 중에 참여자에게 제공할 정보 (예: 입찰가 하한선, 광고 선택 유형 등)를 나타냅니다. 이 값은 null일 수 없습니다.

getSeller

API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

public AdTechIdentifier getSeller ()

반환 값
AdTechIdentifier	판매자의 AdTechIdentifier입니다(예: 'www.example-ssp.com'). 이 값은 null일 수 없습니다.

getSellerSignals

API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

public AdSelectionSignals getSellerSignals ()

반환 값
AdSelectionSignals	SSP에서 제공하고 SSP에서 가져온 JS 로직에서 사용하는 AdSelectionSignals 객체의 JSON은 SSP가 광고 점수 프로세스에서 광고 선택 프로세스의 결과를 조정하는 데 사용한 모든 정보를 나타냅니다 (예: 브랜드 안전성 확인, 제외된 문맥 광고). 이 값은 null일 수 없습니다.

getTrustedScoringSignalsUri

API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

public Uri getTrustedScoringSignalsUri ()

반환 값
Uri	광고 소재별 실시간 정보를 가져올 수 있는 판매 측 신뢰할 수 있는 신호의 URI 엔드포인트입니다. 이 값은 null일 수 없습니다.

hashCode

API 수준 34에 추가됨

public int hashCode ()

객체의 해시 코드 값을 반환합니다. 이 메서드는 HashMap에서 제공하는 것과 같은 해시 테이블을 활용하기 위해 지원됩니다.

hashCode의 일반 계약은 다음과 같습니다.

• 객체의 equals 비교에 사용된 정보가 수정되지 않았다고 가정할 때, hashCode 메서드는 Java 애플리케이션이 실행되는 동안 동일한 객체에서 두 번 이상 호출될 때마다 동일한 정수를 일관되게 반환해야 합니다. 이 정수는 애플리케이션의 한 실행에서 동일한 애플리케이션의 또 다른 실행까지 일관되게 유지될 필요가 없습니다.
• equals(Object) 메서드에 따라 두 객체가 같다면 두 객체 각각에서 hashCode 메서드를 호출하면 동일한 정수 결과가 생성되어야 합니다.
• equals(java.lang.Object) 메서드에 따라 두 객체가 같지 않은 경우 두 객체 각각에서 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의 조합입니다.