參數
網頁層級參數說明
這些參數只需在每個網頁上指定一次。 都會影響網頁上所有單元。
需要
參數 | 說明和範例 |
---|---|
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 網頁參數預設為 自動設為「查詢」。但請特別注意,這個預設值「僅」專為搜尋結果網頁設計 (即搜尋中的相關搜尋)。如果您在任何其他類型的網頁 (例如文章、網誌文章) 使用相關搜尋,請務必將參數明確設為「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 檢索),我們不會顯示您提供給 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 預設值是 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 |