ReportEventRequest


public class ReportEventRequest
extends Object

java.lang.Object
   ↳ android.adservices.adselection.ReportEventRequest


Request object wrapping the required arguments needed to report an ad event.

Summary

Nested classes

class ReportEventRequest.Builder

Builder for ReportEventRequest objects. 

Constants

int FLAG_REPORTING_DESTINATION_BUYER

This is used to represent buyer as the destination for report event API.

int FLAG_REPORTING_DESTINATION_SELLER

This is used to represent seller as the destination for report event API

Public methods

long getAdSelectionId()

Returns the adSelectionId, the primary identifier of an ad selection process.

String getData()

Returns the ad event data.

InputEvent getInputEvent()

Returns the input event associated with the user interaction.

String getKey()

Returns the event key, the type of ad event to be reported.

int getReportingDestinations()

Returns the bitfield of reporting destinations to report to (buyer, seller, component seller or any of the combination of them).

Inherited methods

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

FLAG_REPORTING_DESTINATION_BUYER

public static final int FLAG_REPORTING_DESTINATION_BUYER

This is used to represent buyer as the destination for report event API.

Constant Value: 2 (0x00000002)

FLAG_REPORTING_DESTINATION_SELLER

public static final int FLAG_REPORTING_DESTINATION_SELLER

This is used to represent seller as the destination for report event API

Constant Value: 1 (0x00000001)

Public methods

getAdSelectionId

public long getAdSelectionId ()

Returns the adSelectionId, the primary identifier of an ad selection process.

Returns
long

getData

public String getData ()

Returns the ad event data.

After ad selection, this data is generated by the caller. The caller can then call AdSelectionManager.reportEvent(ReportEventRequest, Executor, OutcomeReceiver). This data will be attached in a POST request to the reportingUri registered in registerAdBeacon.

The size of String.getBytes() in UTF-8 format should be below 64KB.

Returns
String This value cannot be null.

getInputEvent

public InputEvent getInputEvent ()

Returns the input event associated with the user interaction.

This field is either null, representing a view event, or has an InputEvent object, representing a click event.

Returns
InputEvent

getKey

public String getKey ()

Returns the event key, the type of ad event to be reported.

This field will be used to fetch the reportingUri associated with the eventKey registered in registerAdBeacon after ad selection.

This field should be an exact match to the eventKey registered in registerAdBeacon. Specific details about registerAdBeacon can be found at the documentation of AdSelectionManager.reportImpression

The event key (when inspecting its byte array with String.getBytes()) in UTF-8 format should not exceed 40 bytes. Any key exceeding this limit will not be registered during the registerAdBeacon call.

Returns
String This value cannot be null.

getReportingDestinations

public int getReportingDestinations ()

Returns the bitfield of reporting destinations to report to (buyer, seller, component seller or any of the combination of them).

To create this bitfield, place an | bitwise operator between each reportingDestination to be reported to. For example to only report to buyer, set the reportingDestinations field to FLAG_REPORTING_DESTINATION_BUYER To only report to seller, set the reportingDestinations field to FLAG_REPORTING_DESTINATION_SELLER To report to buyers and sellers, set the reportingDestinations field to FLAG_REPORTING_DESTINATION_BUYER | FLAG_REPORTING_DESTINATION_SELLER. To report to buyer, seller and component seller, set the reportingDestinations field to FLAG_REPORTING_DESTINATION_BUYER | FLAG_REPORTING_DESTINATION_SELLER | ERROR(/#FLAG_REPORTING_DESTINATION_COMPONENT_SELLER).

Returns
int Value is either 0 or a combination of FLAG_REPORTING_DESTINATION_SELLER, FLAG_REPORTING_DESTINATION_BUYER, and android.adservices.adselection.ReportEventRequest.FLAG_REPORTING_DESTINATION_COMPONENT_SELLER