数据类型参考
数据类型参考
对于每个触发器（参见每种数据类型对应的“何时发送”），使用以下字段发送正确的事件。无需筛选您发送的数据或检查是否有重复数据。亚马逊会在必要时进行该操作。
观看活动
| 字段名 | 必填项（是/否） | 描述 |
|---|---|---|
| Event Type（事件类型） | 是 | 该事件可以是Active（有效）或Off-Device（设备外）事件。请参见详情。 |
| Content ID（内容ID） | 是 | 通过目录集成指定的客户正在观看的内容的ID。 |
| Live Channel Station ID（直播频道电视台ID） | 是* | 通过目录集成播放指定内容的直播线性频道的ID。 *仅对直播内容为必填项。 |
| Internal Profile ID（内部个人资料ID） | 是 | 提供经过混淆处理的Profile ID（个人资料ID），这样Fire TV就可以将活动与正确的应用客户关联。 |
| Duration（持续时间） | 是 | 内容时间长度（以毫秒为单位）。 |
| Current Playback Position（当前播放位置） | 是 | 与内容开头的偏移量（以毫秒为单位），不包括间隙内容（预览、广告等）。 |
| Credits Position（片尾位置） | 否 | 内容中的片尾位置。与内容开头的偏移量（以毫秒为单位），不包括间隙内容（预览、广告等）。此字段将帮助Fire TV了解客户何时看完内容。 |
| Event Timestamp（事件时间戳） | 否* | *对于设备外事件，此为必填项，但对于有效事件，则并非必填项。 |
| Playback State（播放状态） | 是 | 具有以下可能值的枚举： PLAYING（正在播放）、PAUSED（暂停）、EXIT（退出）或INTERSTITIAL（间隙内容）。 |
单独内容权利
| 字段名 | 必填项（是/否） | 描述 |
|---|---|---|
| Content ID（内容ID） | 是 | 对应于通过目录集成提供给Fire TV的内容ID。 |
| Type（类型） | 是 | 以下各项之一： Recording（录像）、Purchase（购买）或Rental（租赁）。这让Fire TV能够在用户界面中为客户正确标记内容。 |
| Expiration Date（到期日期） | 否 | 此内容权利到期时的时间戳。缺少该值意味着它不会过期。 |
| Entitlement Acquisition Date（权利获取日期） | 是 | 客户购买内容的时间戳。可以是录制剧集的时间。 |
| Acquisition Profile ID（收购个人资料ID） | 否 | （可选）用于个性化设置目的。我们假设权利适用于所有个人资料。 |
观看列表
| 字段名 | 必填项（是/否） | 描述 |
|---|---|---|
| Content ID（内容ID） | 是 | 对应于通过目录集成提供给Fire TV的内容ID。 |
| Activity Date（活动日期） | 是 | 客户添加或删除权利时的时间戳。 |
| List Action（列出操作） | 是 | ADDED（已添加）或REMOVED（移除）。 |
| Internal Profile ID（内部个人资料ID） | 是 | 提供经过混淆处理的Profile ID（个人资料ID），以便Fire TV将活动与正确的应用客户关联。 |
后续步骤
请参阅我们的摘要参考表，查看有关触发器和SDK调用的其他便捷参考资源。
Last updated: 2023年11月29日