通知

请务必访问您的 AdSense 页面,获取根据您的帐号为您量身定制的信息,进而利用 AdSense 取得出色的创收效果。

AdSense 视频广告 (AFV)

适用于 IMA 的 AdSense 视频广告代码参数

与 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 作为投放依据。

 

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
主菜单
17091479853029213253
true
搜索支持中心
true
true
true
true
true
157
false
false