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 getBiddingLogicUrl()

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

String getBuyer()

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

Uri getDailyUpdateUrl()

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

Instant getExpirationTime()

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

String getName()

이 맞춤 잠재고객 이름은 CustomAudience 객체를 만들 때 소유자와 구매자가 제공한 불투명 문자열입니다.

String getOwner()

맞춤 잠재고객의 소유자 애플리케이션을 나타내는 문자열 또는 null을 호출 애플리케이션에 반환합니다.

TrustedBiddingData getTrustedBiddingData()

신뢰할 수 있는 입찰 데이터는 구매자의 입찰 데이터에 신뢰할 수 있는 서버를 가리키는 URL과 서버를 쿼리하는 키 목록으로 구성됩니다.

String getUserBiddingSignals()

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

int hashCode()

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

void writeToParcel(Parcel dest, int flags)

이 객체를 Parcel에 평면화합니다.

상속된 메서드

필드

공개 메서드

equals

public boolean equals (Object o)

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

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

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

getActivationTime

public Instant getActivationTime ()

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

활성화의 최대 지연 기간은 최초 생성으로부터 1년(365일)입니다.

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

getAds

public List<AdData> getAds ()

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

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

getBiddingLogicUrl

public Uri getBiddingLogicUrl ()

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

반환 값
Uri 이 값은 null일 수 없습니다.

getBuyer

public String getBuyer ()

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

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

getDailyUpdateUrl

public Uri getDailyUpdateUrl ()

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

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

getExpirationTime

public Instant getExpirationTime ()

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

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

최대 만료 기간은 최초 활성화로부터 1년(365일)입니다.

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

getName

public String getName ()

이 맞춤 잠재고객 이름은 CustomAudience 객체를 만들 때 소유자와 구매자가 제공한 불투명 문자열입니다.

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

getOwner

public String getOwner ()

맞춤 잠재고객의 소유자 애플리케이션을 나타내는 문자열 또는 null을 호출 애플리케이션에 반환합니다.

값 형식은 <App UID>-<package name>이어야 합니다.

반환 값
String

getTrustedBiddingData

public TrustedBiddingData getTrustedBiddingData ()

신뢰할 수 있는 입찰 데이터는 구매자의 입찰 데이터에 신뢰할 수 있는 서버를 가리키는 URL과 서버를 쿼리하는 키 목록으로 구성됩니다. 키는 맞춤 잠재고객 및 광고 선택 API에 불투명합니다.

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

getUserBiddingSignals

public String getUserBiddingSignals ()

사용자 입찰 신호는 구매자에 의해 제공되고, 격리된 실행 환경에서 광고 선택 중에 구매자 제공 자바스크립트에 의해 사용됩니다. 이러한 신호는 문자열로 직렬화되는 유효한 JSON 객체로 표현되어야 합니다.

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

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

hashCode

public int hashCode ()

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

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

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