@amazon-devices/kepler-adid-retriever

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

​

行为

• Verify tracking before you use the advertising ID. Call isAdvertisingTrackingEnabled and check the result before you use the value from fetchAdvertisingId for interest-based advertising. If it returns false, the user has opted out of interest-based advertising, so serve contextual (non-personalized) advertisements rather than interest-based ones.
• Child profiles. On a child profile, isAdvertisingTrackingEnabled returns false regardless of the Interest-based Ads setting. The user has opted out of interest-based advertising, so serve contextual (non-personalized) advertisements rather than interest-based ones.
• Service unavailable. fetchAdvertisingId returns an empty string if it cannot reach the Advertising Manager service. This does not raise an error. An empty string means the Advertising Manager service was unreachable. Do not use an empty string as a valid advertising ID.

​

开始使用

​

设置

1. 将以下库依赖项添加到package.json文件的dependencies部分。

      "@amazon-devices/kepler-adid-retriever": "~1.0.18",

2. 在您的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"
   

​

用法

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>
  );

​

API参考

​

类

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