광고 ID

public class AdId
extends Object

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

사용자가 재설정할 수 있으며 기기 전체에서 고유한 프로필별 광고 ID입니다.

광고 네트워크는 AdId를 사용하여 관심 기반 광고 (IBA) 즉, 타겟팅 및 리마케팅 광고로 수익을 창출할 수 있습니다. 사용자는 이 식별자의 사용 가능성을 제한할 수 있습니다.

요약

상수

String ZERO_OUT

사용자에게 limited ad tracking가 있으면 반환되는 0으로 설정된 ad id입니다.

공개 생성자

AdId(String adId, boolean limitAdTrackingEnabled)

AdId의 인스턴스를 만듭니다.

공개 메서드

boolean equals(Object o)

일부 다른 개체가 이 개체와 '같은'지 여부를 나타냅니다.

String getAdId()

광고 ID입니다.

int hashCode()

객체의 해시 코드 값을 반환합니다.

boolean isLimitAdTrackingEnabled()

광고 추적 제한 사용 설정을 검색합니다.

String toString()

객체의 문자열 표현을 반환합니다.

상속된 메서드

상수

ZERO_OUT

API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨 
public static final String ZERO_OUT

사용자에게 limited ad tracking가 있으면 반환되는 0으로 설정된 ad id입니다.

상수 값: "00000000-0000-0000-0000-000000000000"

공개 생성자

광고 ID

public AdId (String adId, 
                boolean limitAdTrackingEnabled)

AdId의 인스턴스를 만듭니다.

매개변수
adId String: 제공업체 서비스에서 가져옵니다. 이 값은 null일 수 없습니다.
limitAdTrackingEnabled boolean: adId의 값을 결정하는 제공자 서비스의 값입니다.

공개 메서드

같음

API 수준 34에 추가되었습니다. 
public boolean equals (Object o)

일부 다른 개체가 이 개체와 '같은'지 여부를 나타냅니다.

equals 메서드는 null이 아닌 객체 참조에서 등가 관계를 구현합니다.

  • 반사적입니다. null이 아닌 참조 값 x의 경우 x.equals(x)는 true를 반환해야 합니다.
  • 대칭적입니다. null이 아닌 참조 값 x 및 y의 경우 x.equals(y)는 y.equals(x)가 true를 반환하는 경우에만 true를 반환해야 합니다.
  • 전이적입니다. null이 아닌 참조 값 x, y, z의 경우 x.equals(y)가 true를 반환하고 y.equals(z)가 true를 반환하면 x.equals(z)가 true를 반환해야 합니다.
  • 일관적입니다. null이 아닌 참조 값 x 및 y의 경우 객체에서 equals 비교에 사용된 정보가 수정되지 않았다고 가정할 때 x.equals(y)를 여러 번 호출하면 일관되게 true를 반환하거나 일관되게 false를 반환합니다.
  • null이 아닌 참조 값 x의 경우 x.equals(null)은 false를 반환해야 합니다.

Object 클래스의 equals 메서드는 객체에서 가장 구분 가능한 등가 관계를 구현합니다. 즉 null이 아닌 참조 값 x 및 y의 경우 이 메서드는 x와 y가 동일한 객체를 참조하는 경우에만 true를 반환합니다(x == y의 값이 true임).

동일한 객체에 동일한 해시 코드가 있어야 한다고 명시하는 hashCode 메서드의 일반 계약을 유지하기 위해 일반적으로 hashCode 메서드가 재정의될 때마다 이 메서드를 재정의해야 합니다.

매개변수
o Object: 비교할 참조 객체입니다.
반환 값
boolean 이 객체가 obj 인수와 동일한 경우 true, 동일하지 않은 경우에는 false입니다.

광고 ID

public String getAdId ()

광고 ID입니다.

광고 ID의 값은 isLimitAdTrackingEnabled() 및 AdServicesPermissions.ACCESS_ADSERVICES_AD_ID의 조합에 따라 달라집니다.

사용자가 limiting ad tracking이면 API가 ZERO_OUT를 반환합니다. 이렇게 하면 호출자가 수익 창출을 위해 사용자를 추적할 수 없습니다.

그렇지 않으면 기기 및 사용자에 고유한 문자열이 반환됩니다. 이 문자열은 광고를 위해 사용자를 추적하는 데 사용할 수 있습니다.

반환 값
String 이 값은 null일 수 없습니다.

hashCode

API 수준 34에 추가되었습니다. 
public int hashCode ()

객체의 해시 코드 값을 반환합니다. 이 메서드는 HashMap에서 제공하는 것과 같은 해시 테이블을 활용하기 위해 지원됩니다.

hashCode의 일반 계약은 다음과 같습니다.

  • 객체의 equals 비교에 사용된 정보가 수정되지 않았다고 가정할 때, hashCode 메서드는 Java 애플리케이션이 실행되는 동안 동일한 객체에서 두 번 이상 호출될 때마다 동일한 정수를 일관되게 반환해야 합니다. 이 정수는 애플리케이션의 한 실행에서 동일한 애플리케이션의 또 다른 실행까지 일관되게 유지될 필요가 없습니다.
  • equals(Object) 메서드에 따라 두 객체가 같다면 두 객체 각각에서 hashCode 메서드를 호출하면 동일한 정수 결과가 생성되어야 합니다.
  • equals(java.lang.Object) 메서드에 따라 두 객체가 같지 않은 경우 두 객체 각각에서 hashCode 메서드를 호출하면 별개의 정수 결과가 생성되어야 하는 것은 아닙니다. 하지만 프로그래머는 같지 않은 객체에 별개의 정수 결과를 생성하면 해시 테이블의 성능이 향상될 수 있음을 알고 있어야 합니다.

Object 클래스에서 정의한 hashCode 메서드는 상당히 실용적인 만큼 서로 다른 객체에 대해 별개의 정수를 반환합니다. hashCode는 특정 시점에 객체 메모리 주소의 일부 함수로 구현되거나 구현되지 않을 수 있습니다.

반환 값
int 이 객체의 해시 코드 값입니다.

isLimitAdTrackingEnabled

public boolean isLimitAdTrackingEnabled ()

광고 추적 제한 사용 설정을 검색합니다.

이 값은 사용자가 광고 추적 제한을 사용 설정한 경우 true, 그렇지 않은 경우 false입니다.

반환 값
boolean

toString

API 수준 34에 추가되었습니다. 
public String toString ()

객체의 문자열 표현을 반환합니다. 일반적으로 toString 메서드는 이 객체를 '텍스트로 표현'하는 문자열을 반환합니다. 결과는 사람이 읽기 쉬우며 간결하지만 정보를 제공하도록 표현되어야 합니다. 모든 서브클래스는 이 메서드를 재정의하는 것이 좋습니다.

Object 클래스의 toString 메서드는 객체가 인스턴스인 클래스의 이름, at 기호 문자 `@' 및 객체 해시 코드의 부호 없는 16진수 표현으로 구성된 문자열을 반환합니다. 즉, 이 메서드는 다음 값과 동일한 문자열을 반환합니다. 

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

반환 값
String 객체의 문자열 표현입니다.