CustomAudience

public final class CustomAudience
extends Object implements Parcelable

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


Represents the information necessary for a custom audience to participate in ad selection.

A custom audience is an abstract grouping of users with similar demonstrated interests. This class is a collection of some data stored on a device that is necessary to serve advertisements targeting a single custom audience.

Summary

Nested classes

class CustomAudience.Builder

Builder for CustomAudience objects. 

Inherited constants

Fields

public static final Creator<CustomAudience> CREATOR

Public methods

boolean equals(Object o)

Checks whether two CustomAudience objects contain the same information.

Instant getActivationTime()

On creation of the CustomAudience object, the activation time may be set in the future, in order to serve a delayed activation.

List<AdData> getAds()

This list of AdData objects is a full and complete list of the ads served by this CustomAudience during the ad selection process.

Uri getBiddingLogicUrl()

Returns the target URL used to fetch bidding logic when a custom audience participates in the ad selection process.

String getBuyer()

A buyer is identified by a domain in the form "buyerexample.com".

Uri getDailyUpdateUrl()

This URL points to a buyer-operated server that hosts updated bidding data and ads metadata to be used in the on-device ad selection process.

Instant getExpirationTime()

Once the expiration time has passed, a custom audience is no longer eligible for daily ad/bidding data updates or participation in the ad selection process.

String getName()

This name of a custom audience is an opaque string provided by the owner and buyer on creation of the CustomAudience object.

String getOwner()

Returns a String representing the custom audience's owner application or null to be the calling application.

TrustedBiddingData getTrustedBiddingData()

Trusted bidding data consists of a URL pointing to a trusted server for buyers' bidding data and a list of keys to query the server with.

String getUserBiddingSignals()

User bidding signals are provided by buyers to be consumed by buyer-provided JavaScript during ad selection in an isolated execution environment.

int hashCode()

Returns the hash of the CustomAudience object's data.

void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.

Inherited methods

Fields

Public methods

equals

public boolean equals (Object o)

Checks whether two CustomAudience objects contain the same information.

Parameters
o Object: the reference object with which to compare.

Returns
boolean true if this object is the same as the obj argument; false otherwise.

getActivationTime

public Instant getActivationTime ()

On creation of the CustomAudience object, the activation time may be set in the future, in order to serve a delayed activation. For example, a custom audience for lapsed users may not activate until a threshold of inactivity is reached, at which point the custom audience's ads will participate in the ad selection process, potentially redirecting lapsed users to the original owner application.

The maximum delay in activation is one year (365 days) from initial creation.

Returns
Instant the timestamp, truncated to milliseconds, after which the custom audience is active; This value may be null.

getAds

public List<AdData> getAds ()

This list of AdData objects is a full and complete list of the ads served by this CustomAudience during the ad selection process.

Returns
List<AdData> a List of AdData objects representing ads currently served by the custom audience This value cannot be null.

getBiddingLogicUrl

public Uri getBiddingLogicUrl ()

Returns the target URL used to fetch bidding logic when a custom audience participates in the ad selection process. The URL must use HTTPS.

Returns
Uri This value cannot be null.

getBuyer

public String getBuyer ()

A buyer is identified by a domain in the form "buyerexample.com".

Returns
String a String containing the custom audience's buyer's domain This value cannot be null.

getDailyUpdateUrl

public Uri getDailyUpdateUrl ()

This URL points to a buyer-operated server that hosts updated bidding data and ads metadata to be used in the on-device ad selection process. The URL must use HTTPS.

Returns
Uri the custom audience's daily update URL This value cannot be null.

getExpirationTime

public Instant getExpirationTime ()

Once the expiration time has passed, a custom audience is no longer eligible for daily ad/bidding data updates or participation in the ad selection process. The custom audience will then be deleted from memory by the next daily update.

If no expiration time is provided on creation of the CustomAudience, expiry will default to 60 days from activation.

The maximum expiry is one year (365 days) from initial activation.

Returns
Instant the timestamp, truncated to milliseconds, after which the custom audience should be removed; This value may be null.

getName

public String getName ()

This name of a custom audience is an opaque string provided by the owner and buyer on creation of the CustomAudience object.

Returns
String the String name of the custom audience This value cannot be null.

getOwner

public String getOwner ()

Returns a String representing the custom audience's owner application or null to be the calling application.

The value format must be <App UID>-<package name>.

Returns
String

getTrustedBiddingData

public TrustedBiddingData getTrustedBiddingData ()

Trusted bidding data consists of a URL pointing to a trusted server for buyers' bidding data and a list of keys to query the server with. Note that the keys are opaque to the custom audience and ad selection APIs.

Returns
TrustedBiddingData a TrustedBiddingData object containing the custom audience's trusted bidding data This value may be null.

getUserBiddingSignals

public String getUserBiddingSignals ()

User bidding signals are provided by buyers to be consumed by buyer-provided JavaScript during ad selection in an isolated execution environment. These signals should be represented as a valid JSON object serialized into a string.

If the user bidding signals are not a valid JSON object that can be consumed by the buyer's JS, the custom audience will not be eligible for ad selection.

Returns
String a JSON String representing the user bidding signals for the custom audience This value may be null.

hashCode

public int hashCode ()

Returns the hash of the CustomAudience object's data.

Returns
int a hash code value for this object.

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.

Parameters
dest Parcel: This value cannot be null.

flags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of Parcelable.PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES