as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート

@amazon-devices/kepler-adid-retriever

@amazon-devices/kepler-adid-retriever

Ad ID Retrieverは、デバイス上で広告IDと広告トラッキングステータスを取得するサービスです。

ユースケース:

  • アプリで、入札、インプレッションのレポート、広告のアトリビューションのレポートに使用する、アプリの広告IDを取得します(fetchAdvertisingId)。
  • インタレストベース広告に関するユーザーの設定を取得します(isAdvertisingTrackingEnabled)。

開始の手順

セットアップ

  1. package.jsonファイルのdependenciesセクションに、以下のライブラリ依存関係を追加します。

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

       "@amazon-devices/kepler-adid-retriever": "~1.0.6",
    
  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"
    

使用方法

この例は、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>
  );

クラス


Last updated: 2025年10月2日