我們提供目前支援的搜尋樣式參數清單，供進階使用者參考。您在 AdSense 中產生的程式碼已囊括所有最常用的參數設定，其中有兩個必要的參數：pubId 和 query。AdSense 會提供 pubId 參數，但 query 參數值則需由您自行修改程式碼來傳送。所有其他參數皆為選用，相關說明請參閱下文。
參數類型
參數分成兩種類型：
以下是程式碼產生器的輸出範例，含有兩個廣告區塊。如要設定這段程式碼，請務必在 pageOptions 對應中設定必要的 query 參數 (例如：“query”: myQuery)。只要完成這些設定，就能開始顯示廣告。您也可以在網頁層級區塊中設定選用的網頁層級參數，或是在 adblock1 和 adblock2 對應中設定個別單元層級參數。
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Page level parameters
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Unit level parameters
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
網頁層級參數說明
這些參數只需在每個網頁上設定一次，就會影響網頁上所有單元。
必要
| 參數 | 說明與範例 |
|---|---|
adPage |
使用者前往下一個或上一個結果頁面時，即為必要參數
|
pubId |
必要 此為您的 AdSense 用戶端 ID。您的 pubId 是用戶端 ID 的一部分，即「partner-」後方的字串。舉例而言，如果您的用戶端 ID 為「partner-test-property」，那麼 pubId 就是「test-property」。這是 CSA 的標準通訊協定。 範例： 'pubId' : 'test-property' |
query |
必要 這是使用者輸入的搜尋查詢。查詢參數的值需未經編碼。 範例：
|
referrerAdCreative |
必要 (如果已獲得流量) 如果使用者到達您的內容頁面，而該頁面包含來自您控管的來源 (包括您合作的任何第三方聯播網、服務或聯盟) 的「內容相關搜尋」單元，那麼這個參數應設為該來源的廣告素材文字 (一字不差)。 使用這個參數時必須遵守下列規範：
注意：使用
terms 參數時，必須提供這個參數。範例： 'referrerAdCreative': 'search for ads related to dental implants''referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageBaseUrl |
網頁上有相關的搜尋單元時，即為必要參數 用來指定使用者按下相關搜尋字詞時顯示的搜尋結果網頁網址。 resultsPageBaseUr 可以包含本身的參數，但自動附加的搜尋查詢除外。
範例：
|
styleId |
必要 針對網頁上廣告/相關搜尋單元要套用的搜尋樣式，指定專用的 ID。進一步瞭解如何使用搜尋樣式。如果已對要求設定 styleId，系統將以該樣式呈現廣告或相關搜尋，並略過舊有的樣式參數。如未在要求中指定 styleId，則會顯示系統預設樣式。 範例
|
選用
| 參數 | 說明與範例 |
|---|---|
linkTarget |
選用 用來指定獲得點擊的廣告會在同一個視窗還是新視窗中開啟。預設值為「_top」。您也可以在單元層級使用這個參數。
範例： 'linkTarget' : '_blank' |
maxTermLength |
選用 用來指定相關搜尋字詞的字元數上限 (含空格)。如果未設定，則無上限。 範例： 'maxTermLength' : 50 |
resultsPageQueryParam |
選用 用來為搜尋結果網頁上的搜尋查詢指定網址參數的名稱。若未指定，預設會使用「q」。 範例： 'resultsPageQueryParam' : 'query' |
terms |
選用 這個參數可讓您提供一份清單，當中包含要與相關搜尋要求一併傳回的自有相關搜尋字詞，但 Google 不一定會使用這裡提供的字詞。 範例： 'terms' : 'cars rental, flight ticket' |
配置設定
| 參數 | 說明與範例 | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
選用 用來指定 Google 在比對搜尋查詢時套用至廣告的篩選規則。下列為 adsafe 的有效設定，以及每個值對傳回廣告造成的效果：
注意：
adsafe 預設為「high」。範例： 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
選用adtest 參數用來指明廣告請求僅為測試用途。當 adtest 參數的值為「on」時，Google 會將該請求視為測試，且不會計入廣告曝光或追蹤點閱結果。
如果 注意：
adtest 的預設值是「off」。 範例： 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
選用 您可以加入 AdSense 搜尋廣告管道，以追蹤不同網頁的成效。請使用您在 AdSense 帳戶中產生的不重複管道 ID。進一步瞭解如何使用自訂管道追蹤廣告成效。 如有多個管道，應使用「+」符號來區隔。 範例： 'channel' : 'testA''channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
選用 這個參數表示所請求廣告的指定語言。預設值為「en」(英文)。 Google 支援所有的 Google Ads API 語言代碼。 注意：廣告的指定語言是由廣告客戶自行設定的。如果您在要求中加入此參數，Google 只會傳回指定該語言 (或所有語言) 的廣告，但不能保證廣告文字一定是以指定語言撰寫。
一般來說，您應該將 範例： 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
選用
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
選用
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
已淘汰
注意：廣告個人化功能現已不適用於 AdSense 搜尋廣告。詳情請參閱「AdSense 搜尋廣告和其他搜尋廣告產品使用新的放送網域，並淘汰廣告個人化功能」一文。
|
單元層級參數說明
這些參數會影響網頁上個別廣告單元向使用者呈現的方式，您可以分別為每個廣告單元設定各項參數。
必要
| 參數 | 說明與範例 |
|---|---|
container |
必要 要顯示廣告的空廣告容器 ID <div id='afscontainer1'></div>。
範例： |
配置設定
| 參數 | 說明與範例 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
選用 指定在已載入廣告或相關搜尋，或是沒有放送任何廣告或沒有任何相關搜尋帶出廣告時，要呼叫的 JavaScript 函式。這個參數應設為您導入的 JavaScript 回呼函式，以便在廣告呼叫完成時執行動作。 回呼函式採用下列參數：
注意：請測試回呼函式，確保不會產生任何錯誤，尤其是可能干擾網頁載入的錯誤。
JavaScript 回呼範例： var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // 很有可能什麼動作都不會發生 } catch (e) { alert ("Error in callback function"); // 採取行動來妥當處理錯誤 } } else { // 比照您在 Google 無法以廣告覆蓋時採取的一貫做法 } } }; |
||||||||
maxTop |
選用
使用這個參數來指定要在頂端廣告單元顯示的廣告數目。 注意：此參數可用來取代
number 參數。廣告單元的寬度必須足以完整容納廣告第一行的文字，避免發生換行的情形。在網頁上任何其他刊登位置使用 maxTop 參數都算違反政策規定。範例： |
||||||||
number |
選用 此廣告單元中顯示的廣告數目。預設值為「2」。 範例： |
||||||||
relatedSearches |
選用 這個單元中顯示的相關搜尋次數。除非設為零，否則這個參數會傳回至少三個相關搜尋。若未指定，預設會使用 0。 範例： 'relatedSearches' : 4 |
||||||||
width |
選用 用來指定廣告單元或相關搜尋單元的寬度 (以像素為單位)。 範例： 'width' : '700px''width' : 700 |