參數
網頁層級參數說明
這些參數只需在每個網頁中指定一次。 會影響網頁上所有單元。
需要
參數 | 說明和範例 |
---|---|
adPage
|
當使用者前往下一個或上一個結果頁面時,即為必要項目。
|
pubId
|
必要 這是您的 AdSense 用戶端 ID。您的 pubId 是客戶 ID 的一部分,即「partner-」後方的字串。舉例來說,如果您的用戶端 ID 是「partner-test-property」,那麼 pubId 就是「test-property」。這是 CSA 的標準通訊協定。 範例: 'pubId' : 'test-property' |
query
|
必填 (內容網頁上的相關搜尋除外)。 這是使用者輸入的搜尋查詢。查詢參數的值應未經編碼。 注意:在內容網頁的相關搜尋中使用這個參數,會導致非預期的結果。 例如: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // myQuery is a variable containing the search query |
resultsPageBaseUrl
|
如果網頁上有相關搜尋單元,則為必填。 指定搜尋查詢是使用者所按下相關搜尋字詞的搜尋結果網頁網址。resultPageBaseUrl 可能包含本身的參數,但會自動附加的搜尋查詢除外。 範例: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
relatedSearchTargeting
|
如果網頁上有相關搜尋單元,則為必填。 要要求相關搜尋單元時,這個參數為必要。這項功能可依據網頁情境,控管要顯示的相關搜尋體驗類型:
注意:relatedSearchTarget 網頁參數預設會自動設為「query」。不過請務必注意,這個預設值「只」是針對搜尋結果網頁 (「搜尋」上的相關搜尋) 所設計。如要在任何其他類型的網頁 (例如文章、網誌文章) 上使用相關搜尋,則必須明確將參數設為「content」。 注意:使用這個參數時必須遵守下列規範:
例: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId
|
必要 指定要套用至網頁上廣告或相關搜尋單元的自訂搜尋樣式 ID。 進一步瞭解如何使用自訂搜尋樣式。請注意,如果為要求設定 styleId,系統將以該樣式顯示廣告或相關搜尋,並忽略舊版樣式參數。如未在要求中指定 styleId,則會顯示系統預設樣式。 範例: 'styleId': '1234567890' |
選用
參數 | 說明和範例 |
---|---|
linkTarget
|
選用 用來指定獲得點擊的廣告會在同一個視窗還是新視窗中開啟。預設值為「_top」。您也可以在單元層級使用這個參數。
範例: 'linkTarget' : '_blank' |
maxTermLength
|
選用 指定相關搜尋字詞的字元數上限 (含空格)。 如未設定,則無上限。 範例: 'maxTermLength' : 50 |
referrerAdCreative
|
選用 如果使用者在其他網站的廣告或連結後到達內容網頁,其中包含「內容相關搜尋」單元,而該廣告或連結由您控制,就應該將這個參數設為該廣告或連結的廣告素材文字。 使用這個參數時必須遵守下列規範:
注意:使用 範例: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam
|
選用 為搜尋結果網頁上的搜尋查詢指定網址參數的名稱。 如未指定,預設為「q」。 範例: 'resultsPageQueryParam' : 'query' |
terms
|
選用 這個參數可讓您提供要與相關搜尋要求一併傳回的自有相關搜尋字詞清單 (以半形逗號分隔),但 Google 不一定會使用這裡提供的字詞。
注意事項:使用這個參數時, 範例: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
選用 透過「內容相關搜尋」單元指定內容網頁的網址參數清單。您可以在不影響核心內容或使用者體驗的情況下,安全地忽略這些頁面的網址參數。 注意:在顯示相關搜尋字詞之前,Google 必須先檢索您的網頁,確保字詞與內容密切相關。如果 AdSense 檢索器尚未檢索網頁,或是網頁遭到 robots.txt 封鎖 (例如遭到 robots.txt 封鎖),我們就不會顯示您提供給 Google 的建議相關搜尋字詞。 「內容相關搜尋」產品仰賴 Google 的內容檢索系統,為網頁建立索引並產生相關搜尋字詞。如果內容網頁網址含有追蹤變數、使用者 ID、工作階段 ID 或其他動態 ID 等查詢參數,可能會幹擾檢索器評估網頁核心內容的能力,並可能導致不正確或不相關的搜尋字詞。這個網頁參數會指示 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 |
配置設定
參數 | 說明和範例 | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe
|
選用 用來指定 Google 應對符合搜尋查詢的廣告套用的篩選規則。下列為 Adsafe 的有效設定,以及每個值對傳回廣告的影響:
adsafe 預設為高。 範例: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
選用 adtest 參數表示廣告請求為測試性質。如果 adtest 參數的值是 on,Google 會將該請求視為測試,且不會計算廣告曝光次數或追蹤點閱結果。 如果 adtest 參數的值設為 on,您不會獲得任何收益。 如果廣告請求的 adtest 參數設為 on,而且來自尚未 在網站分頁中獲得核准的網域,系統將傳回出現「測試廣告」重疊廣告且無法點擊的廣告。 這個參數僅供測試,不得用於正式系統,否則就算刊登了廣告也不會為您帶來任何收益。 adtest 預設值是 off。 範例: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel
|
選用 您可以加入 AdSense 搜尋廣告管道,追蹤不同網頁的成效。請使用您在 AdSense 帳戶或客戶技術顧問中建立的專屬頻道 ID。如要進一步瞭解頻道,請參閱本文。 如有多個管道,應使用「+」符號分隔。 範例: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl
|
選用 這個參數表示所請求廣告或相關搜尋的指定語言。預設值為 en。 Google 支援所有 AdWords API 語言代碼。 注意:廣告的指定語言是由廣告客戶自行設定的。如果您在要求中加入此參數,Google 只會傳回指定該語言 (或所有語言) 的廣告,但不能保證廣告文字一定是以指定語言撰寫。 一般來說,您應該將 hl 參數設為傳送此參數的網頁主要語言。 範例: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie
|
選用
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
選用
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
選用 這個參數可讓您提供布林值,告知 Google 您要允許廣告針對已取得和未同意的流量,使用偵測無效流量專用的 Cookie 和本機儲存空間。
無效流量預設為 true。 範例: 'ivt': false |
廣告單元層級參數說明
這些參數會影響網頁上的個別廣告單元向使用者呈現的方式,您可以針對每個廣告單元分別設定各項參數。
需要
參數 | 說明和範例 |
---|---|
container
|
必要 要顯示廣告的空白廣告容器 <div> ID。
範例: 'container' : 'afscontainer1' |
maxTop
|
如果廣告單元位於搜尋結果上方,則為必填。 使用這個參數來指定要在頂端廣告單元顯示的廣告數量。 注意:此參數可用來取代「number」參數。這個廣告單元的寬度必須夠寬,這樣廣告第一行就不會換行。在網頁上任何其他刊登位置使用 maxTop 參數都違反政策。 示例: 'maxTop' : 4 |
width
|
必要 用來指定廣告或相關搜尋單元的寬度 (以像素為單位)。 範例: 'width' : '700px' 'width' : 700 |
配置設定
參數 | 說明和範例 | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback
|
選用 指定在載入廣告或相關搜尋,或是未放送任何廣告或相關搜尋時,要呼叫的 JavaScript 函式。此參數應設為您實作的 JavaScript 回呼函式,以便在廣告呼叫完成時執行動作。 回呼函式採用下列參數:
注意事項:請測試回呼函式,確保不會產生任何錯誤,尤其是可能幹擾網頁載入的錯誤。 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
|
選用 這個廣告單元中顯示的廣告數量。預設值為 2。 範例: 'number' : 4 |
||||||||
relatedSearches
|
選用 這個單元中顯示的相關搜尋次數。如未指定,預設值為 0。 範例: 'relatedSearches' : 4 |