本頁面由 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 必須先檢索您的網頁，確保字詞與搜尋字詞相關，才會顯示在您的網站中。如果 AdSense 檢索器尚未檢索網頁，或是網頁遭到 robots.txt 封鎖 (例如遭到 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 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 資源
請勿在內容網頁上使用「相關搜尋」的「query」參數，以免產生非預期的結果。

網站導入

總覽

程式碼範例

非同步廣告載入

搜尋網頁上的相關搜尋

內容網頁上的相關搜尋

應避免的事項