本頁面由 Cloud Translation API 翻譯而成。

網站導入

注意：無論存在多少封鎖條件，每個網頁都只能發出一個廣告請求。

重要事項：使用這個代碼前，請先詳閱條款及細則

如要使用這個程式碼，您必須擁有具備有效權限的 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
  '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>

內容的相關搜尋可為使用者提供與網頁內容相關的搜尋字詞。藉此探索相關主題，與搜尋廣告或網站瀏覽功能互動。請勿使用「查詢」參數，因為這會導致也就是預測結果

注意：Google 必須先檢索確保字詞與內容相關。如果網頁尚未檢索，或禁止檢索 (例如遭到 robots.txt 封鎖) AdSense 檢索器我們不會顯示您提供給 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 clicked an ad to arrive here;
                                           // 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 資源
請勿使用「查詢」參數，否則會導致非預期的結果。

網站導入

總覽

程式碼範例

非同步廣告載入

搜尋網頁上的相關搜尋

內容網頁上的相關搜尋

應避免的事項