- 检索广告ID,用于竞价、报告曝光量和报告广告归因。(
fetchAdvertisingId) - 检索用户对基于兴趣的广告偏好。(
isAdvertisingTrackingEnabled)
行为
集成Ad ID Retriever时,请考虑以下事项。- 使用广告ID之前,请验证跟踪状态。 在使用
fetchAdvertisingId的值进行基于兴趣的广告投放之前,请调用isAdvertisingTrackingEnabled并检查结果。如果它返回false,则表示用户已退订基于兴趣的广告投放,因此请投放情境式(非个性化)广告,而非基于兴趣的广告。 - 儿童个人资料。 在儿童个人资料上,无论基于兴趣的广告设置如何,
isAdvertisingTrackingEnabled都会返回false。用户已退订基于兴趣的广告投放,因此请投放情境式(非个性化)广告,而非基于兴趣的广告。 - **服务不可用。**如果无法访问广告管理器服务,则
fetchAdvertisingId返回空字符串。这不会引发错误。空字符串表示广告管理器服务不可访问。请勿将空字符串用作有效的广告ID。
开始使用
设置
- 将以下库依赖项添加到package.json文件的
dependencies部分。
-
在您的manifest.toml中,添加访问Ad ID Retriever所需的以下components和wants。
用法
此示例演示如何实现Ad ID Retriever服务。该示例提供了一个包含两个按钮的简单用户界面,展示了两个核心功能: 获取广告ID并检查广告跟踪状态。API参考
类
- AdIdRetriever — AdIdRetriever提供用于检索广告ID和广告跟踪状态的API。

