注意:無論有多少封鎖條件可能存在,每個網頁都只能提出一個廣告請求。
重要事項:使用這組代碼前,請先詳閱《條款及細則》
如要使用此程式碼,您必須擁有具備有效權限的 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」參數,否則會造成非預期的結果。