注意：無論網頁上有多少個區塊，每個網頁都只能發出一個廣告請求。
重要事項：使用這組代碼前，請先詳閱條款及細則
如要使用這組程式碼，您必須擁有 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
'relatedSearchTargeting': 'query', // Must use 'query' for Related Search on Search pages
'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」參數，否則會導致非預期的結果。
注意：Google 必須先檢索您的網頁，確保字詞與內容相關，網站才會顯示相關搜尋字詞。如果網頁尚未經過檢索，或遭到 Mediapartners-Google 檢索器封鎖而無法檢索 (例如透過 robots.txt)，我們就不會顯示你提供給 Google 的建議相關搜尋字詞。
內容相關搜尋產品會依賴 Google 的內容檢索系統，為網頁建立索引並產生相關搜尋字詞。如果內容網頁網址包含追蹤變數、使用者 ID、工作階段 ID 或其他動態 ID 等查詢參數，可能會干擾檢索器評估網頁核心內容的能力，並導致相關搜尋字詞不準確或不相關。請使用「ignoredPageParams」參數找出這些非必要參數，確保內容正確建立索引，並減少不必要的檢索負擔。這樣一來，Google 就能更準確地判斷網頁是否已遭檢索，並開始顯示建議字詞 (包括 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>
<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' for Related Search on Content pages
'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 comes from a source you control;
// required when 'terms' is present.
};
var rsblock1 = {
'container': 'afscontainer1',
'relatedSearches': 6
};
_googCsa('relatedsearch', pageOptions, rsblock1);
</script>
<p>More page content</p>
</body>
</html>
應避免的事項
建議所有發布商遵守 AdSense 自訂搜尋廣告的導入指南，並避免使用可能干擾廣告顯示的導入方式，以免導致非預期的結果或成效不彰。
- 除非是無限捲動實作，否則請勿從單一網頁發出多個廣告呼叫
- 請勿在廣告顯示前後隱藏廣告區塊
- 請勿在網頁中移動廣告區塊
- 請求的廣告區塊數量不得超過網頁上要顯示的數量
- 請勿操控廣告區塊的 DOM
- 請勿實作自己的延遲載入功能 (改用 Google 的延遲載入功能)
- 請勿在網站上快取 Google 的 JS 資源
- 請勿在內容網頁的相關搜尋中使用「query」參數，否則會導致非預期的結果。