@amazon-devices/kepler-adid-retriever

オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、リリースノートを参照してください。

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サービスの実装方法を示しています。この例では、2つのボタンを備えたシンプルなUIを使用して、広告IDの取得と広告トラッキングステータスの確認という2つの主要機能を紹介します。

クリップボードにコピーしました。

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日