ReportEventRequest (em inglês)

public class ReportEventRequest
extends Object

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


Objeto de solicitação que envolve os argumentos necessários para informar um evento de anúncio.

Resumo

Classes aninhadas

class ReportEventRequest.Builder

Builder para objetos ReportEventRequest

Constantes

int FLAG_REPORTING_DESTINATION_BUYER

int FLAG_REPORTING_DESTINATION_SELLER

Métodos públicos

long getAdSelectionId()

Retorna o adSelectionId, ou seja, o identificador principal de um processo de seleção de anúncios.

String getData()

Retorna os dados de evento do anúncio.

InputEvent getInputEvent()

Retorna o evento de entrada associado à interação do usuário.

String getKey()

Retorna a chave de evento, ou seja, o tipo de evento de anúncio a ser informado.

int getReportingDestinations()

Retorna o bitfield dos destinos dos relatórios (comprador, vendedor ou ambos).

Métodos herdados

Constantes

FLAG_REPORTING_DESTINATION_BUYER

public static final int FLAG_REPORTING_DESTINATION_BUYER

Valor constante: 2 (0x00000002)

FLAG_REPORTING_DESTINATION_SELLER

public static final int FLAG_REPORTING_DESTINATION_SELLER

Valor constante: 1 (0x00000001)

Métodos públicos

getAdSelectionId

public long getAdSelectionId ()

Retorna o adSelectionId, ou seja, o identificador principal de um processo de seleção de anúncios.

Retorna
long

getData

public String getData ()

Retorna os dados de evento do anúncio.

Após a seleção de anúncios, esses dados são gerados pelo autor da chamada. Em seguida, o autor da chamada pode chamar AdSelectionManager.reportEvent(ReportEventRequest, Executor, OutcomeReceiver). Esses dados serão anexados a uma solicitação POST para o reportingUri registrado no registerAdBeacon.

O tamanho de String#getBytes() no formato UTF-8 deve ser menor que 64 KB.

Retorna
String Esse valor não pode ser null.

getInputEvent

public InputEvent getInputEvent ()

Retorna o evento de entrada associado à interação do usuário.

Esse campo é null, representando um evento de visualização, ou tem um objeto InputEvent, que representa um evento de clique.

Retorna
InputEvent

getKey

public String getKey ()

Retorna a chave de evento, o tipo de evento de anúncio a ser informado.

Esse campo será usado para buscar o reportingUri associado ao eventKey registrado no registerAdBeacon após a seleção de anúncios.

Esse campo precisa ser uma correspondência exata para o eventKey registrado no registerAdBeacon. Detalhes específicos sobre registerAdBeacon podem ser encontrados no documentação de AdSelectionManager#reportImpression

A chave de evento (ao inspecionar a matriz de bytes com String#getBytes()) no formato UTF-8 não pode exceder 40 bytes. As chaves que excederem esse limite não serão registradas durante a chamada registerAdBeacon.

Retorna
String Esse valor não pode ser null.

getReportingDestinations

public int getReportingDestinations ()

Retorna o bitfield dos destinos dos relatórios (comprador, vendedor ou ambos).

Para criar esse bitfield, coloque um operador bit a bit | entre cada reportingDestination que receberá o relatório. Por exemplo, para informar apenas ao comprador, defina o campo reportingDestinations como FLAG_REPORTING_DESTINATION_BUYER para informar apenas ao vendedor, defina o campo reportingDestinations como FLAG_REPORTING_DESTINATION_SELLER para compradores e vendedores, defina o campo reportingDestinations como FLAG_REPORTING_DESTINATION_BUYER | FLAG_REPORTING_DESTINATION_SELLER

Retorna
int O valor é 0 ou uma combinação de FLAG_REPORTING_DESTINATION_SELLER e FLAG_REPORTING_DESTINATION_BUYER.