我們為進階使用者提供了這份現行搜尋樣式參數清單。您在 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 |
必要 這是使用者輸入的搜尋查詢。查詢參數的值需未經編碼。 範例:
|
resultsPageBaseUrl |
網頁上有相關的搜尋單元時,即為必要參數 用來指定搜尋查詢是使用者所按下相關搜尋字詞的搜尋結果網頁網址。 resultsPageBaseUrl 可以包含本身的參數,但自動附加的搜尋查詢除外。
範例:
|
styleId |
必要 用來指定網頁上廣告或相關搜尋單元所要套用搜尋樣式的 ID。進一步瞭解如何使用搜尋樣式。請注意,如果已為要求設定 styleId,系統將以該樣式顯示廣告或相關搜尋,並略過舊有的樣式參數。如未在要求中指定 styleId,則會顯示系統預設樣式。 範例
|
選用
參數 | 說明與範例 |
---|---|
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' |
配置設定
參數 | 說明與範例 | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 |
選用 用來指明使用者是否已同意允許發布商與 Google 共用個人資訊,以用於個人化廣告。
注意:
personalizedAds 預設為「true」。範例: 'personalizedAds': false |
單元層級參數說明
這些參數會影響網頁上個別廣告單元向使用者呈現的方式,您可以分別為每個廣告單元設定各項參數。
必要
參數 | 說明與範例 |
---|---|
container |
必要 要顯示廣告的空廣告容器 ID <div id='afscontainer1'></div> 。
範例:
|
maxTop |
必要
使用這個參數來指定要在頂端廣告單元顯示的廣告數目。 注意:此參數可用來取代
number 參數。廣告單元的寬度必須足以完整容納廣告第一行的文字,避免發生換行的情形。在網頁上任何其他刊登位置使用 maxTop 參數都算違反政策規定。範例:
|
width |
必要 用來指定廣告單元或相關搜尋單元的寬度 (以像素為單位)。 範例: 'width' : '700px' 'width' : 700 |
配置設定
參數 | 說明與範例 | ||||||||
---|---|---|---|---|---|---|---|---|---|
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 無法以廣告覆蓋時採取的一貫做法 } } }; |
||||||||
number |
選用 此廣告單元中顯示的廣告數目。預設值為「2」。 範例:
|
||||||||
relatedSearches |
選用 這個單元中顯示的相關搜尋次數。除非設為零,否則這個參數會傳回至少三個相關搜尋。若未指定,預設會使用 0。 範例: 'relatedSearches' : 4 |