通知

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

搜索广告

自定义搜索广告参数说明

我们在此列出当前支持的搜索广告样式参数,供有经验的高级用户参考。您在 AdSense 中生成的代码将包含所有最常用的参数设置。其中有两个参数为必需参数:pubIdquery。AdSense 会提供 pubId 参数,但您仍须手动修改代码,为 query 参数传递一个值。所有其他参数都是可选的,下文进行了具体介绍。

参数类型

参数分为以下两种类型:

以下是代码生成器的一段示例输出,其中包含两个广告展示区域。要配置这段代码,您必须在 pageOptions 的参数对应关系中设置必需参数 query(例如,“query”: myQuery)。完成这一步后,您便可以开始展示广告。您还可以在网页级代码块中设置可选的网页级参数,以及在 adblock1adblock2 的参数对应关系中设置各个单元级参数。

<div id="afscontainer1"></div>
<div id="afscontainer2"></div>

<script type="text/javascript" charset="utf-8">

  // 网页级参数
  var pageOptions = {
    "pubId": "partner-pub-1234567891234567",
    "styleId": "1234567890",
    "query": myQuery,
  };

  // 单元级参数
  var adblock1 = {
    "container": "afscontainer1"
  };

  var adblock2 = {
    "container": "afscontainer2"
  };

  _googCsa('ads', pageOptions, adblock1, adblock2);

</script>

网页级参数说明

这些参数只需为每个网页指定一次。它们会影响相应网页上的所有广告单元。

必需参数

参数 说明与示例
adPage 当用户导航到下一个结果页或上一个结果页时为必需参数

adPage 参数用于指定显示广告的结果页。当用户的浏览范围超出搜索结果第一页时,此参数就会派上用场。例如,如果系统请求了五个广告,并且 adPage 参数设置为“2”,那么返回的广告将会是第二页对应的五个广告。

pubId 必需参数
这是您的 AdSense Client-ID。pubId 是 Client-ID 中“partner-”之后的部分。例如,如果您的 Client-ID 为“partner-test-property”,则您的 pubId 为“test-property”。这是针对自定义搜索广告的标准书写方式。

示例:

'pubId' : 'test-property'
query 必需参数
这是由用户输入的搜索查询。该查询参数的值应采用未编码格式。

示例:

'query' : 'flowers'

'query' : 'black & decker'

'query' : myQuery // 其中 myQuery 是包含搜索查询的 JavaScript 变量

resultsPageBaseUrl 当网页上存在相关搜索单元时为必需参数
用于指定基础搜索结果页的网址。用户当前的搜索查询是该结果页上的一个相关搜索字词,用户通过点击该字词进入了当前结果页。除了系统自动附加的搜索查询,resultsPageBaseUrl 还可包含自己的参数。

示例:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

styleId 必需参数
用于指定要为网页上的广告单元或相关搜索单元采用的搜索广告样式的 ID。详细了解如何使用搜索广告样式。请注意,为请求设置 styleId 后,广告或相关搜索单元将使用相应样式呈现,而忽略原来的样式设置参数。如果请求中未指定 styleId,则将呈现系统默认样式。

示例

'styleId': '1234567890'

可选参数

参数 说明与示例
linkTarget 可选参数
用于指定点击广告时是在同一窗口中打开,还是在新窗口中打开。默认值为“_top”。此参数也可以在单元级别使用。
  • _top:在同一窗口中打开。
  • _blank:在新窗口中打开。

示例:

'linkTarget' : '_blank'
maxTermLength 可选参数
用于指定相关搜索字词的最大字符数(包括空格)。如果未设置,则没有上限。

示例:

'maxTermLength' : 50
referrerAdCreative 可选参数
如果用户通过点击其他网站上的广告或链接到达您网站中包含“内容相关搜索”单元的内容页面,并且该广告或链接亦在您的控制之下,则应将此参数设置为该广告或链接的文案(需与相应文案一字不差)。

使用此参数时需遵循以下准则:

  • 该参数应仅在“内容相关搜索”请求中提供;如果是其他请求,系统一律会忽略该参数。
  • 该参数应该仅用于您有意从其他网站获取的流量,而不得用于自然流量。
  • 该参数可以包含广告或链接文案的标题行和/或内容描述。
  • 该参数不区分大小写。
  • 该参数可接受有效的 UTF-8 编码;支持 Unicode 字符/变音符号。
  • Google 可能会使用或忽略您提交的这一参数;使用时,该参数可能会影响字词的选择和排名。

