透過集合功能整理內容
你可以依據偏好儲存及分類內容。
廣告
廣告 ID 程式庫會定義一個介面,讓您與所有執行應用程式裝置的系統層級廣告技術供應商互動。這個介面可讓您的應用程式接收一致的廣告 ID 值。
宣告依附元件
如果要為廣告新增依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。
在應用程式或模組的 build.gradle
檔案中,新增所需構件的依附元件:
Groovy
dependencies {
implementation 'androidx.ads:ads-identifier:1.0.0-alpha05'
// Optional - add if you're using Guava to handle
// return values of type ListenableFuture.
implementation 'com.google.guava:guava:28.0-android'
}
Kotlin
dependencies {
implementation("androidx.ads:ads-identifier:1.0.0-alpha05")
// Optional - add if you're using Guava to handle
// return values of type ListenableFuture.
implementation("com.google.guava:guava:28.0-android")
}
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
建立新問題
詳情請參閱 Issue Tracker 說明文件。
1.0.0 版本
1.0.0-alpha05 版本
2023 年 3 月 8 日
發布 androidx.ads:ads-identifier:1.0.0-alpha05
、androidx.ads:ads-identifier-common:1.0.0-alpha05
和 androidx.ads:ads-identifier-provider:1.0.0-alpha05
。查看 1.0.0-alpha05 版的修訂項。
API 變更
1.0.0-alpha04 版本
2020 年 1 月 22 日
androidx.ads:ads-identifier:1.0.0-alpha04
、androidx.ads:ads-identifier-common:1.0.0-alpha04
和 androidx.ads:ads-identifier-provider:1.0.0-alpha04
發布。1.0.0-alpha04 版包含這些修訂版本。
新功能
API 相關異動
AdvertisingIdInfo.getId()
現在會直接傳回 AdvertisingIdProvider
的廣告 ID,因此 ID 現在可能是任何格式。
1.0.0-alpha03 版
2019 年 11 月 20 日
androidx.ads:ads-identifier:1.0.0-alpha03
和 androidx.ads:ads-identifier-common:1.0.0-alpha03
發布。1.0.0-alpha03 版包含這些修訂版本。
修正錯誤
- 已移除 Java 8 程式設計語言的依附元件。這個程式庫現在指定 Java 7 程式設計語言。
1.0.0-alpha02 版
2019 年 9 月 18 日
androidx.ads:ads-identifier:1.0.0-alpha02
和 androidx.ads:ads-identifier-common:1.0.0-alpha02
發布。1.0.0-alpha02 版包含這些修訂版本。
API 相關異動
- 已將
AdvertisingIdUtils.getAdvertisingIdProviderServices()
的傳回類型從 List<ResolveInfo>
變更為 List<ServiceInfo>
修正錯誤
- 已變更
AdvertisingIdNotAvailableException
訊息,以提供更詳細的「沒有相容的 AndroidX 廣告 ID 供應商」一文。
1.0.0-alpha01 版
2019 年 8 月 7 日
androidx.ads:ads-identifier:1.0.0-alpha01
、androidx.ads:ads-identifier-common:1.0.0-alpha01
和 androidx.ads:ads-identifier-provider:1.0.0-alpha01
發布。您可以前往這裡查看這個版本包含的修訂版本。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-27 (世界標準時間)。"],[],[],null,["# Ads\n===\n\n[User Guide](/training/articles/ad-id) \nAPI Reference \n[androidx.ads.identifier](/reference/androidx/ads/identifier/package-summary) \n[androidx.ads.identifier.provider](/reference/androidx/ads/identifier/provider/package-summary) \nThe 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. \n\n| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |\n|---------------|----------------|-------------------|--------------|---------------------------------------------------------------|\n| March 8, 2023 | - | - | - | [1.0.0-alpha05](/jetpack/androidx/releases/ads#1.0.0-alpha05) |\n\nDeclaring dependencies\n----------------------\n\nTo add a dependency on Ads, you must add the Google Maven repository to your\nproject. Read [Google's Maven repository](/studio/build/dependencies#google-maven)\nfor more information.\n\nAdd the dependencies for the artifacts you need in the `build.gradle` file for\nyour app or module: \n\n### Groovy\n\n```groovy\ndependencies {\n implementation 'androidx.ads:ads-identifier:1.0.0-alpha05'\n\n // Optional - add if you're using Guava to handle\n // return values of type ListenableFuture.\n implementation 'com.google.guava:guava:28.0-android'\n}\n```\n\n### Kotlin\n\n```kotlin\ndependencies {\n implementation(\"androidx.ads:ads-identifier:1.0.0-alpha05\")\n\n // Optional - add if you're using Guava to handle\n // return values of type ListenableFuture.\n implementation(\"com.google.guava:guava:28.0-android\")\n}\n```\n\nFor more information about dependencies, see [Add build dependencies](/studio/build/dependencies).\n\nFeedback\n--------\n\nYour feedback helps make Jetpack better. Let us know if you discover new issues or have\nideas for improving this library. Please take a look at the\n[existing issues](https://issuetracker.google.com/issues?q=componentid:807287%20status:open)\nin this library before you create a new one. You can add your vote to an existing issue by\nclicking the star button.\n\n[Create a new issue](https://issuetracker.google.com/issues/new?component=807287&template=1390045)\n\nSee the [Issue Tracker documentation](https://developers.google.com/issue-tracker)\nfor more information.\n\nVersion 1.0.0\n-------------\n\n### Version 1.0.0-alpha05\n\nMarch 8, 2023\n\n`androidx.ads:ads-identifier:1.0.0-alpha05`, `androidx.ads:ads-identifier-common:1.0.0-alpha05`, and `androidx.ads:ads-identifier-provider:1.0.0-alpha05` are released. [Version 1.0.0-alpha05 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/0a3d894e8fe0217f1312fb163a89ad51bf15794e..ad9ba647b7548818fc9d4796a03a3b5510166fb3/ads)\n\n**API Changes**\n\n- Deprecated `androidx.ads:ads-identifier` \\& `androidx.ads:ads-identifier-provider`. Please migrate to the [Advertising ID API that's available as part of Google Play Services](https://developers.google.com/android/reference/com/google/android/gms/ads/identifier/AdvertisingIdClient) instead. ([I57791](https://android-review.googlesource.com/#/q/I57791965848891725f98e373d10708e1e525f334))\n\n### Version 1.0.0-alpha04\n\nJanuary 22, 2020\n\n`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](https://android.googlesource.com/platform/frameworks/support/+log/73974afa0b122e423606439e6d8e249da523534e..0a3d894e8fe0217f1312fb163a89ad51bf15794e/ads).\n\n**New features**\n\n- Performance improvements.\n\n**API changes**\n\n- `AdvertisingIdInfo.getId()` now returns the Advertising ID from `AdvertisingIdProvider` directly, so the ID could be any format now.\n\n### Version 1.0.0-alpha03\n\nNovember 20, 2019\n\n`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](https://android.googlesource.com/platform/frameworks/support/+log/561afade39b67853e2b54301e6b0cd16d19ce0a7..73974afa0b122e423606439e6d8e249da523534e/ads).\n\n**Bug fixes**\n\n- Removed dependency on the Java 8 programming language. This library now targets the Java 7 programming language.\n\n### Version 1.0.0-alpha02\n\nSeptember 18, 2019\n\n`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](https://android.googlesource.com/platform/frameworks/support/+log/886c5f552be88f0d404fbae205244e074a75bb03..561afade39b67853e2b54301e6b0cd16d19ce0a7/ads).\n\n**API changes**\n\n- Changed the return type of `AdvertisingIdUtils.getAdvertisingIdProviderServices()` from `List\u003cResolveInfo\u003e` to `List\u003cServiceInfo\u003e`\n\n**Bug fixes**\n\n- Changed the `AdvertisingIdNotAvailableException` message to more accurately read \"No compatible AndroidX Advertising ID Provider available.\"\n\n### Version 1.0.0-alpha01\n\nAugust 7, 2019\n\n`androidx.ads:ads-identifier:1.0.0-alpha01`,\n`androidx.ads:ads-identifier-common:1.0.0-alpha01`, and\n`androidx.ads:ads-identifier-provider:1.0.0-alpha01` are released. The commits\nincluded in this version can be found\n[here](https://android.googlesource.com/platform/frameworks/support/+log/b2b23e833fc78420c0e1212c35ff1fbf9b327eaf..886c5f552be88f0d404fbae205244e074a75bb03/ads)."]]