AdWithBid

public final class AdWithBid
extends Object implements Parcelable

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


Representa um anúncio e o valor do lance correspondente após a etapa de geração de lance no processo de seleção de anúncios.

Os anúncios e os lances deles são alimentados para um processo de pontuação que informa a seleção final. A unidade monetária do lance precisa ser a mesma solicitada pelo vendedor ao iniciar o processo de seleção e não ser especificada nesta classe. O vendedor pode fornecer a moeda via AdSelectionSignals. Por enquanto, a moeda é opaca para o FLEDGE.

Resumo

Constantes herdadas

Campos

public static final Creator<AdWithBid> CREATOR

Construtores públicos

AdWithBid(AdData adData, double bid)

Métodos públicos

int describeContents()

Descreve os tipos de objetos especiais contidos na representação empacotada dessa instância de Parcelable.

boolean equals(Object o)

Indica se algum outro objeto é "igual a" esse.

AdData getAdData()
double getBid()

O lance é o valor que um anunciante propôs durante o processo de seleção de anúncios para mostrar um anúncio.

int hashCode()

Retorna um valor de código hash para o objeto.

void writeToParcel(Parcel dest, int flags)

Nivela esse objeto em um Parcel.

Métodos herdados

Campos

Construtores públicos

AdWithBid

public AdWithBid (AdData adData,
                double bid)

Parâmetros
adData AdData: um objeto AdData que define o URL de renderização e os metadados do comprador de um anúncio. Esse valor não pode ser null.

bid double: o valor que um comprador propôs para mostrar um anúncio. É esperado que o lance não seja negativo, mas essa análise só é feita durante o processo de seleção de anúncios.

Gera
NullPointerException quando adData é nulo.

Métodos públicos

describeContents

public int describeContents ()

Descreve os tipos de objetos especiais contidos na representação empacotada dessa instância de Parcelable. Por exemplo, se o objeto incluir um descritor do arquivo na saída de writeToParcel(android.os.Parcel, int), o valor de retorno desse método vai incluir o bit CONTENTS_FILE_DESCRIPTOR.

Retorna
int Um bitmask que indica o conjunto de tipos de objetos especiais empacotados por essa instância do objeto Parcelable. O valor é 0 ou CONTENTS_FILE_DESCRIPTOR.

equals

public boolean equals (Object o)

Indica se algum outro objeto é igual a esse.

O método equals implementa uma relação de equivalência em referências de objetos não nulos:

  • É reflexivo: para valores de referência não nulos x, x.equals(x) vai retornar true.
  • É simétrico: para valores de referência não nulos x e y, x.equals(y) vai retornar true somente se y.equals(x) retornar true.
  • É transitivo: para valores de referência não nulos x, y e z, se x.equals(y) retornar true e y.equals(z) retornar true, então x.equals(z) vai retornar true.
  • É consistente: para valores de referência não nulos x e y, várias invocações de x.equals(y) retornam true ou false de maneira consistente, desde que nenhuma informação usada nas comparações equals nos objetos seja modificada.
  • Para valores de referência não nulos x, x.equals(null) vai retornar false.

O método equals para a classe Object implementa a relação de equivalência mais discriminatória possível em objetos, ou seja, para valores de referência não nulos x e y, esse método vai retornar true somente se x e y se referirem ao mesmo objeto (x == y tem o valor true).

Geralmente, é necessário substituir o método hashCode sempre que o método equals for substituído. Isso serve para manter o contrato geral do método hashCode, que declara que objetos iguais precisam ter códigos hash iguais.

Parâmetros
o Object: o objeto de referência para comparação.

Retorna
boolean true, se esse objeto for o mesmo que o argumento obj. Caso contrário, false.

getAdData

public AdData getAdData ()

Retorna
AdData o anúncio que recebeu lances Esse valor não pode ser null.

getBid

public double getBid ()

O lance é o valor que um anunciante propôs durante o processo de seleção de anúncios para mostrar um anúncio. Ele pode ser qualquer valor double não negativo, como 0,00, 0,17, 1,10 ou 1.000,00.

A moeda de um lance é controlada pelo vendedor e permanece consistente em toda a seleção de anúncios. Isso pode ser feito aproveitando indicadores de lances durante a fase "generateBid()" e usando a mesma moeda durante a criação de anúncios contextuais. Versões futuras talvez ofereçam suporte ao uso da unidade da moeda como um campo dedicado.

Retorna
double o valor do lance que vai ser transmitido para a função de pontuação ao classificar o anúncio retornado por getAdData().

hashCode

public int hashCode ()

Retorna um valor de código hash para o objeto. Esse método oferece suporte para as tabelas de hash, como as fornecidas por HashMap.

O contrato geral de hashCode é:

  • Sempre que ele é invocado no mesmo objeto mais de uma vez durante a execução de um aplicativo Java, o método hashCode precisa retornar consistentemente o mesmo número inteiro, desde que nenhuma informação usada em comparações de equals no objeto seja modificada. Esse número inteiro não precisa permanecer consistente entre execuções diferentes do mesmo app.
  • Se dois objetos forem iguais de acordo com o método equals(Object), chamar o método hashCode em cada um deles precisa produzir o mesmo resultado com números inteiros.
  • Se dois objetos forem diferentes de acordo com o método equals(java.lang.Object), não é necessário que a chamada do método hashCode em cada um dos dois objetos produza resultados inteiros distintos. No entanto, o programador precisa estar ciente de que a produção de resultados inteiros distintos para objetos diferentes pode melhorar o desempenho das tabelas de hash.

No limite do possível, o método hashCode definido pela classe Object retorna números inteiros distintos para objetos diferentes. O hashCode pode ou não ser implementado como uma função do endereço de memória de um objeto em algum momento.

Retorna
int Um valor de código hash para esse objeto.

writeToParcel

public void writeToParcel (Parcel dest,
                int flags)

Nivela esse objeto em um Parcel.

Parâmetros
dest Parcel: este valor não pode ser null.

flags int: outras sinalizações sobre como o objeto precisa ser criado. Pode ser 0 ou Parcelable.PARCELABLE_WRITE_RETURN_VALUE. O valor é 0 ou uma combinação de Parcelable.PARCELABLE_WRITE_RETURN_VALUE e android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES