Build Google Publisher Tags

使用無代碼請求載入廣告素材程式碼

請求原始廣告素材程式碼以便用於自訂剖析和顯示

您可以使用無代碼請求代替廣告代碼,請求在 Ad Manager 中投放的原始廣告素材程式碼。無代碼請求通常在需要自訂剖析和顯示功能時使用,例如機上盒或其他沒有 Google 代碼或 SDK 支援的環境。

當您提出無代碼請求時,Ad Manager 只會傳回與投放時完全一致的原始廣告素材程式碼,而不會執行及顯示廣告。如果沒找到廣告,Ad Manager 會傳回空回應的 200/OK 狀態。

您的應用程式、播放器或網站必須執行程式碼才能顯示廣告,並啟用曝光追蹤功能。

手動建立無代碼請求

如要建立無代碼請求,請從基準網址著手,並納入所有必要參數及任何其他選用參數。這些參數可指定廣告單元、廣告素材大小、鍵/值及關於廣告請求的其他資訊。

您必須使用 SSL (https://) 安全地建立無代碼請求。

從基準網址開始

請使用這個基準網址:https://securepubads.g.doubleclick.net/gampad/adx?

為廣告請求指定參數

必要參數
參數 說明
iu

Google Ad Manager 廣告單元程式碼,包括 Google Ad Manager 聯播網代碼。如要包含多個層級,請使用斜線 (/) 做為分隔字元。

範例

iu=/123/homepage
iu=/456/sports/baseball

若搭配無代碼請求使用多重客戶管理 (MCM),請使用 parent,child 結構做為聯播網代碼。

範例 (MCM)

iu=/123,456/homepage

sz

廣告素材大小。如要包含多個尺寸的廣告素材,請使用直立線 (|) 做為分隔字元。

範例

sz=320x50 (一種大小)
sz=320x50|300x50 (多種大小)

我們建議您使用 %7c,為無代碼請求中的直立線 (|) 字元進行編碼。

範例

&sz=216x36|300x50|320x50 改成 &sz=216x36%7c300x50%7c320x50

url

代管初始廣告請求的網域網址,只有 MCM 請求才需要提供。

範例

url=www.example.com

c

Correlator (或快取清除) 值,必須是發布商產生的一組隨機號碼 (不得使用字母),用於確保系統在每次網頁載入時,都會向廣告伺服器發出新的呼叫,避免曝光計數出現不一致的情形。

範例

c=8362527364

tile

廣告代碼在網頁上的位置。此值必須是不重複的整數。為方便實作,建議您使用累計的數字。

如果有多組廣告代碼在相同網頁上採用同一組廣告單元代碼 (iu=) 和 correlator (c=) 值,才需要使用這個值。

範例

https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1
https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2

具有遞增圖塊 (tile=) 值的所有請求必須在 30 秒內觸發,以確保不會再次為相同 Correlator (c=) 選擇相同的廣告素材。
選用參數
參數 說明
d_imp

延遲曝光次數計算參數。如果包含這個參數,系統將停止在發出廣告請求時計算曝光,而會改用傳回的廣告素材中的已瀏覽曝光巨集或是 d_imp_hdr 參數中的資訊來記錄曝光。

範例

d_imp=1
d_imp=0 (這是 Google Ad Manager 曝光次數計算參數的預設值)。

d_imp_hdr

延遲曝光標頭資訊計算參數。如果加入這個參數,系統將在 HTTP 標頭中傳回用於計算曝光次數的檢視網址。根據預設,系統不會定義這項標頭資訊,因此發布商需要手動連線偵測這個檢視網址,以計算曝光次數。進一步瞭解曝光次數和無代碼請求

  • Google-Delayed-Impression 標頭包含 Google Ad Manager 曝光網址。
  • Google-3rdParty-Delayed-Impression 標頭包含第三方曝光網址 (如果出現在廣告素材中)。

範例

d_imp_hdr=1
d_imp_hdr=0 (明確停用延遲曝光標頭資訊)。

t

版位層級鍵/值組合。每個鍵和值會以等號 = 字元分隔,鍵/值組合則會以 & 字元分隔。您必須對每個鍵和值分別進行網址編碼,再對整個字串進行網址編碼。鍵/值組中的每個鍵皆不得重複;如有重複的鍵,系統只會採用其中一個相關值。

範例

t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith 參數會替「action」這個值指派「genre」這個鍵,並替「Mr & Mrs Smith」這個值指派「movie」這個鍵。
請注意,所指定鍵/值之間的「&」會經過單編碼 (%26);若「&」出現在值中,則會經過雙編碼 (%2526)。

使用 excl_cat 做為競爭排除的特殊鍵。

範例

t=excl_cat%3Dairlines
t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines

鍵或值中不得使用以下字元:" ' ! + # * ~ ; ^ ( ) < > [ ] = 。空格可以在值中使用 (逸出為 %20+),但無法在鍵中使用。

範例

您無法使用 t=a%3Db%252Bc 將鍵「a」設為值「b+c」。

m

HTTP 標題上的 MIME 類型值。

範例

m=text/wml

mob

行動廣告請求指標。

範例

mob=js (這是唯一可以接受的值)。

ppid

透過發布商提供的 ID (PPID) 參數,您可向 Google Ad Manager 傳送 ID,用於展示頻率上限、目標對象區隔和指定目標對象、廣告依序輪播,以及其他以目標對象為準的跨裝置廣告放送控制項。

範例

ppid=12JD92JD8078S8J29SDOAKC0EF230337

u_w

行動裝置螢幕寬度,這會覆寫廣告伺服器自動偵測到的資料。

範例

u_w=1024

u_h

行動裝置螢幕高度,這會覆寫廣告伺服器自動偵測到的資料。

範例

u_h=768

submodel

行動裝置硬體資訊,這會覆寫廣告伺服器自動偵測到的資料。

範例

submodel=iPhone4%2C1 (用來分隔次型號值的逗號經過編碼)。

次型號值:

  • iPhone (第一代):iphone1,1
  • iPhone 3G:iPhone1,2
  • iPhone 3GS:iPhone2,1
  • iPhone 4 (GSM):iphone3,1
  • iPhone 4 (GSM):iPhone3,2
  • iPhone 4 (CDMA):iphone3,3
  • iPhone 4S:iPhone4,1
  • iPhone 5 (GSM 和 LTE):iPhone5,1
  • iPhone 5 (CDMA 和 LTE):iPhone5,2
  • iPhone 5c (GSM 和 CDMA):iPhone5,3
  • iPhone 5c (GSM 和 CDMA):iPhone5,4
  • iPhone 5s (GSM 和 CDMA):iPhone6,1
  • iPhone 5s (GSM 和 CDMA):iPhone6,2
  • iPhone 6:iPhone7,2
  • iPhone 6 Plus:iPhone7,1
  • iPhone 6s:iPhone8,1
  • iPhone 6s Plus:iPhone8,2
  • iPhone SE:iPhone8,4
  • iPhone 7:iPhone9,1
  • iPhone 7 Plus:iPhone9,2
  • 第一代 iPod:iPod1,1
  • 第二代 iPod:iPod2,1
  • 第三代 iPod:iPod3,1
  • 第四代 iPod:iPod4,1
  • 第五代 iPod:iPod5,1
  • 第一代 iPad (Wi-Fi):iPad1,1
  • 第一代 iPad (AT&T):iPad1,2
  • 第二代 iPad (Wi-Fi):iPad2,1
  • 第二代 iPad (AT&T):iPad2,2
  • 第二代 iPad (Verizon):iPad2,3
  • 第二代 iPad (Wi-Fi):iPad2,4
  • 第三代 iPad (Wi-Fi):iPad3,1
  • 第三代 iPad (Verizon):iPad3,2
  • 第三代 iPad (AT&T):iPad3,3
  • 第四代 iPad (Wi-Fi):iPad3,4
  • 第四代 iPad (AT&T):iPad3,5
  • 第四代 iPad (Verizon):iPad3,6
  • iPad Mini (Wi-Fi):iPad2,5
  • iPad Mini (AT&T-US;GSM & LTE 4、17):iPad2,6
  • iPad Mini (Verizon-World;GSM、DMA & LTE 1、3、5、13、25):iPad2,7
  • iPad Mini Retina (Wi-Fi):iPad4,4
  • iPad Mini Retina (LTE):iPad4,5
  • iPad Air (Wi-Fi):iPad4,1
  • iPad Air (LTE):iPad4,2
 
您可以將可重設的裝置 ID (RDID) 用於展示頻率上限和指定目標對象。進一步瞭解如何為無代碼請求設定 RDID

啟用曝光追蹤

Ad Manager 可為無代碼請求追蹤下載的曝光次數 (或稱「延遲」曝光次數)。請使用以下任何一個選項,但「請勿」同時使用所有的選項。如果同時使用所有的選項,有可能會導致曝光次數出現重複 (或三重) 計算的情況。

我們推薦選項 1,但是您必須要具備存取 HTTP 回應標頭的權限,還要能導入以標頭為基礎的通訊協定。

選項 1:讀取 HTTP 回應標頭以控制曝光計算方法

d_imp=1 和 d_imp_hdr=1 參數加入無代碼請求中;如此一來,您必須使用 Google-Delayed-Impression HTTP 標頭網址手動觸發曝光連線偵測,Google Ad Manager 才會記錄曝光次數或下載曝光次數。觸發曝光連線偵測後,Google Ad Manager 就會記錄「廣告伺服器曝光」和「廣告伺服器下載曝光」。

請勿將已瀏覽曝光巨集加入無代碼請求傳回的廣告素材中,避免重複計算曝光次數。

選項 2:使用已瀏覽曝光巨集

如果您無法存取 HTTP 回應標頭,則必須區隔廣告空間,並將已瀏覽曝光巨集加入無代碼請求傳回的每個廣告素材程式碼片段。廣告顯示時,這個巨集會展開為廣告素材傳送的網址。

建立無代碼請求以擷取廣告素材程式碼

網頁內容

無代碼請求通常用於沒有 Google 代碼或 SDK 支援的環境。如果您在網站上載入無代碼請求,則必須在 <iframe> 中載入,這個請求才能執行傳回的原始程式碼。

沒有 Google SDK 的自訂環境

如要在沒有 Google 標記或 SDK 支援的環境 (例如非 Google 機上盒) 中擷取原始廣告素材程式碼,請參閱下列指南:

  • User-Agent 請求標頭中設定有效的使用者代理程式,以確保指定目標功能運作正常。
  • 確認您採用的環境能夠處理互動式多媒體的作業,包括 JavaScript 和廣告素材展開。
  • 向 Google Ad Manager 發出 HTTPS 請求。
  • 檢查回應狀態是否為「HTTP 200/OK」;此狀態表示請求的格式正確。

使用無代碼請求時不支援的功能

在 HTML 圖片代碼 (<img>) 中使用 gampad/ad 的無代碼請求不支援 JavaScript 追蹤程式碼,且不適用下載的曝光次數計算方法。

無代碼請求放送的廣告素材不支援廣告徽章,您的廣告必須符合在歐洲經濟區 (EEA) 放送廣告時適用的法規要求,包括使用者檢舉非法內容的機制。發布商應使用適當的表單,通知 Google 使用者舉報的所有非法內容。

如要製作這些廣告的報表,請使用 Ad Manager 報表中的「廣告程式碼調用次數總計」指標。

這對您有幫助嗎?

我們應如何改進呢?
true
版本資訊

瞭解 Ad Manager 最新功能和說明中心更新內容。

查看新功能

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