The second Android 11 Developer Preview is now available, test it out and share your feedback.

Ads

The Advertising ID library defines an interface to interact with system-level ad providers across the devices running your app. This interface allows your app to receive consistent advertising ID values.

For information on how to work with the advertising ID library, see the guide on how to get user-resettable ad identifiers.

Latest Update Current Stable Release Next Release Candidate Beta Release Alpha Release
January 22, 2020 - - - 1.0.0-alpha04

Declaring dependencies

To add a dependency on Ads, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

dependencies {
  implementation 'androidx.ads:ads-identifier:1.0.0-alpha04'

  // Optional - add if you're using Guava to handle
  // return values of type ListenableFuture.
  implementation 'com.google.guava:guava:28.0-android'
}

For more information about dependencies, see Add build dependencies.

Version 1.0.0

ads Version 1.0.0-alpha04

January 22, 2020

androidx.ads:ads-identifier:1.0.0-alpha04, androidx.ads:ads-identifier-common:1.0.0-alpha04, and androidx.ads:ads-identifier-provider:1.0.0-alpha04 are released. Version 1.0.0-alpha04 contains these commits.

New features

  • Performance improvements.

API changes

  • AdvertisingIdInfo.getId() now returns the Advertising ID from AdvertisingIdProvider directly, so the ID could be any format now.

Version 1.0.0-alpha03

November 20, 2019

androidx.ads:ads-identifier:1.0.0-alpha03 and androidx.ads:ads-identifier-common:1.0.0-alpha03 are released. Version 1.0.0-alpha03 contains these commits.

Bug fixes

  • Removed dependency on the Java 8 programming language. This library now targets the Java 7 programming language.

Version 1.0.0-alpha02

September 18, 2019

androidx.ads:ads-identifier:1.0.0-alpha02 and androidx.ads:ads-identifier-common:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits.

API changes

  • Changed the return type of AdvertisingIdUtils.getAdvertisingIdProviderServices() from List<ResolveInfo> to List<ServiceInfo>

Bug fixes

  • Changed the AdvertisingIdNotAvailableException message to more accurately read "No compatible AndroidX Advertising ID Provider available."

Version 1.0.0-alpha01

August 7, 2019

androidx.ads:ads-identifier:1.0.0-alpha01, androidx.ads:ads-identifier-common:1.0.0-alpha01, and androidx.ads:ads-identifier-provider:1.0.0-alpha01 are released. The commits included in this version can be found here.