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.

Feedback

Your feedback helps make Jetpack better. Please let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

Create a new issue

See the Issue Tracker documentation for more information.

Version 1.0.0

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.