通知

請務必前往您的 AdSense 頁面,查看帳戶的相關個人化資訊,運用 AdSense 順利達成目標。

AdSense 影片廣告 (AFV)

AdSense 影片廣告代碼參數 (IMA 適用)

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 決定要放送的重疊廣告大小。

 

這對您有幫助嗎?

我們應如何改進呢?
true
發掘成長潛力

別錯過實用的 AdSense 洞察資料。選擇接收成效報表、個人化提示和網路研討會邀請,藉此提升收益

選擇採用

搜尋
清除搜尋內容
關閉搜尋
主選單
8246321023478360030
true
搜尋說明中心
true
true
true
true
true
157
false
false