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

您可以使用無標記請求代替廣告代碼，來請求在 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
廣告	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

選用參數

參數	說明
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」。
公尺	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 請求標頭中設定有效的使用者代理程式，以確保指定目標功能運作正常。
• 確認您採用的環境能夠處理 Rich Media 的作業，包括 JavaScript 和廣告素材展開。
• 向 Google Ad Manager 發出 HTTPS 請求。
• 檢查回應狀態是否為「HTTP 200/OK」；此狀態表示請求的格式正確。

使用無標記請求時不支援的功能

• Active View
• Ad Exchange
• 用於追蹤的 Cookie 或行動應用程式 ID
• 廣告素材包裝函式
• AdSense、Ad Exchange 或 AdMob 的動態分配功能
• 原生廣告空間
• 首選交易
• 廣告素材預覽

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

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