自訂廣告素材的巨集

瞭解如何使用逸出和未逸出巨集

技術專業

本文適用於開發自訂廣告素材需要技術專業的使用者。

如果您是廣告投放專員,負責為自訂廣告素材與委刊項建立關聯,但不具備排解自訂廣告素材問題的技術專業,請向具備相關技術專業的人員求助。這可能是曾在 Ad Manager 中建立自訂廣告素材的貴機構人員,或是為貴機構提供自訂廣告素材程式碼的廣告代理商人員。

巨集在自訂廣告素材中有多種不同用途,其中兩個重要用途是做為到達網頁 (到達) 網址和點擊追蹤網址的預留位置,可分成未逸出、逸出、雙重逸出這三種版本。

「逸出」是指使用一個字元 (或一系列字元) 來代表另一個字元的做法。網址只能透過 ASCII 字元集經由網際網路傳送。不過,這個字元集以外的字元也可用於網址中,只是這類字元必須在傳輸期間經過編碼,系統才能正確解讀。

開發自訂廣告素材時,您必須在廣告素材程式碼中使用下列一或多個項目:

  • 未逸出點擊追蹤網址:%%CLICK_URL_UNESC%%
  • 逸出點擊追蹤網址:%%CLICK_URL_ESC%%
  • 未逸出到達網頁網址:%%DEST_URL%%
  • 逸出到達網頁網址:%%DEST_URL_ESC%%
  • 雙重逸出到達網頁網址巨集:%%DEST_URL_ESC_ESC%%

為了確保系統能追蹤點擊次數或讓使用者連上到達網頁網址,請使用適當的變化形式。如果使用錯誤的變化形式,可能會導致系統無法記錄點擊追蹤,或是使用者無法抵達到達網頁網址。

如果必須同時使用點擊追蹤網址和到達網址,您還必須使用正確的變化形式,進一步確保巨集已正確排序或「鏈結」在一起。

本文將說明正確和不正確的範例,協助您瞭解如何使用到達網頁網址和點擊追蹤網址巨集,以及如何將這些巨集鏈結在一起。

巨集插入範例

以下是 Campaign Manager 360 中未逸出點擊追蹤網址的範例。為求清楚起見,我們已移除或縮短參數:

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=

比較這個網址與相同網址的逸出版本:

http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253D

網址中的保留字元已使用百分比符號編碼改成雙重逸出。舉例來說,問號 (?) 一律會以 %253F 這串字元代表,等號 (=) 則一律會以 %253D 這串字元代表。

範例 1A—正確:自訂廣告素材 Ad Manager 點擊追蹤

在這個範例中,假設有一個自訂廣告素材的到達網址為:

http://www.google.com/page.html?param1=red&param2=blue

圖片廣告素材有可能會以下列方式追蹤點擊:

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

在這個示例中,廣告素材在使用者的瀏覽器中將顯示為:

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

因為 Ad Manager 點擊網址未逸出,而到達網頁網址適當逸出,所以這是一個有效且正確的點擊網址。

範例 1B—錯誤:自訂廣告素材 Ad Manager 點擊追蹤

有一個常見錯誤會導致上述範例的廣告素材程式碼無法正確運作,那就是使用逸出的點擊網址巨集。在廣告素材程式碼中,這個錯誤看來像這樣:

<a href='%%CLICK_URL_ESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

在使用者的瀏覽器中,廣告素材將顯示為:

<a href='http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

這是錯誤的,因為所有的參數都已逸出,導致廣告點擊伺服器無法正確進行剖析。相反地,伺服器會以為這是針對具備下列名稱的網頁所發出的請求:/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue

因為這個網頁並不存在,廣告點擊伺服器會傳回 HTTP 404 (找不到) 錯誤,使用者也無法前往廣告到達網頁。

範例 1C—錯誤:自訂廣告素材 Ad Manager 點擊追蹤

另一個常見的錯誤是使用未逸出的到達網頁網址巨集。在廣告素材程式碼中,這個錯誤看來像這樣:

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_UNESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

在使用者的瀏覽器中,廣告素材將顯示為:

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

