データの種類のリファレンス

各トリガー（各データタイプの「送信するタイミング」を参照）について、以下のフィールドを含む正しいイベントを送信します。送信するデータをフィルタリングしたり、重複をチェックしたりする必要はありません。これは必要に応じてAmazonが行います。

• 視聴アクティビティ
• 個別のコンテンツエンタイトルメント
• ウォッチリスト
• コンテンツインタラクション
• 次の手順

視聴アクティビティ

フィールド名	必須（○／×）	説明
コンテンツID	○	Amazonのカタログ統合を通じて指定された、ユーザーが視聴しているコンテンツのID。
ライブチャンネル記述子	○*	カタログ統合を通じて指定された、コンテンツを再生しているライブリニアチャンネルのチャンネル記述子。 * ライブコンテンツでのみ必要です。
内部プロフィールID	○	Fire TVがアクティビティを正しいアプリユーザーに関連付けることができるように、難読化されたプロフィールIDを提供します。
時間	○	コンテンツの長さ（ミリ秒）。
現在の再生位置	○	インタースティシャルコンテンツ（プレビューや広告など）を除く、コンテンツの開始位置からのオフセット（ミリ秒）を示します。
クレジットの位置	×	コンテンツ内のクレジットの位置。インタースティシャルコンテンツ（プレビューや広告など）を除く、コンテンツの開始位置からのオフセット（ミリ秒）を示します。このフィールドは、ユーザーがコンテンツを視聴し終えたことをFire TVで検出するのに役立ちます。
イベントのタイムスタンプ	×*	* Off-Deviceイベントでは必須ですが、Activeイベントでは必須ではありません。
再生状態	○	コンテンツの再生状態を表す列挙型。列挙値のリストについては、APIドキュメントを参照してください。

個別のコンテンツエンタイトルメント

フィールド名	必須（○／×）	説明
コンテンツID	○	Amazonのカタログ統合を通じてFire TVに提供されたコンテンツIDに対応します。
タイプ	○	次のいずれかです。 録画、購入、レンタル。これにより、Fire TVはUIでユーザー向けのコンテンツに正しくラベルを付けることができます。
有効期限	×	このコンテンツエンタイトルメントの有効期限が切れるときのタイムスタンプ。0以下の値は、有効期限がないことを意味します。
エンタイトルメント取得日	○	ユーザーがコンテンツを購入したときのタイムスタンプ、またはエピソードが録画されたときのタイムスタンプ。ない場合は、現在の時刻が使用されます。

ウォッチリスト

フィールド名	必須（○／×）	説明
コンテンツID	○	カタログ統合を通じてFire TVに提供されたコンテンツIDに対応します。
追加日	○	ユーザーがウォッチリストにエントリを追加したときのタイムスタンプ
内部プロフィールID	○	Fire TVがアクティビティを正しいアプリユーザーに関連付けることができるようにするための、難読化されたプロフィールID。

コンテンツインタラクション

フィールド名	必須（○／×）	説明
コンテンツID	○	カタログ統合を通じてFire TVに提供されたコンテンツIDに対応します。
インタラクション日	○	インタラクションが発生したときのタイムスタンプ。
内部プロフィールID	○	Fire TVがアクティビティを正しいアプリユーザーに関連付けることができるようにするための、難読化されたプロフィールID。
インタラクションタイプ	○	インタラクションタイプを示す列挙型。列挙値のリストについては、APIドキュメントを参照してください。

次の手順

トリガーとSDK呼び出しに関するもう1つの便利なリファレンスとして、リファレンスの概要の表を参照してください。

---

Last updated: 2025年9月30日