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.
Confira também:
Resumo
Constantes | |
---|---|
String |
ZERO_OUT
Um |
Construtores públicos | |
---|---|
AdId(String adId, boolean limitAdTrackingEnabled)
Cria uma instância de |
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
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 retornartrue
. - É simétrico: para valores de referência não nulos
x
ey
,x.equals(y)
vai retornartrue
somente sey.equals(x)
retornartrue
. - É transitivo: para valores de referência não nulos
x
,y
ez
, sex.equals(y)
retornartrue
ey.equals(z)
retornartrue
, entãox.equals(z)
vai retornartrue
. - É consistente: para valores de referência não nulos
x
ey
, várias invocações dex.equals(y)
retornamtrue
oufalse
de maneira consistente, desde que nenhuma informação usada nas comparaçõesequals
nos objetos seja modificada. - Para valores de referência não nulos
x
,x.equals(null)
vai retornarfalse
.
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
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 deequals
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étodohashCode
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étodohashCode
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
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. |