View a markdown version of this page

会话前初始化 - AWS Elemental MediaTailor

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

会话前初始化

当它开火时

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 丢弃该函数的输出并像未附加任何函数一样继续前进。会话在没有函数的播放器参数值的情况下正常启动。