參考資料

adPage 參數指明目前顯示廣告的結果頁面。當使用者已經瀏覽過搜尋結果的第一頁之後，系統即會使用這個參數。舉例來說，如果廣告請求數量為 5，且 adPage 參數設為 2，則傳回的廣告會是搜尋結果第二頁的五則廣告。

範例：

'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' 只能在搜尋結果網頁上使用這個選項，顯示相關搜尋。

注意：相關搜尋目標網頁參數預設會自動設為「query」。但請務必注意，這個預設值僅適用於搜尋結果網頁 (搜尋結果網頁相關搜尋)。如果您在任何其他類型的頁面 (例如文章、網誌文章) 上使用相關搜尋，就必須明確將參數設為「content」。

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

• 視這個網頁參數的值而定，某些相關搜尋功能可能會啟用或停用。
• 在非搜尋結果網頁上，如果誤報網頁類型或依賴相關搜尋目標參數的預設「查詢」設定，即視為違反這些書面指示。
• 無論是手動設定或使用預設值，Google 都可能會定期驗證這個值的準確度。

範例：

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

範例：

'styleId': '1234567890'

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

範例：

'linkTarget' : '_blank'

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

• 這個參數只能在有「內容相關搜尋」要求時提供；如果是其他要求，系統一律會略過這個參數。
• 這個參數只能用於您刻意從其他網站導入的流量，不得用於自然流量。
• 這個參數可以包含廣告或連結廣告素材的標題行、說明和/或任何其他文字。
• 如果廣告或連結廣告素材省略值 (或加入其他值)，即視為違反這些書面指示。
• 不須區分大小寫。
• 這個參數接受有效的 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 必須先檢索您的網頁，確保字詞與內容相關，網站才會顯示相關搜尋字詞。如果網頁尚未經過檢索，或遭到 AdSense 檢索器封鎖而無法檢索 (例如透過 robots.txt)，我們就不會顯示您提供給 Google 的建議相關搜尋字詞。

內容相關搜尋產品會依賴 Google 的內容檢索系統，為網頁建立索引並產生相關搜尋字詞。如果內容網頁網址包含追蹤變數、使用者 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 預設為「high」。

範例：

'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 並使用本機儲存空間。

預設 IVT 為 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