Web 实现

注意:无论网页上有多少条广告,每个网页上只能发出一次广告请求。

重要提示:请先阅读条款及条件,然后再使用此代码

要使用此代码,您必须拥有 AdSense 帐号且具备有效权限,才能使用 AdSense 自定义搜索广告。

概览

在您的网站上实施 AdSense 自定义搜索广告的过程分为 3 步:

第 1 步:在 AdSense 中创建自定义搜索广告样式

登录后,展开搜索广告,然后点击搜索广告样式。在这里,您可以创建一个新样式或更新现有样式。

第 2 步:配置代码

点击获取代码 嵌入。 配置您的广告容器,使其与搜索页上的广告容器相匹配。

第 3 步:实现代码

复制代码生成器中的代码粘贴到您的网页上,同时务必更新 query 参数。应将 head 标记中生成的代码放置在网站的 head 标记中,以便正确加载广告。广告单元 1 的代码将包含页面上所有广告单元的设置。其他广告单元只需在对应的网页上放置相应的广告单元 <div>

代码生成器中提供了最常用的功能,但“参考”部分中还提供了一些其他参数。“参考”部分包含所有网页级选项(适用于网页上的所有广告单元),以及所有广告单元级选项(适用于单个广告单元)。

示例代码

异步加载广告

生成的代码是异步生成的。下面展示了异步广告加载的完整示例。您可以在新标签页中打开此示例。请务必输入您自己的客户端 ID。

<html>
<head>

<script async="async" src="https://www.google.com/adsense/search/ads.js"></script>

<script type="text/javascript" charset="utf-8">
  (function(g,o){g[o]=g[o]||function(){(g[o]['q']=g[o]['q']||[]).push(
  arguments)},g[o]['t']=1*new Date})(window,'_googCsa');
</script>

</head>

<body>

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

var pageOptions = {
  'pubId' : 'test client ID', // Enter your own client-ID here
  'query' : 'flowers', // User query for this page
  'styleId': '7824176615' // Enter your own style ID here
};

var adblock1 = {
  'container' : 'afscontainer1',
  'width' : 700
};

var adblock2 = {
  'container' : 'afscontainer2',
  'width' : 700
};

_googCsa('ads', pageOptions, adblock1, adblock2);
</script>

<p>Search result 1</p>
<p>Search result 2</p>
<p>Search result 3</p>

<div id="afscontainer2"></div>
</body>
</html>

“相关搜索”是一个自然搜索单元,其中包含与当前搜索字词相关的搜索字词。此单元上的链接会转到新的搜索结果页。

<html>
<head>

<script async="async" src="https://www.google.com/adsense/search/ads.js"></script>

<script type="text/javascript" charset="utf-8">
  (function(g,o){g[o]=g[o]||function(){(g[o]['q']=g[o]['q']||[]).push(
  arguments)},g[o]['t']=1*new Date})(window,'_googCsa');
</script>

</head>

<body>

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

var pageOptions = {
  'pubId': 'test client ID', // Enter your own client-ID here
  'query': 'flowers', // User query for this page
  'styleId': '1234567890', // Enter your own style ID here
  'resultsPageBaseUrl': '//www.example.com/search', // Enter your own base URL here
  'resultsPageQueryParam': 'query' // Enter your own query parameter here
};

var adblock = {
  'container': 'afscontainer1',
  'number': 3,
  'width': 700
};

var rsblock = {
  'container': 'afscontainer2',
  'relatedSearches': 6,
  'width': 500
};

_googCsa('ads', pageOptions, adblock, rsblock);
</script>

<p>Search result 1</p>
<p>Search result 2</p>
<p>Search result 3</p>

<div id="afscontainer2"></div>
</body>
</html>

内容相关搜索针对的是与网页内容相关的用户。 这让用户可以探索与搜索广告或网站导航相关的主题。请勿对内容页上的相关搜索使用“query”参数,因为这会导致意外结果。

<html>
<head>

<script async="async" src="https://www.google.com/adsense/search/ads.js"></script>

<script type="text/javascript" charset="utf-8">
  (function(g,o){g[o]=g[o]||function(){(g[o]['q']=g[o]['q']||[]).push(
  arguments)},g[o]['t']=1*new Date})(window,'_googCsa');
</script>

</head>

<body>

<p>Page content</p>

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

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

var pageOptions = {
  'pubId': 'test client ID', // Enter your own client-ID here
  'relatedSearchTargeting': 'content', // Must use 'content'
  'hl': 'en', // The preferred language for related terms (default to 'en' if not specified)
  'styleId': '1234567890', // Enter your style ID
  'resultsPageBaseUrl': '//www.example.com/search', // Enter the base URL of your results page
  'resultsPageQueryParam': 'query', // Specify the query parameter on your results page
  'terms': 'term a,term b', // Optionally provide your own related terms in a comma-delimited list
  'referrerAdCreative': 'example ad title' // Only used when a user clicked an ad to arrive here
};

var rsblock1 = {
  'container': 'afscontainer1',
  'relatedSearches': 6
};

_googCsa('relatedsearch', pageOptions, rsblock1);
</script>

<p>More page content</p>

</body>
</html>

需要避免的事项

我们建议所有发布商都遵循我们实施 AdSense 自定义搜索广告的准则,并避免某些实现方式可能会干扰广告呈现并导致意外效果或广告效果不佳。

  • 除非是无限滚动实现,否则不要从网页发出多个广告请求
  • 不要在广告呈现之前或之后隐藏广告代码片段
  • 不要在网页中移动广告位置
  • 不要请求超出要在网页上展示的广告块
  • 不要操控广告展示区域中的 DOM
  • 不要实现自己的延迟加载(而是依靠 Google 的延迟加载)
  • 不在您的网站上缓存 Google 的 JS 资源
  • 请不要在内容页的相关搜索中使用“query”参数,因为这会导致意外结果。