示例:

'referrerAdCreative': '与植牙相关的广告搜索'
'referrerAdCreative': '银屑病关节炎的早期症状'
resultsPageQueryParam 可选参数
用于指定搜索结果页上的搜索查询对应的网址参数的名称。如果未指定,则默认为“q”。

示例:

'resultsPageQueryParam' : 'query'
terms 可选参数
借助此参数,您可以通过列表的形式提供您自己的相关搜索字词(不同字词间以英文逗号分隔),以供在相关搜索请求中返回,但 Google 不一定会使用此参数提供的字词。

示例:

'terms' : '汽车租赁, 机票'

配置设置

参数 说明与示例
adsafe 可选参数
用于指定 Google 应对符合搜索查询条件的广告应用的过滤规则。以下是 adsafe 可使用的有效设置值以及每个值对返回的广告的影响:
  • high:返回内容健康的广告。不返回内容不健康或包含成人色情内容的广告。
  • medium:返回内容健康的广告和内容不健康的广告。不返回包含成人色情内容的广告。
  • low:返回所有类型的广告。
注意:默认情况下,adsafe 将设置为“high”。

示例:

'adsafe': 'medium'
adtest 可选参数
adtest 参数用于表示某个广告请求是否为测试。当 adtest 参数的值为“on”时,Google 会将相应请求视为测试,既不将其计入广告展示次数,也不跟踪其点击结果。

adtest 参数的值为“on”时,您不会获得任何收入。

注意:这个参数只适合在测试时使用,而不能用于实际投放广告的系统,否则您就算展示了广告也不会获得任何收入。

adtest 的默认值是“off”。

示例:

'adtest' : 'on'
channel 可选参数
您可以添加 AdSense 搜索广告渠道,以跟踪不同网页的效果。请使用您在 AdSense 账号中创建的唯一渠道 ID。详细了解如何使用自定义渠道跟踪广告效果

不同渠道之间应用“+”号分隔。
 

示例:

'channel' : 'testA'
'channel' : 'testA+testB'
hl 可选参数
此参数用于指定所请求的广告应定位的语言。默认值为“en”。

Google 支持所有 Google Ads API 语言代码

注意:广告所定位的语言由相应广告客户指定。如果您在请求中包含此参数,Google 将仅返回定位到所指定的语言或定位到所有语言的广告,但 Google 不保证其广告文字也采用所指定的语言。

一般情况下,您应当将 hl 参数设置为发送此参数的网页所使用的主要语言。

示例:

'hl' : 'es'
ie 可选参数

ie 参数用于设置解析查询字符串时应采用的字符编码方案。

ie 的默认值为“utf-8”。

标准名称 支持的相关语言
latin1 ISO-8859-1 西欧语言(加泰罗尼亚语、丹麦语、荷兰语、英语、芬兰语、法语、德语、印度尼西亚语、意大利语、挪威语、葡萄牙语、西班牙语、瑞典语)
latin2 ISO-8859-2 东欧语言(克罗地亚语、捷克语、匈牙利语、波兰语、罗马尼亚语、塞尔维亚语、斯洛伐克语、斯洛文尼亚语)
latin3 ISO-8859-3  
latin4 ISO-8859-4 波罗的语(爱沙尼亚语、拉脱维亚语、立陶宛语)
cyrillic ISO-8859-5 保加利亚语、俄语
arabic ISO-8859-6  
greek ISO-8859-7 希腊语
hebrew ISO-8859-8 希伯来语
latin5 ISO-8859-9  
latin6 ISO-8859-10 冰岛语
euc-jp EUC-JP 日语
euc-kr EUC-KR 韩语
sjis Shift_JIS 日语
big5 Big5 繁体中文
gb GB2312 简体中文
utf-8 UTF-8 所有语言
oe 可选参数

oe 参数用于设置 Google 对广告文字进行编码时应采用的字符编码方案。虽然从技术方面来说这一参数是可选的,但您最好为其传递一个值。

oe 的默认值为“utf-8”。

