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

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

CustomAudience

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
↳	android.adservices.customaudience.CustomAudience

---

맞춤 잠재고객이 광고 선택에 참여하는 데 필요한 정보를 나타냅니다.

맞춤 잠재고객은 유사한 관심사를 보인 사용자를 추상적으로 그룹화한 것입니다. 이 클래스는 기기에 저장된 데이터 중에서 단일 맞춤 잠재고객을 타겟팅하는 광고를 게재하는 데 필요한 일부 데이터의 모음입니다.

요약

중첩된 클래스
class	CustomAudience.Builder CustomAudience 객체의 빌더입니다.

상속된 상수
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<CustomAudience>	CREATOR

공개 메서드
boolean	equals(Object o) 두 CustomAudience 객체에 동일한 정보가 포함되어 있는지 확인합니다.
Instant	getActivationTime() CustomAudience 객체 생성 시 지연된 활성화를 처리하기 위해 활성화 시간을 선택적으로 나중에 설정할 수 있습니다.
List<AdData>	getAds() 이 AdData 객체 목록은 광고 선택 프로세스 중에 이 CustomAudience가 게재할 광고의 완전한 전체 목록입니다.
Uri	getBiddingLogicUri() 맞춤 잠재고객이 광고 선택 프로세스에 참여할 때 입찰 로직을 가져오는 데 사용되는 타겟 URI를 반환합니다.
AdTechIdentifier	getBuyer() 구매자는 'buyerexample.com' 형식의 도메인을 통해 식별됩니다.
Uri	getDailyUpdateUri() 이 URI는 기기 내 광고 선택 프로세스에서 사용할 업데이트된 입찰 데이터와 광고 메타데이터를 호스팅하는 구매자 운영 서버를 가리킵니다.
Instant	getExpirationTime() 만료 시간이 지나면 맞춤 잠재고객은 더 이상 일일 광고/입찰 데이터를 업데이트하거나 광고 선택 프로세스에 참여할 수 없습니다.
String	getName() 맞춤 잠재고객의 이름은 CustomAudience 객체 생성 시 소유자와 구매자가 제공하는 임의의 문자열입니다.
TrustedBiddingData	getTrustedBiddingData() 신뢰할 수 있는 입찰 데이터는 구매자의 입찰 데이터에 신뢰할 수 있는 서버를 가리키는 URI와 서버를 쿼리하는 키 목록으로 구성됩니다.
AdSelectionSignals	getUserBiddingSignals() 사용자 입찰 신호는 구매자에 의해 선택적으로 제공되고, 격리된 실행 환경에서 광고 선택 중에 구매자 제공 자바스크립트에 의해 사용됩니다.
int	hashCode() CustomAudience 객체 데이터의 해시를 반환합니다.
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<CustomAudience> CREATOR

공개 메서드

같음

API 수준 34에 추가되었습니다.

public boolean equals (Object o)

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

매개변수
o	Object: 비교할 참조 객체입니다.

반환 값
boolean	이 객체가 obj 인수와 동일한 경우 true, 동일하지 않은 경우에는 false입니다.

getActivationTime

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

public Instant getActivationTime ()

CustomAudience 객체 생성 시 지연된 활성화를 처리하기 위해 활성화 시간을 선택적으로 나중에 설정할 수 있습니다. 필드가 설정되지 않으면 참여 시 CustomAudience가 활성화됩니다.

예를 들어 중단 사용자의 맞춤 잠재고객은 비활성 기준점에 도달할 때까지 활성화되지 않을 수 있습니다. 비활성 기준점에 도달하면 맞춤 잠재고객의 광고가 광고 선택 프로세스에 참여하여 사용을 중단한 사용자를 원래 소유자 애플리케이션으로 리디렉션할 가능성이 있습니다.

활성화의 최대 지연 시간은 처음 생성 후 60일입니다.

지정된 경우 활성화 시간은 만료 시간보다 빠른 시점이어야 합니다.

반환 값
Instant	밀리초 단위로 잘리는 타임스탬프 Instant. 이후 맞춤 잠재고객이 활성화됨. 이 값은 null일 수 있습니다.

getAds

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

public List<AdData> getAds ()

이 AdData 객체 목록은 광고 선택 프로세스 중에 이 CustomAudience가 게재할 광고의 완전한 전체 목록입니다.

