參考資料

adPage 參數會指定要顯示廣告的結果頁面。當使用者已經離開搜尋結果的第一頁時，即會使用此參數。舉例來說，如果廣告請求數量為 5 則廣告，且 adPage 參數設為 2，則傳回的廣告會是第 5 則廣告的第二頁。

範例：

'pubId' : 'test-property'

注意：在內容網頁的相關搜尋中使用這個參數會導致 非預期的結果

範例：

'query' : 'flowers'

'query' : 'black & decker'

'query' : myQuery // myQuery is a variable containing the search query

範例：

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

• 'content' 這個選項適用於內容網頁上的相關搜尋 (例如文章、 網誌文章)。
• 'query'這個選項必須專門用於相關搜尋 搜尋結果網頁

注意：relatedSearchTarget 網頁參數會自動設為 「query」根據預設。不過請注意，特別指定這個預設值 只供搜尋結果網頁使用 (「Google 搜尋上的相關搜尋」)。如果您是 在任何其他類型網頁 (例如文章、網誌文章) 使用相關搜尋時，您必須遵守 明確將參數設為「content」

注意：使用這個參數時必須遵守下列規範：

• 特定相關的搜尋功能是否可能會啟用或停用，具體取決於 網頁參數。
• 不實陳述網頁類型或依賴預設的「查詢」調整 非搜尋結果網頁上的相關搜尋指定參數視為違反 這些書面指示
• 無論這個值是否設定，Google 都會定期驗證這個值的準確度 您可以手動或使用預設設定

範例：

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

範例：

'styleId': '1234567890'

• '_top' 會在同一個視窗中開啟，
• '_blank' (在新視窗中開啟)。

範例：

'linkTarget' : '_blank'

範例：

'maxTermLength' : 50

使用這個參數時必須遵守下列規範：

• 這個參數只應在「內容相關搜尋」要求中提供，且 將忽略其他要求
• 只能用於您刻意從其他來源取得的流量 而非自然流量
• 這項指令應包含廣告的標題行、說明和/或任何其他字詞。 連結廣告素材。
• 省略廣告或連結廣告素材中的值 (或加入其他值)， 違反這些書面指示。
• 不須區分大小寫。
• 接受有效的 UTF-8 編碼。支援萬國碼 (Unicode) 字元 / 變音符號。
• Google 可能會使用或忽略您提交的參數。使用時可能會影響所選項目 搜尋字詞和排名

注意：使用 terms 參數。

範例：

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'

範例：

'resultsPageQueryParam' : 'query'

注意：使用這個參數時，referrerAdCreative 也 必要 和 relatedSearchTargeting 是必要項目，必須設定 「content」

範例：

'terms' : 'cars rental, flight ticket'

注意：Google 必須先 檢索網頁，確保字詞與內容相關。尚未載入網頁時 遭到檢索或禁止檢索 (例如遭到 robots.txt 封鎖)， AdSense 檢索器 我們不會顯示您提供給 Google 的建議相關搜尋字詞。

「內容的相關搜尋」產品依賴 Google 的內容檢索系統來建立索引 產生相關的搜尋字詞包含查詢參數的內容網頁網址 因為追蹤變數、User-ID、工作階段 ID 或其他動態 ID 檢索器評估網頁核心內容的能力，可能造成錯誤 不相關的相關搜尋字詞。這個網頁參數會指示 Google 檢索器忽略 這些非必要參數，確保內容索引正確，並減少不必要的檢索 載入。這種做法可讓 Google 更準確地辨識已檢索並啟動的網頁 顯示 Google 和合作夥伴的建議字詞 (如果符合資格)。

使用這個參數時必須遵守下列規範：

• 這個參數只應在「內容相關搜尋」要求中提供，且 將忽略其他要求
• 這個參數的值應該是以半形逗號分隔的網址參數清單， 會在使用者瀏覽內容頁面時顯示。
• 須區分大小寫。
• 將這份清單中的網址參數從內容網頁網址中移除後， 而不影響網頁的內容、外觀或使用者體驗。
• 加入對網頁內容、外觀或 使用者體驗視同違反這些書面指示。
• Google 可能會定期驗證忽略提供的網址參數是否影響。

範例：
使用者造訪內容網頁，且網址為：

http://example.com/content?utm_medium=social&page_id=123&click_id=456

'ignoredPageParams' : 'utm_medium,click_id,session_ref'

http://example.com/content?page_id=123

• 'high' 傳回闔家適用廣告，不會傳回非闔家皆宜或成人色情內容的廣告。
• 'medium' 傳回闔家適用和非闔家適用的廣告，不會傳回成人色情內容的廣告。
• 'low' 傳回所有類型的廣告。

adsafe 預設為「高」。

範例：

'adsafe': 'medium'

如果 adtest 參數的值設為 on，您不會獲得任何收益。

如果廣告請求的 adtest 參數設為 on，而且來自尚未 在「網站」分頁中獲得核准的網域，則會傳回顯示「測試廣告」的廣告而且無法點擊

這個參數僅供測試，不得用於正式系統，否則就算刊登了廣告也不會為您帶來任何收益。

adtest 預設值是 off。

範例：

'adtest' : 'on'

範例：

'channel' :  'testA'  

'channel' :  'testA+testB'  

Google 支援所有 AdWords API 語言代碼。

注意：廣告的指定語言是由廣告客戶自行設定的。如果您在要求中加入此參數，Google 只會傳回指定該語言 (或所有語言) 的廣告，但不能保證廣告文字一定是以指定語言撰寫。

一般來說，您應該將 hl 參數設為傳送此參數的網頁主要語言。

範例：

'hl' : 'es'

ie 參數會設定用來解讀查詢字串的字元編碼配置。

ie 的預設值為 utf-8。

oe 參數設定了 Google 用來為廣告文字編碼的字元編碼配置。儘管嚴格說來，此參數並非必要，但建議您最好還是設定一個值。

oe 的預設值為 utf-8。

• true如果這個參數不存在，或是您設為「true」我們會設定偵測無效流量專用的 Cookie，並只針對已取得同意聲明的流量使用本機儲存空間。
• false 如果您將這個參數設為「false」我們會設定偵測無效流量專用的 Cookie，並將本機儲存空間用於已同意和未同意的流量。

無效流量預設為 true

範例：

'ivt': false

範例：

'container' : 'afscontainer1'

使用這個參數來指定要在頂端廣告單元顯示的廣告數量。

注意：此參數用於取代「number」參數。這個廣告單元 應夠寬，這樣廣告第一行就不會換行。使用 maxTop 參數都違反政策。

範例：

'maxTop' : 4

範例：

'width' : '700px'

'width' : 700

回呼函式採用下列參數：

注意：請測試回呼函式，確保不會產生任何錯誤。 尤其是可能幹擾網頁載入的因素

JavaScript 回呼範例：

var adblock1 = {
  'container' : 'adblock1_div_id',
  'adLoadedCallback' : function(containerName, adsLoaded,
    isExperimentVariant, callbackOptions) {
    if (adsLoaded) {
       try {
         // most likely do nothing
       } catch (e) {
         alert ("Error in callback function");
         // Do something to handle error gracefully
       }
    } else {
       // as you always do when there is no ad coverage from Google
    }
  }
};
      

範例：

'number' : 4

範例：

'relatedSearches' : 4