注意:在每个网页上只能发出一个广告请求,无论其存在多少个屏蔽规则。
重要提示:请先阅读条款及条件,然后再使用此代码
要使用此代码,您必须拥有 AdSense 帐号且该账号具有使用 AdSense 自定义搜索广告的有效权限。
概览
在您的网站上植入 AdSense 自定义搜索广告需要完成 3 个步骤:
第 1 步:在 AdSense 中创建自定义搜索广告样式
登录后,展开搜索广告,然后点击搜索广告样式。在这里,您可以创建新样式或更新现有样式。
第 2 步:配置代码
点击 Get Code 图标 。 配置您的广告容器,使其与搜索页上的广告容器相匹配。
第 3 步:实现代码
复制代码生成器中的代码并将其粘贴到网页上,同时记得更新 query
参数。应将在 head 标记中生成的代码放在网站的 head 标记中,广告才能正确加载。广告单元 1 的代码将包含页面上所有广告单元的设置。其他广告单元只需在要展示广告的网页上放置相应的广告单元<div>
即可。
示例代码
异步广告加载
生成的代码是异步的。下面是一个完整的异步广告加载示例。您可以在新标签页中打开此示例。请务必输入您自己的 Client-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>
搜索页上的相关搜索
Google 搜索上的相关搜索是一个自然单元,其中包含与当前搜索字词相关的搜索字词。此单元中的链接指向新的搜索结果页。
<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”参数用于内容页上的相关搜索,因为这样会导致意外的结果。