你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
RankRequest interface
请求一组按个性化体验创建服务进行排名的操作。
属性
actions | 个性化体验创建服务可从中选择的操作集。 该集包含的操作不应超过 50 个。 操作的顺序不会影响排名结果,但顺序应与应用程序用于显示它们的顺序匹配。 |
context |
个性化体验创建服务用作字典的上下文功能。 这取决于应用程序,通常包括有关当前用户、其设备、配置文件信息、有关时间和日期的数据等的功能。 |
defer |
如果用户将看到排名结果,则发送 false,因此个性化体验创建服务需要奖励调用,否则它将为事件分配默认奖励。 如果用户可能看不到排名结果,则发送 true,因为页面稍后呈现,或者排名结果可能被代码在下游进一步重写。 默认值:false。 |
event |
(可选)传递唯一标识此 Rank 事件的 eventId。 如果为 null,则服务将生成唯一的 eventId。 eventId 将用于将此请求与其奖励相关联,以及在进行个性化体验创建服务调用时为伪随机生成器设定种子。 |
excluded |
要从排名中排除的操作 ID 集。 |
属性详细信息
actions
个性化体验创建服务可从中选择的操作集。 该集包含的操作不应超过 50 个。 操作的顺序不会影响排名结果,但顺序应与应用程序用于显示它们的顺序匹配。
actions: RankableAction[]
属性值
contextFeatures
个性化体验创建服务用作字典的上下文功能。 这取决于应用程序,通常包括有关当前用户、其设备、配置文件信息、有关时间和日期的数据等的功能。
contextFeatures?: any[]
属性值
any[]
deferActivation
如果用户将看到排名结果,则发送 false,因此个性化体验创建服务需要奖励调用,否则它将为事件分配默认奖励。 如果用户可能看不到排名结果,则发送 true,因为页面稍后呈现,或者排名结果可能被代码在下游进一步重写。 默认值:false。
deferActivation?: boolean
属性值
boolean
eventId
(可选)传递唯一标识此 Rank 事件的 eventId。 如果为 null,则服务将生成唯一的 eventId。 eventId 将用于将此请求与其奖励相关联,以及在进行个性化体验创建服务调用时为伪随机生成器设定种子。
eventId?: string
属性值
string
excludedActions
要从排名中排除的操作 ID 集。
excludedActions?: string[]
属性值
string[]