标准名称 支持的相关语言
latin1 ISO-8859-1 西欧语言(加泰罗尼亚语、丹麦语、荷兰语、英语、芬兰语、法语、德语、印度尼西亚语、意大利语、挪威语、葡萄牙语、西班牙语、瑞典语)
latin2 ISO-8859-2 东欧语言(克罗地亚语、捷克语、匈牙利语、波兰语、罗马尼亚语、塞尔维亚语、斯洛伐克语、斯洛文尼亚语)
latin3 ISO-8859-3  
latin4 ISO-8859-4 波罗的语(爱沙尼亚语、拉脱维亚语、立陶宛语)
cyrillic ISO-8859-5 保加利亚语、俄语
arabic ISO-8859-6  
greek ISO-8859-7 希腊语
hebrew ISO-8859-8 希伯来语
latin5 ISO-8859-9  
latin6 ISO-8859-10 冰岛语
euc-jp EUC-JP 日语
euc-kr EUC-KR 韩语
sjis Shift_JIS 日语
gb GB2312 简体中文
utf-8 UTF-8 所有语言
personalizedAds 可选参数
用于指定用户是否同意发布商出于投放个性化广告的目的与 Google 分享他们的个人信息。
  • true:返回通过查询定位的广告以及一些可通过用户的 Google Cookie 定位的广告。如果用户位于欧盟境内,则用户必须先同意您的网站出于投放个性化广告的目的与 Google 分享他们的个人信息。
  • false:仅返回通过查询定位的广告。在这种情况下,系统不会返回任何通过用户的 Google Cookie 定位的广告。如果用户不同意您的网站出于投放个性化广告的目的与 Google 分享他们的个人信息,那么您必须将该值设置为 false。
注意:默认情况下,personalizedAds 将设置为“true”。

示例:

'personalizedAds': false

单元级参数说明

这些参数会影响网页上个别广告单元面向用户的展示方式,您可以单独为每个广告单元设置各项参数。

必需参数

参数 说明与示例
container 必需参数
作为广告展示位置的空广告容器(以 <div id='afscontainer1'></div> 表示)的 ID。

示例:

'container' : 'afscontainer1'
maxTop 必需参数

此参数用于指定要在顶部广告单元中展示的广告的数量。

注意:此参数可用于替代 number 参数。此广告单元必须足够宽,以免广告的第一行发生换行。在网页的任何其他展示位置使用 maxTop 参数都属于违规行为。

示例:

'maxTop' : 4
width 必需参数
用于指定广告单元或相关搜索单元的宽度(以像素为单位)。

示例:

'width' : '700px'
'width' : 700

配置设置

参数 说明与示例
adLoadedCallback 可选参数
用于指定要在加载了广告或相关搜索时或在未提供任何广告或相关搜索时调用的 JavaScript 函数。该参数应设为您实现的 JavaScript 回调函数,以便在广告调用完成时执行某个操作。

该回调函数采用以下参数:

containerName 广告单元或相关搜索单元的容器名称。
adsLoaded 如果至少有一个广告或相关搜索字词可供显示,则设为 true;如果没有返回广告或相关搜索,则设为 false。
isExperimentVariant 如果正在运行自定义样式实验,并且选择使用此实验的变体来呈现广告,则设为 true。
callbackOptions 是一个包含以下字段的 JSON 对象:

termPositions:对于相关搜索展示区域,该字段将包含发布商所提供字词相对于它们在响应中零索引位置的 map<string,int>。如果发布商提供的某个字词未在响应中返回,那么该字词就不会出现在该位置对应关系中。

注意:请测试您的回调函数,以确保它不会产生任何错误,尤其是那些可能会干扰网页加载的错误。

JavaScript 回调示例:

var adblock1 = {
  'container' : 'adblock1_div_id',
  'adLoadedCallback' : function(containerName, adsLoaded,
    isExperimentVariant, callbackOptions) {
    if (adsLoaded) {
       try {
         // 很可能不执行任何操作
       } catch (e) {
         alert ("回调函数中存在错误");
         // 执行某些操作,以妥善处理错误
       }
    } else {
       // 采用 Google 无法提供任何广告时的一贯做法
    }
  }
};
number 可选参数
此广告单元中应展示的广告数量。默认值为“2”。

示例:

'number' : 4
relatedSearches 可选参数
此相关搜索单元中应展示的相关搜索数量。除非将此参数的值设置为零,否则它至少会返回三个相关搜索。如果未指定,则默认为 0。

示例:

'relatedSearches' : 4

该内容对您有帮助吗?

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