我们在此列出当前支持的搜索广告样式参数，供有经验的高级用户参考。您在 AdSense 中生成的代码将包含所有最常用的参数设置。其中有两个参数为必需参数：pubId 和 query。AdSense 会提供 pubId 参数，但您仍须手动修改代码，为 query 参数传递一个值。所有其他参数都是可选的，下文进行了具体介绍。
参数类型
参数分为以下两种类型：
以下是代码生成器的一段示例输出，其中包含两个广告展示区域。要配置这段代码，您必须在 pageOptions 的参数对应关系中设置必需参数 query（例如，“query”: myQuery）。完成这一步后，您便可以开始展示广告。您还可以在网页级代码块中设置可选的网页级参数，以及在 adblock1 和 adblock2 的参数对应关系中设置各个单元级参数。
<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>
<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 |
当用户导航到下一个结果页或上一个结果页时为必需参数
|
pubId |
必需参数 这是您的 AdSense Client-ID。pubId 是 Client-ID 中“partner-”之后的部分。例如，如果您的 Client-ID 为“partner-test-property”，则您的 pubId 为“test-property”。这是针对自定义搜索广告的标准书写方式。 示例： 'pubId' : 'test-property' |
query |
必需参数 这是由用户输入的搜索查询。该查询参数的值应采用未编码格式。 示例：
|
resultsPageBaseUrl |
当网页上存在相关搜索单元时为必需参数 用于指定基础搜索结果页的网址。用户当前的搜索查询是该结果页上的一个相关搜索字词，用户通过点击该字词进入了当前结果页。除了系统自动附加的搜索查询， resultsPageBaseUrl 还可包含自己的参数。
示例：
|
styleId |
必需参数 用于指定要为网页上的广告单元或相关搜索单元采用的搜索广告样式的 ID。详细了解如何使用搜索广告样式。请注意，为请求设置 styleId 后，广告或相关搜索单元将使用相应样式呈现，而忽略原来的样式设置参数。如果请求中未指定 styleId，则将呈现系统默认样式。 示例
|
可选参数
| 参数 | 说明与示例 |
|---|---|
linkTarget |
可选参数 用于指定点击广告时是在同一窗口中打开，还是在新窗口中打开。默认值为“_top”。此参数也可以在单元级别使用。
示例： 'linkTarget' : '_blank' |
maxTermLength |
可选参数 用于指定相关搜索字词的最大字符数（包括空格）。如果未设置，则没有上限。 示例： 'maxTermLength' : 50 |
referrerAdCreative |
可选参数 如果用户通过点击其他网站上的广告或链接到达您网站中包含“内容相关搜索”单元的内容页面，并且该广告或链接亦在您的控制之下，则应将此参数设置为该广告或链接的文案（需与相应文案一字不差）。 使用此参数时需遵循以下准则：
示例： 'referrerAdCreative': '与植牙相关的广告搜索''referrerAdCreative': '银屑病关节炎的早期症状' |
resultsPageQueryParam |
可选参数 用于指定搜索结果页上的搜索查询对应的网址参数的名称。如果未指定，则默认为“q”。 示例： 'resultsPageQueryParam' : 'query' |
terms |
可选参数 借助此参数，您可以通过列表的形式提供您自己的相关搜索字词（不同字词间以英文逗号分隔），以供在相关搜索请求中返回，但 Google 不一定会使用此参数提供的字词。 示例： 'terms' : '汽车租赁, 机票' |
配置设置
| 参数 | 说明与示例 | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
可选参数 用于指定 Google 应对符合搜索查询条件的广告应用的过滤规则。以下是 adsafe 可使用的有效设置值以及每个值对返回的广告的影响：
注意：默认情况下，
adsafe 将设置为“high”。示例： 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
可选参数adtest 参数用于表示某个广告请求是否为测试。当 adtest 参数的值为“on”时，Google 会将相应请求视为测试，既不将其计入广告展示次数，也不跟踪其点击结果。
当 注意：这个参数只适合在测试时使用，而不能用于实际投放广告的系统，否则您就算展示了广告也不会获得任何收入。
adtest 的默认值是“off”。 示例： 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
可选参数 您可以添加 AdSense 搜索广告渠道，以跟踪不同网页的效果。请使用您在 AdSense 账号中创建的唯一渠道 ID。详细了解如何使用自定义渠道跟踪广告效果。 不同渠道之间应用“+”号分隔。 示例： 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
可选参数 此参数用于指定所请求的广告应定位的语言。默认值为“en”。 Google 支持所有 Google Ads API 语言代码。 注意：广告所定位的语言由相应广告客户指定。如果您在请求中包含此参数，Google 将仅返回定位到所指定的语言或定位到所有语言的广告，但 Google 不保证其广告文字也采用所指定的语言。
一般情况下，您应当将 示例： 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
可选参数
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
可选参数
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
可选参数 用于指定用户是否同意发布商出于投放个性化广告的目的与 Google 分享他们的个人信息。
注意：默认情况下，
personalizedAds 将设置为“true”。示例： 'personalizedAds': false |
单元级参数说明
这些参数会影响网页上个别广告单元面向用户的展示方式，您可以单独为每个广告单元设置各项参数。
必需参数
| 参数 | 说明与示例 |
|---|---|
container |
必需参数 作为广告展示位置的空广告容器（以 <div id='afscontainer1'></div> 表示）的 ID。
示例： |
maxTop |
必需参数
此参数用于指定要在顶部广告单元中展示的广告的数量。 注意：此参数可用于替代
number 参数。此广告单元必须足够宽，以免广告的第一行发生换行。在网页的任何其他展示位置使用 maxTop 参数都属于违规行为。示例： |
width |
必需参数 用于指定广告单元或相关搜索单元的宽度（以像素为单位）。 示例： 'width' : '700px''width' : 700 |
配置设置
| 参数 | 说明与示例 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
可选参数 用于指定要在加载了广告或相关搜索时或在未提供任何广告或相关搜索时调用的 JavaScript 函数。该参数应设为您实现的 JavaScript 回调函数，以便在广告调用完成时执行某个操作。 该回调函数采用以下参数：
注意：请测试您的回调函数，以确保它不会产生任何错误，尤其是那些可能会干扰网页加载的错误。
JavaScript 回调示例： var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // 很可能不执行任何操作 } catch (e) { alert ("回调函数中存在错误"); // 执行某些操作，以妥善处理错误 } } else { // 采用 Google 无法提供任何广告时的一贯做法 } } }; |
||||||||
number |
可选参数 此广告单元中应展示的广告数量。默认值为“2”。 示例： |
||||||||
relatedSearches |
可选参数 此相关搜索单元中应展示的相关搜索数量。除非将此参数的值设置为零，否则它至少会返回三个相关搜索。如果未指定，则默认为 0。 示例： 'relatedSearches' : 4 |
