廣告單元和程式碼產生

廣告單元是安裝一段 AdSense 廣告程式碼後所顯示的一組廣告。AdSense Host API 具備您所期望的一切功能,像是建立、刪除、編輯和更新廣告單元,全方位管理廣告單元廣告空間。您也可以產生在網站上顯示廣告所需的廣告程式碼。

廣告單元可定義大小、顏色、字型和角樣式。廣告單元也允許主機建立成效追蹤的管道。這兩種概念說的是不同的情況:前者是在建立廣告單元的過程中定義,後者是在程式碼產生階段時建立。

廣告單元樣式

建立廣告單元時可以自訂以下項目:

  • 大小
  • 類型
  • 自訂樣式:顏色、角和字型
  • 備份選項
  • 行動裝置設定 (WAP)

大小

大小是像 "SIZE_728_90" 這樣的字串,前一個整數代表寬度,後一個整數代表高度。請注意,大小的組合有限,如需最新的清單,請查看 AdSense 網頁介面

範例廣告單元 1 範例廣告單元 2
圖 1:不同的廣告單元大小

類型

您的網頁上可以顯示多種類型的廣告,包括文字廣告、圖像廣告或互動式多媒體廣告。

廣告類型可以包括 TEXTTEXT_IMAGEIMAGELINK。不是所有格式 (大小) 都適用於圖像廣告,如需最新的清單,請查看 AdSense 說明網頁

自訂樣式

自訂樣式會取代廣告單元和顯示廣告的預設顏色、字型和其他美術設計。

"customStyle": {
  "colors": {
    "border": "800040",
    "title": "0000CC",
    "background": "FFFDFD",
    "text": "1F1F1F",
    "url": "008000"
  },
  "corners": "VERY_ROUNDED"
  "font": {
    "family": "ACCOUNT_DEFAULT_FAMILY",
    "size": "ACCOUNT_DEFAULT_SIZE"
  }
}

目前系統無法將已儲存的樣式套用到廣告單元,因此您必須完整定義自訂樣式、角 (SQUARESLIGHTLY_ROUNDEDVERY_ROUNDED)、字型組 (ACCOUNT_DEFAULT_FAMILYADSENSE_DEFAULT_FAMILYARIALTIMESVERDANA) 以及字型大小 (ACCOUNT_DEFAULT_SIZEADSENSE_DEFAULT_SIZESMALLMEDIUMLARGE)。

略圓和極圓角
圖 2:略圓和極圓的角樣式。

備份選項

為了不影響版面配置,您可以指定在 Google 廣告從缺時要顯示的備案,這可以是一塊空白區域、純色或已導入的 HTML 頁面網址。

行動裝置設定

透過行動裝置設定,您可以決定 WAP 裝置中要使用的標記語言、指令碼語言等功能。

瞭解更多

如需更加瞭解這些資源的定義方式,請參閱廣告單元文件說明網頁上的資源表示法。如果要最詳細的解說,請前往 AdSense 說明網頁

程式碼產生

建立廣告單元後,還需要 javascript 程式碼片段才能將廣告顯示在網頁上。程式碼可以由 API 的 getAdCode 方法產生:

GET https://www.googleapis.com/adsensehost/v4.1/accounts/accountId/adclients/adClientId/adunits/adUnitId/adcode

帳戶編號就是發佈商的編號,必須由主機在關聯工作階段,也就是在權杖驗證步驟儲存。

請注意,您必須擁有廣告用戶端編號才能建立廣告單元。顯示多媒體廣告聯播網廣告需要的產品代碼為「AFC」,這個代碼可能已經產生,您可以列出廣告用戶端找出這個廣告用戶端編號。

準備好帳戶編號、廣告用戶端編號和廣告單元的編號,就可以產生程式碼了。AFC 產品包含一個需要放在網頁 HTML 程式碼上的小字串。這段 JavaScript 程式碼看起來像這樣:

<script type="text/javascript"><!--
google_ad_client = "ca-pub-654321";
google_ad_host = "ca-host-pub-7654321";
/* my ad unit */
google_ad_slot = "123456";
google_ad_width = 200;
google_ad_height = 200;
//--></script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js"></script>

請注意,這段程式碼定義了寬度和高度,因此若您調整過大小,必須重新產生程式碼。也請記得,這段程式碼必須儲存在主機端,而非每次曝光就重新產生。

自訂管道

在 AdSense Host API 中,自訂管道 (就是代管自訂管道!) 會在程式碼產生時連結到廣告單元。您可以使用名為 hostCustomChannelId 的選用參數呼叫 getAdCode 方法。這個欄位包含在產生的程式碼中,因此每次將自訂管道加入廣告單元,或從廣告單元中移除時,都必須重新產生。

<script type="text/javascript"><!--
google_ad_client = "ca-pub-654321";
google_ad_host = "ca-host-pub-654321";
google_ad_host_channel = "123456789";
/* my ad unit */
google_ad_slot = "123456";
google_ad_width = 200;
google_ad_height = 200;
//--></script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js"></script>

多個自訂管道可以追蹤一個廣告單元的成效,而一個自訂管道可以追蹤多個廣告單元。

傳送您對下列選項的寶貴意見...

這個網頁
AdSense Host API
AdSense Host API