要发送的内容
对于每个触发器（参见“何时发送”），发送包含以下字段的事件。无需筛选您发送的数据或检查是否有重复数据。亚马逊会对数据进行过滤。| 字段名 | 必填项（是/否） | 描述 |
|---|---|---|
| Content ID（内容ID） | 是 | 对应于通过目录集成提供给Fire TV的内容ID。 |
| Date When Added（添加日期） | 是 | 客户将条目添加到观看列表时的时间戳。 |
| Internal Profile ID（内部个人资料ID） | 是 | 经过混淆处理的Profile ID（个人资料ID），以便Fire TV将活动与正确的应用客户关联。 |
何时发送
- 当应用首次启动且用户已登录时。
- 添加或删除客户播放列表中的项目时。此操作可以在设备外发生。
- Fire TV的设备端服务要求刷新时。
- 切换到新的个人资料时。
发送方式
要共享客户添加到观看列表的最新作品，请使用以下TypeScript代码：// 用户开始观看内容时生成的客户条目事件示例
const customerListEntry: ICustomerListEntry = new CustomerListEntryBuilder()
.addedTimestampMs(Date.now())
.contentId(
new ContentIdBuilder()
.id('string')
.idNamespace(ContentIdNamespaces.NAMESPACE_CDF_ID)
.build(),
)
.profileId(
new ProfileIdBuilder()
.id('myProfileId1')
.idNamespace(ProfileIdNamespaces.NAMESPACE_APP_INTERNAL)
.build(),
)
.build();
// 发送事件
ContentPersonalizationServer.reportNewCustomerListEntry(
CustomerListType.WATCHLIST,
customerListEntry,
);
发送客户的完整观看列表
以下TypeScript代码演示了如何在收到内容个性化数据服务的请求时发送客户的完整观看列表：const customerListEntriesHandler: ICustomerListEntriesHandler = {
getAllCustomerListEntries: (
listType: CustomerListType,
customerListEntriesProvider: ICustomerListEntriesProvider,
) => {
let listEntries: ICustomerListEntry[] = [];
const customerListEntry1: ICustomerListEntry = new CustomerListEntryBuilder()
.addedTimestampMs(Date.now())
.contentId(
new ContentIdBuilder()
.id('content1_CDF_ID')
.idNamespace(ContentIdNamespaces.NAMESPACE_CDF_ID)
.build(),
)
.profileId(
new ProfileIdBuilder()
.id('myProfileId')
.idNamespace(ProfileIdNamespaces.NAMESPACE_APP_INTERNAL)
.build(),
)
.build();
listEntries.add(customerListEntry1);
const customerListEntry2: ICustomerListEntry = new CustomerListEntryBuilder()
.addedTimestampMs(Date.now())
.contentId(
new ContentIdBuilder()
.id('content2_CDF_ID')
.idNamespace(ContentIdNamespaces.NAMESPACE_CDF_ID)
.build(),
)
.profileId(
new ProfileIdBuilder()
.id('myProfileId')
.idNamespace(ProfileIdNamespaces.NAMESPACE_APP_INTERNAL)
.build(),
)
.build();
listEntries.add(customerListEntry2);
customerListEntriesProvider.addCustomerListChunk(listType,listEntries);
customerListEntriesProvider.commit();
}
};
// 务必要在HeadlessService的onStart函数中设置客户列表条目处理程序
ContentPersonalizationServer.setCustomerListEntriesHandler(
customerListEntriesHandler,
);
