as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
Ad ID Retriever是一项设备上的服务,用于检索广告ID和广告跟踪状态。 使用案例:
  • 检索广告ID,用于竞价、报告曝光量和报告广告归因。(fetchAdvertisingId)
  • 检索用户对基于兴趣的广告偏好。(isAdvertisingTrackingEnabled)

行为

集成Ad ID Retriever时,请考虑以下事项。
  • 使用广告ID之前,请验证跟踪状态。 在使用fetchAdvertisingId的值进行基于兴趣的广告投放之前,请调用isAdvertisingTrackingEnabled并检查结果。如果它返回false,则表示用户已退订基于兴趣的广告投放,因此请投放情境式(非个性化)广告,而非基于兴趣的广告。
  • 儿童个人资料。 在儿童个人资料上,无论基于兴趣的广告设置如何,isAdvertisingTrackingEnabled都会返回false。用户已退订基于兴趣的广告投放,因此请投放情境式(非个性化)广告,而非基于兴趣的广告。
  • **服务不可用。**如果无法访问广告管理器服务,则fetchAdvertisingId返回空字符串。这不会引发错误。空字符串表示广告管理器服务不可访问。请勿将空字符串用作有效的广告ID。

开始使用

设置

  1. 将以下库依赖项添加到package.json文件的dependencies部分。
  1. 在您的manifest.toml中,添加访问Ad ID Retriever所需的以下components和wants。

用法

此示例演示如何实现Ad ID Retriever服务。该示例提供了一个包含两个按钮的简单用户界面,展示了两个核心功能: 获取广告ID并检查广告跟踪状态。

API参考

类

  • AdIdRetriever — AdIdRetriever提供用于检索广告ID和广告跟踪状态的API。

最后修改于 2026年9月23日