CustomAudience

public final class CustomAudience
extends Object implements Parcelable

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

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

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

요약

중첩된 클래스

class CustomAudience.Builder

CustomAudience 객체의 빌더입니다. 

상속된 상수

필드

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

상속된 메서드

필드

생성자

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

public Instant getActivationTime ()

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

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

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

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

반환 값
Instant 밀리초로 잘리는 타임스탬프 Instant, 이후 커스텀 잠재고객이 활성 상태임 이 값은 null일 수 있습니다.

getAds

public List<AdData> getAds ()

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

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

반환 값
List<AdData> List 의 AdData 객체 맞춤 잠재고객 이 값은 null일 수 없습니다.

getBiddingLogicUri

public Uri getBiddingLogicUri ()

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

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

getBuyer

public AdTechIdentifier getBuyer ()

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

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

getDailyUpdateUri

public Uri getDailyUpdateUri ()

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

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

getExpirationTime

public Instant getExpirationTime ()

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

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

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

반환 값
Instant 밀리초로 잘리는 타임스탬프 Instant, 이후 커스텀 잠재고객을 삭제해야 합니다. 이 값은 null일 수 있습니다.

getName

public String getName ()

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

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

getTrustedBiddingData

public TrustedBiddingData getTrustedBiddingData ()

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

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

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

getUserBiddingSignals

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