AdvertisingIdClient

public classAdvertisingIdClientextendsObject

Helper library for retrieval of advertising ID and related information such as the limit ad tracking setting.

It is intended that the advertising ID completely replace existing usage of other identifiers for ads purposes (such as use ofANDROID_IDinSettings.Secure) when Google Play Services is available. Cases where Google Play Services is unavailable are indicated by aGooglePlayServicesNotAvailableExceptionbeing thrown by getAdvertisingIdInfo().

Nested Class Summary

class AdvertisingIdClient.Info Includes both the advertising ID as well as the limit ad tracking setting.

Public Method Summary

static AdvertisingIdClient.Info

getAdvertisingIdInfo(Context context)

Retrieves the user's advertising ID and limit ad tracking preference.

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Objectarg0)
void	finalize()
finalClass<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

public staticAdvertisingIdClient.Info getAdvertisingIdInfo(Context context)

Retrieves the user's advertising ID and limit ad tracking preference.

This method cannot be called in the main thread as it may block leading to ANRs. An IllegalStateExceptionwill be thrown if this is called on the main thread.

Parameters

context	Current`Context` (such as the current`Activity`).

Returns

AdvertisingIdClient.Info with user's advertising ID and limit ad tracking preference.

Throws

IOException	signaling connection to Google Play Services failed.
IllegalStateException	indicating this method was called on the main thread.
GooglePlayServicesNotAvailableException	indicating that Google Play is not installed on this device.
GooglePlayServicesRepairableException	indicating that there was a recoverable error connecting to Google Play Services.