本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Pre-session 初始化
当它着火的时候
MediaTailor 在新播放会话开始时运行映射到PRE_SESSION_INITIALIZATION的函数。该函数在 MediaTailor 构造初始清单响应之前运行。
Input
session.*、player_params.* 和 event.*。有关所有可用字段,请参阅输入字段参考。
允许输出命名空间
| 命名空间 | 可接受的类型 |
|---|---|
player_params.* |
字符串、数字、布尔值 |
写入的player_params.*值将保留到会话中。它们可用:
-
作为
PRE_ADS_REQUEST生命周期挂钩处的输入player_params.* -
在 ADS 中,通过以下方式请求网址MediaTailor ADS 请求的动态广告变量(例如,
[player_params.deviceType]) -
在会话的整个生命周期内,涵盖所有广告时段
注意
所有player_params输出键和值的序列化总大小不得超过 1,000 个字符。如果总数超过此限制,则函数输出将被丢弃。有关更多信息,请参阅 功能限制。
典型用例
-
从外部服务获取身份或受众数据,并将其存储在玩家参数中,以便在以后的 ADS 请求中使用。
-
根据用户代理对设备类型进行分类,并将分类写入玩家参数。
-
设置下游广告插播处理所依赖的默认播放器参数值。
-
通过将值存储在 ADS 网址中包含的玩家参数中MediaTailor ADS 请求的动态广告变量。
失败行为
如果附加到的函数因任何原因PRE_SESSION_INITIALIZATION失败,则 MediaTailor 丢弃该函数的输出,并像没有附加函数一样继续操作。会话在没有函数的播放器参数值的情况下正常启动。