View a markdown version of this page

Pre-session 初始化 - AWS Elemental MediaTailor

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

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