請注意,「如果」第一個點擊伺服器夠聰明,可解讀及逸出網址的其餘參數,這個特定示例「可能會」正常運作。在這種情況下,Ad Manager 會改寫網址,因此到達網址便能正常運作。然而,如果因此認為伺服器將能處理格式錯誤的點擊網址,可能過於樂觀。我們「強烈建議」您使用正確格式的點擊網址,而不是依賴 Ad Manager 或第三方分析伺服器來處理格式錯誤的網址。

如果伺服器並未改寫格式錯誤的網址,解讀的結果將如下所示:

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue

在這種情況下,系統會將最後的「&」字元解讀為針對「第一個」伺服器請求限定新參數,而不是用來將參數傳遞給代管廣告到達網頁的伺服器。這可能會干擾點擊伺服器處理點擊網址的程序,進而阻止系統將使用者重新導向到達網頁。即使系統成功將使用者重新導向,第二個參數 (param2) 很可能不會傳遞給到達網頁。

範例 2A—正確:第三方點擊追蹤程式和巨集

廣告客戶可能會要求您在其廣告素材中納入第三方點擊追蹤程式。追蹤程式會記錄廣告素材的獨立點擊次數,方便廣告客戶日後進行稽核或對帳。

一般來說,點擊追蹤程式的格式為網址。以下是 Campaign Manager 360 範例:

http://ad.doubleclick.net/clk;a;b;c?[到達網址][到達網頁網址]

網址 (ad.doubleclick.net) 是記錄曝光或點擊的伺服器參照。其他第三方網址也是如此。到達網址應以下列兩個巨集表示:

  • 逸出後的 Click 巨集:%%CLICK_URL_ESC%%
  • 雙重逸出到達網頁網址巨集:%%DEST_URL_ESC_ESC%%

兩者都代表相同的到達網址,且必須放在問號 (?) 後方。以下是內含 Campaign Manager 360 點擊追蹤網址的圖片廣告素材範例:

<a href='http://ad.doubleclick.net/clk;a;b;c?%%CLICK_URL_ESC%%%%DEST_URL_ESC_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

使用廣告素材範本時,第三方點擊追蹤程式通常會以網址預留位置 ID 的型態呈現在廣告素材程式碼中。在使用者的瀏覽器中顯示時,廣告素材會將巨集展開為適當的值。例如:

<a href='http://ad.doubleclick.net/clk;a;b;c?http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/page.html%253Fparam1%253Dred%2526param2%253Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

廣告素材預覽和測試巨集

測試廣告素材可確保廣告素材正常運作。由於巨集是預留位置,而且有時會涉及複雜的程式碼,因此測試自訂廣告素材的最佳方式就是在委刊項中預覽廣告素材。方法如下:

  1. 新視窗中開啟廣告素材。

    JavaScript 無法在 Ad Manager 直接提供的預覽功能中運作,您也無法查看展開的巨集。

  2. 請使用瀏覽器的開發人員工具 (簡稱「開發工具」) 來檢查元素和 DOM。

驗證點擊追蹤巨集

正確插入巨集後,只要按一下預覽畫面中的廣告素材就會連到 Ad Manager 到達網頁。這個網頁會確認系統已追蹤點擊。系統會將您重新導向與廣告素材相關的到達網頁網址網頁。

如果上述任何一種情況都沒有發生,表示巨集或鏈結方式有問題。

驗證 View 巨集

如要驗證曝光追蹤巨集,您必須使用流量分析器。流量分析器可讓您查看和擷取 HTTP 要求。有些瀏覽器開發工具包含這類工具。此外,您也可以使用第三方流量分析軟體。

使用流量分析器,在廣告素材載入時檢查 HTTP 要求。您正在尋找針對曝光記錄伺服器的成功要求或「連線偵測」。請注意 HTTP 要求期間是否發生任何 HTTP 錯誤。

  • 如果您沒有發現任何錯誤,而且可以看到曝光記錄伺服器連線偵測成功,表示巨集已正確設定。
  • 如果您發現任何錯誤,請返回自訂廣告素材的原始碼排解問題。當巨集放置不當時,常見的錯誤代碼是 HTTP 204

這對您有幫助嗎?

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

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

查看新功能

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