@amazon-devices/kepler-adid-retriever

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发布说明。

Ad ID Retriever是一项设备上的服务，用于检索广告ID和广告跟踪状态。

使用案例：

检索应用广告ID，用于竞价、报告曝光量和报告广告归因。(fetchAdvertisingId)
检索用户对基于兴趣的广告偏好。(isAdvertisingTrackingEnabled)

开始使用

设置

将以下库依赖项添加到package.json文件的dependencies部分。
已复制到剪贴板。
```
   "@amazon-devices/kepler-adid-retriever": "~1.0.6",
```

在您的manifest.toml中，添加访问Ad ID Retriever所需的以下权限。

已复制到剪贴板。

 schema-version = 1

 [package]
 title = "用于测试广告ID的UI React Native应用"
 version = "1.0.0"
 id = "com.amazon.kepleradiddemo"

 [components]
 [[components.interactive]]
 id = "com.amazon.kepleradiddemo.main"
 runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"
 launch-type = "singleton"

 [wants]
 [[wants.service]]
 id = "com.amazon.admanager.service.main"

用法

此示例演示如何实现Ad ID Retriever服务。该示例提供了一个带有两个按钮的简单用户界面，这些按钮展示了两个核心功能：获取广告ID和检查广告跟踪状态。

已复制到剪贴板。

import {
  AdIdRetriever,
} from '@amazon-devices/kepler-adid-retriever';

function doIsAdvertisingTrackingEnabled() {
  const isAdTrackingEnabled: boolean = AdIdRetriever.isAdvertisingTrackingEnabled();
  console.log(
    'adid-js-demo: isAdTrackingEnabled = ' + isAdTrackingEnabled,
  );
}

function doFetchAdvertisingId() {
  const advertisingId: string = AdIdRetriever.fetchAdvertisingId();
  console.log('adid-js-demo: advertisingId = ' + advertisingId);
}

export const AdIdManagerJsSampleMain = () => {
  const handleIsAdvertisingTrackingEnabled = () => {
    doIsAdvertisingTrackingEnabled();
  };
  const handleFetchAdvertisingId = () => {
    doFetchAdvertisingId();
  };

  // 自定义的“Focusable”是一个可设定焦点的按钮
  return (
    <View style={styles.container}>
      <Focusable
        title="isAdvertisingTrackingEnabled"
        onPress={handleIsAdvertisingTrackingEnabled}
        testIdLabel="isAdvertisingTrackingEnabled"
      />
      <Focusable
        title="fetchAdvertisingId"
        onPress={handleFetchAdvertisingId}
        testIdLabel="fetchAdvertisingId"
      />
    </View>
  );

类

AdIdRetriever

Last updated: 2025年10月2日