AdSense 影片廣告和 AdSense 遊戲廣告所使用的標記結構,與 AdSense 內容廣告大相逕庭。這兩類廣告皆需使用互動式媒體廣告 (IMA) 代碼,且只會在下列情況傳回廣告:呼叫時使用的影片播放器或遊戲啟動程式可整合 Google IMA SDK,且/或支援 VAST 及 VPAID (例如 IMA 轉接程式)。
一般來說,您可以透過 AdSense 影片廣告代碼產生器建立上述代碼。下方提供了一份完整清單,列出您能為這類廣告代碼設定的各種條件。AdSense 影片廣告代碼只需使用幾個必要參數即可放送廣告,但如果您希望收到的廣告回應切合需求,不妨加入幾個自選參數,例如管道 ID、廣告長度上限/下限和語言等等。
IMA 廣告代碼參數 | 必要參數 |
---|---|
ad_type | 是 |
client | 是 |
description_url | 是 - 網址必須經過編碼 |
channel | 否 - 但建議使用 (如果有的話) |
adsafe | 否 - 但建議使用 |
videoad_start_delay | 否 - 但建議使用 |
hl | 否 - 但建議使用 |
max_ad_duration | 否 - 但建議使用 |
min_ad_duration | 否 - 但建議使用 |
sdmax | 否 - 但建議使用 |
adtest | 否 |
cust_age | 否 |
cust_gender | 否 |
host | 否 |
h_ch | 否 |
overlay | 否 |
基本網址
以下網址可當做下面介紹各查詢參數的基本網址:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(字串) 指定所需的廣告類型。應使用底線 (「_」) 連結起來。
值
- video:所有影片廣告,相當於 standardvideo_skippablevideo_bumpervideo。
- skippablevideo:僅限可略過的影片廣告。發佈商可能需要額外的權限,才能接收可略過的廣告。
- bumpervideo:允許前六秒不可略過的影片廣告。
- standardvideo:僅限不可略過的影片廣告。
- image:允許指定非線性版位大小可容納的圖像廣告。
- text:允許文字廣告。
範例
- &ad_type=video_text_image
- 允許所有格式。
- &ad_type=video_text
- 允許所有影片格式和文字廣告。
- &ad_type=standardvideo_image
- 僅允許不可略過的標準影片和圖像廣告。
client
(字串) 發佈商的網站資源編號。
範例:&client=ca-video-afvtest
description_url
(字串) 經過網址編碼的影片 HTML 說明頁完整網址。您可使用伺服器端程式語言動態建立description_url 值,或使用 線上網址編碼工具手動建立。
範例:&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
範例網址
下方的網址範例只包含最低限度的必要參數:https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
向發佈商 ca-video-afvtest 請求影片廣告,說明網址為:http:// myurl.com/page?key=value&key2=value2
channel
(字串) 一個用加號分隔的管道清單,用於 AdSense 指定目標及報表。每個廣告請求最多可傳遞五個管道。
範例:&channel=mychannel+otherchannel+targetingchannel
adsafe
(字串) 決定用來篩選廣告能否顯示的設定。預設值為「high」。
值:
- high -- (預設) 傳回闔家皆宜廣告,不會傳回非闔家皆宜或成人色情內容廣告。
- medium -- 傳回闔家皆宜和非闔家皆宜的廣告 (例如賭博或處方藥廣告),但不會傳回成人色情內容廣告。
範例:&adsafe=high
adtest
(字串) 指出本次是否為測試執行,值可以是「on」或「off」。如果設為「on」,AdSense 影片廣告帳戶中將不會記錄曝光和點擊次數。在測試過程中「必須」設定這個參數。如果未設定,預設值為「off」。
值:
- off -- (預設) 所有廣告費用照常結算。這是實際執行中應採用的值。
- on:這項設定可確保廣告不會在試驗期間記錄任何曝光或點擊次數。
範例:&adtest=on
videoad_start_delay
(整數) 開始播放廣告時影片已播放的毫秒數。預設值為片中廣告的毫秒數 (明確來說就是 1)。
值:
- -1:指定內容結束時要顯示的片尾廣告
- 0:指定內容開始播放前要顯示的片頭廣告
- 任何正整數:指定內容在播放這個毫秒數後要顯示的片中廣告。
範例:
- &videoad_start_delay=-1 -- 片尾廣告。
- &videoad_start_delay=15000 -- 廣告會在內容播放 15 秒鐘後顯示。
cust_age
(整數) 指定使用者的年齡。可使用確切年齡,以及在 com.google.ads.ima.api.Demographics 中定義的年齡層。
範例:
- &cust_age=1001 -- 18 到 24 歲
- &cust_age=38 -- 正好 38 歲
cust_gender
(整數) 指定 com.google.ads.ima.api.Demographics 中定義的年齡層。
值:
- 1:男性
- 2:女性
範例:
- &cust_gender=1 -- 男性
- &cust_gender=2 -- 女性
host
(字串) 三方收益分成所使用的主機編號。
範例:&host=ca-host-test -- 與此主機拆分收益。
h_ch
(字串) 一個以加號分隔的字串清單,表示主機的 AdSense 指定目標/報表管道編號。
範例:&h_ch=channel1+channel2+channel3 -- 為主機指定這些額外的管道,並製作相關報表。
ht_id
(數字) 階層 ID,用來指定發佈商和主機之間的收益分成層級。
範例:&ht_id=2 -- 階層 2 的主機。
hl
(字串) 用來請求該語言版本廣告的語言代碼,這可以是任何 ISO 639-1 (雙字母) 或 ISO 639-2 (三字母) 代碼。有效代碼清單請見這裡。
範例:
- &hl=en -- 英文。
- &hl=es -- 西班牙文。
max_ad_duration
(整數) 指定必須傳回的影片長度上限,以毫秒為單位。如果不設定,預設值為 100 秒。
範例:&max_ad_duration=30000 -- 不可略過廣告的長度上限一律為 30 秒。
min_ad_duration
(整數) 指定必須傳回的影片長度下限,以毫秒為單位。如果不設定,預設值為 0 秒。
範例:
- &min_ad_duration=15000 -- 傳回的不可略過廣告長度不得短於 15 秒。
- &min_ad_duration=0 -- 影片長度只受限於 max_ad_duration 的值。
sdmax
(整數) 指定可略過廣告的影片長度上限,以毫秒為單位。如果不設定,預設值為無限制。
範例:&sdmax=120000 -- 傳回的可略過廣告長度不得超過 2 分鐘。
overlay
(整數) 用來限制鎖請求的重疊廣告大小:只能是佔底部三分之一的非線性底部重疊廣告。預設為沒有限制。
範例:
- &overlay=1 -- 只請求大小佔底部三分之一的重疊廣告,不請求全版位重疊廣告。
- &overlay=0 -- 預設值,對重疊廣告大小完全不設限。系統會根據 AdsRequest.nonLinearAdSlotWidth 和 adsRequest.nonLinearAdSlotHeight 決定要放送的重疊廣告大小。