您可以使用無代碼請求代替廣告代碼,請求在 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 聯播網代碼。如要包含多個層級,請使用斜線 ( 範例
若搭配無代碼請求使用多重客戶管理 (MCM),請使用 範例 (MCM)
|
sz |
廣告素材大小。如要包含多個尺寸的廣告素材,請使用直立線 ( 範例
我們建議您使用 範例將 |
url |
代管初始廣告請求的網域網址,只有 MCM 請求才需要提供。 範例
|
c |
Correlator (或快取清除) 值,必須是發布商產生的一組隨機號碼 (不得使用字母),用於確保系統在每次網頁載入時,都會向廣告伺服器發出新的呼叫,避免曝光計數出現不一致的情形。 範例
|
tile |
廣告代碼在網頁上的位置。此值必須是不重複的整數。為方便實作,建議您使用累計的數字。 如果有多組廣告代碼在相同網頁上採用同一組廣告單元代碼 ( 範例
tile= ) 值的所有請求必須在 30 秒內觸發,以確保不會再次為相同 Correlator (c= ) 選擇相同的廣告素材。 |
參數 | 說明 |
---|---|
d_imp |
延遲曝光次數計算參數。如果包含這個參數,系統將停止在發出廣告請求時計算曝光,而會改用傳回的廣告素材中的已瀏覽曝光巨集或是 範例
|
d_imp_hdr |
延遲曝光標頭資訊計算參數。如果加入這個參數,系統將在 HTTP 標頭中傳回用於計算曝光次數的檢視網址。根據預設,系統不會定義這項標頭資訊,因此發布商需要手動連線偵測這個檢視網址,以計算曝光次數。進一步瞭解曝光次數和無代碼請求。
範例
|
t |
版位層級鍵/值組合。每個鍵和值會以等號 範例
使用 範例
鍵或值中不得使用以下字元: 範例您無法使用 |
m |
HTTP 標題上的 MIME 類型值。 範例
|
mob |
行動廣告請求指標。 範例
|
ppid |
透過發布商提供的 ID (PPID) 參數,您可向 Google Ad Manager 傳送 ID,用於展示頻率上限、目標對象區隔和指定目標對象、廣告依序輪播,以及其他以目標對象為準的跨裝置廣告放送控制項。 範例
|
u_w |
行動裝置螢幕寬度,這會覆寫廣告伺服器自動偵測到的資料。 範例
|
u_h |
行動裝置螢幕高度,這會覆寫廣告伺服器自動偵測到的資料。 範例
|
submodel |
行動裝置硬體資訊,這會覆寫廣告伺服器自動偵測到的資料。 範例
次型號值:
|
啟用曝光追蹤
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」;此狀態表示請求的格式正確。
使用無代碼請求時不支援的功能
- Active View
- Ad Exchange
- 用於追蹤的 Cookie 或行動應用程式 ID
- 廣告素材包裝函式
- AdSense、Ad Exchange 或 AdMob 的動態分配功能
- 原生廣告空間
- 首選交易
- 廣告素材預覽
- AdChoices
在 HTML 圖片代碼 (<img>
) 中使用 gampad
/ad
的無代碼請求不支援 JavaScript 追蹤程式碼,且不適用下載的曝光次數計算方法。
如要製作這些廣告的報表,請使用 Ad Manager 報表中的「廣告程式碼調用次數總計」指標。