ID de publicidade

public class AdId
extends Object

java.lang.Object
   ↳ android.adservices.adid.AdId


Um ID exclusivo por perfil que pode ser redefinido pelo usuário para fins de publicidade.

As redes de publicidade podem usar AdId para gerar receita com publicidade com base em interesses (IBA, na sigla em inglês), ou seja, segmentação e anúncios de remarketing. O usuário pode limitar a disponibilidade desse identificador.

Resumo

Constantes

String ZERO_OUT

Um ad id zerado que é retornado quando o usuário tem limited ad tracking.

Construtores públicos

AdId(String adId, boolean limitAdTrackingEnabled)

Cria uma instância de AdId

Métodos públicos

boolean equals(Object o)

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

String getAdId()

O ID de publicidade.

int hashCode()

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

boolean isLimitAdTrackingEnabled()

Recupera a configuração de limite ativado de rastreamento de anúncios.

String toString()

Retorna uma representação em string do objeto.

Métodos herdados

Constantes

SAIR

public static final String ZERO_OUT

Um ad id zerado que é retornado quando o usuário tem limited ad tracking.

Valor constante: "00000000-0000-0000-0000-000000000000"

Construtores públicos

ID de publicidade

public AdId (String adId, 
                boolean limitAdTrackingEnabled)

Cria uma instância de AdId

Parâmetros
adId String: recebido do serviço do provedor. Esse valor não pode ser null.

limitAdTrackingEnabled boolean: valor do serviço do provedor que determina o valor do ID do anúncio.

Métodos públicos

equals

Adicionado no nível 34 da API
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.

getAdId

public String getAdId ()

O ID de publicidade.

O valor do ID de publicidade depende de uma combinação de isLimitAdTrackingEnabled() e AdServicesPermissions.ACCESS_ADSERVICES_AD_ID.

Quando o usuário é limiting ad tracking, a API retorna ZERO_OUT. Isso impede que o autor da chamada rastreie o usuário para fins de monetização.

Caso contrário, será retornada uma string exclusiva do dispositivo e do usuário, que pode ser usada para rastrear para publicidade.

Retorna
String Esse valor não pode ser null.

hashCode

Adicionado no nível 34 da API
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.

isLimitAdTrackEnabled

public boolean isLimitAdTrackingEnabled ()

Recupera a configuração de limite ativado de rastreamento de anúncios.

Esse valor será verdadeiro se o usuário tiver ativado o limite de rastreamento de anúncios. Caso contrário, será false.

Retorna
boolean

toString

Adicionado no nível 34 da API
public String toString ()

Retorna uma representação em string do objeto. Em geral, o método toString retorna uma string que "representa textualmente" esse objeto. O resultado precisa ser uma representação concisa, mas informativa e de fácil leitura para uma pessoa. Recomendamos que todas as subclasses substituam esse método.

O método toString da classe Object retorna uma string que consiste no nome da classe de que o objeto é uma instância, o caractere de arroba "@" e a representação hexadecimal não assinada do código hash do objeto. Em outras palavras, esse método retorna uma string igual ao valor de:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Retorna
String uma representação em string do objeto.