지정하지 않거나 빈 목록이 제공되는 경우 맞춤 잠재고객의 일일 업데이트를 통해 유효한 광고 목록이 제공될 때까지 CustomAudience가 광고 선택에 참여하지 않습니다.

반환 값
List<AdData>	맞춤 잠재고객이 현재 제공하는 광고를 나타내는 AdData 객체의 List. 이 값은 null일 수 없습니다.

getBiddingLogicUri

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

public Uri getBiddingLogicUri ()

맞춤 잠재고객이 광고 선택 프로세스에 참여할 때 입찰 로직을 가져오는 데 사용되는 타겟 URI를 반환합니다. URI는 HTTPS를 사용해야 합니다.

반환 값
Uri	구매자 입찰 로직을 가져오는 URI. 이 값은 null일 수 없습니다.

getBuyer

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

public AdTechIdentifier getBuyer ()

구매자는 'buyerexample.com' 형식의 도메인을 통해 식별됩니다.

반환 값
AdTechIdentifier	맞춤 잠재고객의 구매자 도메인을 포함하는 AdTechIdentifier. 이 값은 null일 수 없습니다.

getDailyUpdateUri

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

public Uri getDailyUpdateUri ()

이 URI는 기기 내 광고 선택 프로세스에서 사용할 업데이트된 입찰 데이터와 광고 메타데이터를 호스팅하는 구매자 운영 서버를 가리킵니다. URI는 HTTPS를 사용해야 합니다.

반환 값
Uri	맞춤 잠재고객의 일일 업데이트 URI. 이 값은 null일 수 없습니다.

getExpirationTime

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

public Instant getExpirationTime ()

만료 시간이 지나면 맞춤 잠재고객은 더 이상 일일 광고/입찰 데이터를 업데이트하거나 광고 선택 프로세스에 참여할 수 없습니다. 그러면 다음 일일 업데이트 시 맞춤 잠재고객이 메모리에서 삭제됩니다.

CustomAudience 생성 시 만료 기간이 제공되지 않으면 기본적으로 만료 기간은 활성화로부터 60일로 설정됩니다.

최대 만료 시간은 최초 활성화 후 60일입니다.

반환 값
Instant	밀리초 단위로 잘리는 타임스탬프 Instant. 이후 맞춤 잠재고객이 삭제되어야 합니다. 이 값은 null일 수 있습니다.

getName

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

public String getName ()

맞춤 잠재고객의 이름은 CustomAudience 객체 생성 시 소유자와 구매자가 제공하는 임의의 문자열입니다.

반환 값
String	맞춤 잠재고객의 문자열 이름. 이 값은 null일 수 없습니다.

getTrustedBiddingData

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

public TrustedBiddingData getTrustedBiddingData ()

신뢰할 수 있는 입찰 데이터는 구매자의 입찰 데이터에 신뢰할 수 있는 서버를 가리키는 URI와 서버를 쿼리하는 키 목록으로 구성됩니다. 키는 광고 선택 중에 신뢰할 수 있는 서버에 구매자의 입찰 로직을 쿼리하는 데만 사용되는 임의 식별자입니다.

지정하지 않으면 맞춤 잠재고객의 일일 업데이트를 통해 신뢰할 수 있는 입찰 데이터가 제공될 때까지 CustomAudience가 광고 선택에 참여하지 않습니다.

반환 값
TrustedBiddingData	맞춤 잠재고객의 신뢰할 수 있는 입찰 데이터를 포함하는 TrustedBiddingData 객체. 이 값은 null일 수 있습니다.

getUserBiddingSignals

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

public AdSelectionSignals getUserBiddingSignals ()

사용자 입찰 신호는 구매자에 의해 선택적으로 제공되고, 격리된 실행 환경에서 광고 선택 중에 구매자 제공 자바스크립트에 의해 사용됩니다.

사용자 입찰 신호가 구매자의 JS에 사용 가능한 유효한 JSON 객체가 아닌 경우 맞춤 잠재고객은 광고 선택 자격이 없습니다.

지정하지 않으면 맞춤 잠재고객의 일일 업데이트를 통해 사용자 입찰 신호가 제공될 때까지 CustomAudience가 광고 선택에 참여하지 않습니다.

반환 값
AdSelectionSignals	맞춤 잠재고객의 사용자 입찰 신호를 나타내는 AdSelectionSignals 객체. 이 값은 null일 수 있습니다.

hashCode

API 수준 34에 추가되었습니다.

public int hashCode ()

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

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