全部产品
Search
文档中心

智能媒体服务:快速入门

更新时间:Mar 04, 2025

本文介绍广告插入功能快速入门。通过阅读本文您可以了解如何使用广告插入功能。

使用说明

实现广告插入功能,一般需要经过以下步骤:

  1. 开通智能媒体服务。

  2. 准备视频资源。

  3. 准备广告请求地址。

  4. 功能配置。

  5. 播放。

准备工作

  • 准备视频资源。

    视频源流需要遵循主+子的清单结构(主清单+媒体清单),同时媒体清单需要包含广告标记。

    主清单

    #EXTM3U
    #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=100000,CODECS="mp4a.40.2,avc1.64001e",RESOLUTION=640x302
    video/player-ld.m3u8
    #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=200000,CODECS="mp4a.40.2,avc1.64001f",RESOLUTION=848x402
    video/player-sd.m3u8
    #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=300000,CODECS="mp4a.40.2,avc1.640020",RESOLUTION=1280x606
    video/player-hd.m3u8
    

    包含广告标记的媒体清单

    #EXTM3U
    #EXT-X-VERSION:6
    #EXT-X-PLAYLIST-TYPE:EVENT
    #EXT-X-TARGETDURATION:14
    #EXT-X-MEDIA-SEQUENCE:0
    #EXT-X-DISCONTINUITY
    #EXT-X-CUE-OUT:60.00
    ...
    #EXT-X-CUE-IN
    #EXTINF:16.666,
    1723518884_121.ts
    #EXTINF:2.533,
    1723518886_122.ts
    #EXT-X-ENDLIST

    如果您暂时还不了解什么是主清单以及广告标记,可以参见文档内容协议说明

  • 准备广告请求地址。

    地址示例:

    http://ads.aliyundoc.com/getAd?adId=[player_params.ad_id]

    接入的广告服务器需要遵循 VAST 和 VMAP 规范以及 IAB 制定的行业标准。详情请参见广告服务器要求

功能配置

  1. 登录智能媒体服务控制台,在顶部左上角根据实际情况选择地域。

  2. 在左侧导航栏选择媒体广告 > 广告插入配置,可以创建广告插入配置。

    image

    创建配置:

    image

    参数说明:

    参数名

    说明

    名称

    自定义输入,不可重复。

    内容源

    源流的URL前缀,根据实际情况填写。比如播放内容为https://player.aliyundoc.com/source/example1.m3u8,填写https://player.aliyundoc.com/source/。

    广告决策服务器(ADS)

    广告请求地址,根据实际情况填写。

    点击确定即完成了配置。

功能使用

在功能配置完成后,列表页可以获取插入广告的视频源播放地址前缀。

image

在播放时,使用播放地址前缀加上文件名进行播放。

例如,您的视频源地址为https://player.aliyundoc.com/source/example1.m3u8,在配置功能时所填写的内容源为https://player.aliyundoc.com/source/,则播放地址为:播放地址前缀+example1.m3u8。您可以使用支持HLS协议的播放器进行播放。