# AdIdManager

# AdIdManager

Artifact:[androidx.privacysandbox.ads:ads-adservices](https://developer.android.com/jetpack/androidx/releases/privacysandbox-ads)  
[View Source](https://cs.android.com/search?q=file:androidx/privacysandbox/ads/adservices/adid/AdIdManager.kt+class:androidx.privacysandbox.ads.adservices.adid.AdIdManager)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/privacysandbox-ads#1.0.0)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/privacysandbox/ads/adservices/adid/AdIdManager "View this page in Java")

<br />

```
abstract class AdIdManager
```

<br />

*** ** * ** ***

AdId Manager provides APIs for app and ad-SDKs to access advertising ID. The advertising ID is a unique, per-device, user-resettable ID for advertising. It gives users better controls and provides developers with a simple, standard system to continue to monetize their apps via personalized ads (formerly known as interest-based ads).

## Summary

|                                              ### Public companion functions                                              |
|--------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [AdIdManager](https://developer.android.com/reference/kotlin/androidx/privacysandbox/ads/adservices/adid/AdIdManager)`?` | [obtain](https://developer.android.com/reference/kotlin/androidx/privacysandbox/ads/adservices/adid/AdIdManager#obtain(android.content.Context))`(context: `[Context](https://developer.android.com/reference/android/content/Context.html)`)` Creates[AdIdManager](https://developer.android.com/reference/kotlin/androidx/privacysandbox/ads/adservices/adid/AdIdManager). |

|                                                    ### Public functions                                                    |
|----------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `abstract suspend `[AdId](https://developer.android.com/reference/kotlin/androidx/privacysandbox/ads/adservices/adid/AdId) | `@`[RequiresPermission](https://developer.android.com/reference/kotlin/androidx/annotation/RequiresPermission)`(value = "android.permission.ACCESS_ADSERVICES_AD_ID")` [getAdId](https://developer.android.com/reference/kotlin/androidx/privacysandbox/ads/adservices/adid/AdIdManager#getAdId())`()` Return the AdId. |

## Public companion functions

### obtain

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/privacysandbox-ads#1.0.0)  

```
fun obtain(context: Context): AdIdManager?
```

Creates[AdIdManager](https://developer.android.com/reference/kotlin/androidx/privacysandbox/ads/adservices/adid/AdIdManager).  

|                                                         Returns                                                          |
|--------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
| [AdIdManager](https://developer.android.com/reference/kotlin/androidx/privacysandbox/ads/adservices/adid/AdIdManager)`?` | AdIdManager object. If the device is running an incompatible build, the value returned is null. |

## Public functions

### getAdId

```
@RequiresPermission(value = "android.permission.ACCESS_ADSERVICES_AD_ID")
abstract suspend fun getAdId(): AdId
```

Return the AdId.  

|                                                          Throws                                                          |
|--------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------|
| [java.lang.SecurityException](https://developer.android.com/reference/java/lang/SecurityException.html)                  | if caller is not authorized to call this API. |
| [kotlin.IllegalStateException](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-illegal-state-exception/index.html) | if this API is not available.                 |
| [android.os.LimitExceededException](https://developer.android.com/reference/android/os/LimitExceededException.html)      | if rate limit was reached.                    |