@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 - 広告IDと広告トラッキング状態を取得するためのAPIを提供します。