データの種類のリファレンス
データの種類のリファレンス
オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、最新のリリースノートを参照してください。
各トリガー（各データタイプの「送信するタイミング」を参照）について、以下のフィールドを含む正しいイベントを送信します。送信するデータをフィルタリングしたり、重複をチェックしたりする必要はありません。これは必要に応じてAmazonが行います。
視聴アクティビティ
| フィールド名 | 必須（○／×） | 説明 |
|---|---|---|
| コンテンツID | ○ | Amazonのカタログ統合を通じて指定された、ユーザーが視聴しているコンテンツのID。 |
| ライブチャンネル記述子 | ○* | カタログ統合を通じて指定された、コンテンツを再生しているライブリニアチャンネルのチャンネル記述子。 * ライブコンテンツでのみ必要です。 |
| 内部プロフィールID | ○ | Fire TVがアクティビティを正しいアプリユーザーに関連付けることができるように、難読化されたプロフィールIDを提供します。 |
| 時間 | ○ | コンテンツの長さ（ミリ秒）。 |
| 現在の再生位置 | ○ | インタースティシャルコンテンツ（プレビューや広告など）を除く、コンテンツの開始位置からのオフセット（ミリ秒）を示します。 |
| クレジットの位置 | × | コンテンツ内のクレジットの位置。インタースティシャルコンテンツ（プレビューや広告など）を除く、コンテンツの開始位置からのオフセット（ミリ秒）を示します。このフィールドは、ユーザーがコンテンツを視聴し終えたことをFire TVで検出するのに役立ちます。 |
| イベントのタイムスタンプ | ×* | * Off-Deviceイベントでは必須ですが、Activeイベントでは必須ではありません。 |
| 再生状態 | ○ | コンテンツの再生状態を表す列挙型。列挙値の一覧については、APIドキュメントを参照してください。 |
ウォッチリスト
| フィールド名 | 必須（○／×） | 説明 |
|---|---|---|
| コンテンツID | ○ | カタログ統合を通じてFire TVに提供されたコンテンツIDに対応します。 |
| 追加日 | ○ | ユーザーがウォッチリストにエントリを追加したときのタイムスタンプ |
| 内部プロフィールID | ○ | Fire TVがアクティビティを正しいアプリユーザーに関連付けることができるようにするための、難読化されたプロフィールID。 |
次の手順
トリガーとSDK呼び出しに関するもう1つの便利なリファレンスとして、リファレンスの概要の表を参照してください。
Last updated: 2026年7月13日
