データの種類のリファレンス
データの種類のリファレンス
トリガーごとに（各データの種類の「送信するタイミング」を参照）、以下のフィールドを含む適切なイベントを送信します。送信するデータをフィルタリングしたり、重複をチェックしたりする必要はありません。これは必要に応じてAmazonが行います。
視聴アクティビティ
| フィールド名 | 必須（○／×） | 説明 |
|---|---|---|
| イベントタイプ | ○ | イベントは、Active（アクティブ）とOff-Device（デバイス外）のいずれかのタイプになります。詳細を参照してください。 |
| コンテンツID | ○ | カタログ統合を通じて指定された、ユーザーが視聴しているコンテンツのID。 |
| ライブチャンネルのステーションID | ○* | カタログ統合を通じて指定された、コンテンツを再生しているライブリニアチャネルのID。 * ライブコンテンツでのみ必要です。 |
| 内部プロフィールID | ○ | Fire TVがアクティビティを正しいアプリユーザーに関連付けることができるように、難読化されたプロフィールIDを提供します。 |
| 時間 | ○ | コンテンツの長さ（ミリ秒）。 |
| 現在の再生位置 | ○ | インタースティシャルコンテンツ（プレビューや広告など）を除く、コンテンツの開始位置からのオフセット（ミリ秒）を示します。 |
| クレジットの位置 | × | コンテンツ内のクレジットの位置。インタースティシャルコンテンツ（プレビューや広告など）を除く、コンテンツの開始位置からのオフセット（ミリ秒）を示します。このフィールドは、ユーザーがコンテンツを視聴し終えたことをFire TVで検出するために役立ちます。 |
| イベントのタイムスタンプ | ×* | * Off-Deviceイベントでは必須ですが、Activeイベントでは必須ではありません。 |
| 再生状態 | ○ | 列挙体。指定できる値は、 PLAYING、PAUSED、EXIT、INTERSTITIALのいずれかです。 |
ウォッチリスト
| フィールド名 | 必須（○／×） | 説明 |
|---|---|---|
| コンテンツID | ○ | カタログ統合を通じてFire TVに提供されたコンテンツIDに対応します。 |
| アクティビティの日付 | ○ | ユーザーがエンタイトルメントを追加または削除したときのタイムスタンプ。 |
| リストアクション | ○ | ADDEDまたはREMOVED。 |
| 内部プロフィールID | ○ | Fire TVがアクティビティを正しいアプリユーザーに関連付けることができるように、難読化されたプロフィールIDを提供します。 |
次のステップ
サマリーリファレンス一覧で、トリガーとSDK呼び出しに関するもう1つの便利なリファレンスを確認してください。
Last updated: 2026年7月14日
