注意：無論有多少封鎖條件可能存在，每個網頁都只能提出一個廣告請求。
重要事項：使用這組代碼前，請先詳閱《條款及細則》
如要使用此程式碼，您必須擁有具備有效權限的 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>
搜尋網頁上的相關搜尋
「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>
應避免的事項
我們建議所有發布商遵循 Google 的 AdSense 自訂搜尋廣告導入指南，並避免採用特定導入方式，以免影響廣告顯示並導致意外結果或成效不盡理想。
- 除非導入無限捲動功能，否則不要從網頁發出多次廣告呼叫
- 請勿在廣告顯示前後隱藏廣告區塊
- 不要將廣告區塊移動到網頁上
- 不要在網頁畫面上顯示更多廣告區塊
- 不得操控廣告區塊的 DOM
- 請勿自行執行延遲載入 (改用 Google 的延遲載入)
- 不要在網站上快取 Google 的 JS 資源
- 請不要在內容網頁上的相關搜尋中使用「query」參數，否則會造成非預期的結果。