이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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

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()` 사용자 입찰 신호는 구매자에 의해 선택적으로 제공되고, 격리된 실행 환경에서 광고 선택 중에 구매자 제공 JavaScript에 의해 사용됩니다.
`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

공개 메서드

equals

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>`	`List` 의 `AdData` 객체 맞춤 잠재고객 이 값은 `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 ()

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

사용자 입찰 신호가 구매자의 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의 조합입니다.