与 AdSense 内容广告相比,AdSense 视频广告和 AdSense 游戏广告产品的代码结构大为不同。后者要求使用互动式媒体广告 (IMA) 代码,并且仅在使用可集成 Google IMA SDK 和/或符合 VAST 和 VPAID 规定的视频播放器或游戏启动器(例如 IMA 适配器)进行调用时才会返回广告。
一般来说,您可以通过 AdSense 视频广告代码生成器来生成此类代码。下文完整列出了您可以为这些广告代码设置的不同条件。AdSense 视频广告代码投放广告所需的必需参数并不多,不过您可以通过添加渠道 ID、广告时长下限/上限、语言等可选参数来实现目标广告响应。
IMA 广告代码参数 | 必需参数 |
---|---|
ad_type | 是 |
client | 是 |
description_url | 是 - 必须经过网址编码 |
channel | 不是 - 推荐(如适用) |
adsafe | 不是 - 推荐 |
videoad_start_delay | 不是 - 推荐 |
hl | 不是 - 推荐 |
max_ad_duration | 不是 - 推荐 |
min_ad_duration | 不是 - 推荐 |
sdmax | 不是 - 推荐 |
adtest | 不是 |
cust_age | 不是 |
cust_gender | 不是 |
host | 不是 |
h_ch | 不是 |
overlay | 不是 |
基准网址
以下网址为下面介绍的所有查询参数提供了参考基准:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(String) 指定所需的广告类型。应使用下划线(“_”)连接起来。
值
- video:所有视频广告:等同于 standardvideo_skippablevideo_bumpervideo。
- skippablevideo:仅限可跳过的视频广告。可能需要更多发布商权限才能接收可跳过的广告。
- bumpervideo:允许六秒钟不可跳过的视频广告。
- standardvideo:仅限不可跳过的视频广告。
- image:允许与指定非线性广告位尺寸相符的图片广告。
- text:允许文字广告。
示例
- &ad_type=video_text_image
- 允许所有格式。
- &ad_type=video_text
- 允许所有视频格式和文字广告。
- &ad_type=standardvideo_image
- 仅允许不可跳过的标准视频和图片广告。
client
(String) 发布商网络媒体资源 ID。
示例:&client=ca-video-afvtest
description_url
(String) 经过网址编码的完整网址,所对应的 HTML 网页描述了相关视频。description_url值可以使用服务器端编程语言动态创建,用户也可以使用在线网址编码工具手动创建该值。
示例:&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
网址示例
下面的网址示例中仅包含最基本的必需参数。https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
为发布商“ca-video-afvtest”请求视频广告,其说明网址为 http:// myurl.com/page?key=value&key2=value2
channel
(String) 一个以加号分隔的渠道列表,用于 AdSense 定位和报告。最多可对每个广告请求传入 5 个渠道。
示例:&channel=mychannel+otherchannel+targetingchannel
adsafe
(String) 决定用来过滤广告能否进行展示的设置。默认设置为“high”。
值:
- high --(默认)返回内容健康的广告。不返回内容不健康或包含成人色情内容的广告。
- medium -- 返回内容健康和内容不健康的广告(如赌博或处方药广告)。不返回包含成人色情内容的广告。
示例:&adsafe=high
adtest
(String) 指定此次是否是测试性质的实施。可能的值为“on”或“off”。如果设置为“on”,AFV 帐户中将不会记录展示次数和点击次数。在测试过程中必须使用该参数。如果未设置任何值,则默认为“off”。
值:
- off --(默认)所有广告都将照常结算。这是实际生产中应该使用的设置。
- on -- 此设置适合在测试过程中使用,可确保所有广告都不会记录展示次数或点击次数。
示例:&adtest=on
videoad_start_delay
(Integer) 广告开始展示时视频播放的毫秒数。默认设置为中贴片广告的值(具体而言,就是设置为“1”)。
值:
- -1 -- 指定在内容播放完毕时展示的后贴片广告
- 0 -- 指定在内容开始播放之前展示的前贴片广告
- 任意正整数 -- 指定在内容播放此毫秒数后展示的中贴片广告。
示例:
- &videoad_start_delay=-1 -- 后贴片广告。
- &videoad_start_delay=15000 -- 广告将在内容播放 15 秒后展示。
cust_age
(Integer) 指定用户的年龄。支持精确年龄以及 com.google.ads.ima.api.Demographics 中定义的年龄段。
示例:
- &cust_age=1001 -- 18 至 24 周岁
- &cust_age=38 -- 38 周岁
cust_gender
(Integer) 根据 com.google.ads.ima.api.Demographics 中定义的年龄段。
值:
- 1 -- 男性
- 2 -- 女性
示例:
- &cust_gender=1 -- 男性
- &cust_gender=2 -- 女性
host
(String) 进行三方收益分成时要用到的托管方 ID。
示例:&host=ca-host-test -- 与此托管方共分收入。
h_ch
(String) 一个以加号分隔的字符串列表,表示 AdSense 为托管方定位/报告的渠道 ID。
示例:&h_ch=channel1+channel2+channel3 -- 为托管方报告和定位这些额外渠道。
ht_id
(Number) 用于指定发布商和托管方之间收入分成级别的层 ID。
示例:&ht_id=2 -- 第 2 层主机。
hl
(String) 语言代码,用于请求使用该语言的广告。可以是任意 ISO 639-1(两个字母)或 ISO 639-2(三个字母)代码。有效代码列表。
示例:
- &hl=en -- 英语。
- &hl=es -- 西班牙语。
max_ad_duration
(Integer) 指定必须返回的视频长度上限(以毫秒为单位)。 如果未设置,则默认设置为 100 秒。
示例:&max_ad_duration=30000 -- 任何不可跳过的广告的持续时间不得超过 30 秒。
min_ad_duration
(Integer) 指定必须返回的视频长度下限(以毫秒为单位)。如果不设置,则默认为 0 秒。
示例:
- &min_ad_duration=15000 -- 返回的不可跳过的广告必须至少持续 15 秒。
- &min_ad_duration=0 -- 广告持续时间将仅受到 max_ad_duration 值的限制。
sdmax
(Integer) 指定可跳过广告的视频长度上限(以毫秒为单位)。如果不设置,则默认为无限制。
示例:&sdmax=120000 -- 返回的可跳过广告的持续时间不得超过 2 分钟。
overlay
(Integer) 用于限制所请求的重叠式广告尺寸,仅允许非线性的、下三分之一幅重叠式广告。此参数的默认设置是无限制。
示例:
- &overlay=1 -- 只有下三分之一幅重叠式广告尺寸才可以出现在广告请求中。全幅重叠式广告不会作为请求对象。
- &overlay=0 -- 默认值,此时不会对重叠式广告尺寸设置任何限制。重叠式广告尺寸将以 AdsRequest.nonLinearAdSlotWidth 和 adsRequest.nonLinearAdSlotHeight 作为投放依据。