追蹤程式碼疑難排解

如要解決 Google Analytics (分析) 追蹤相關問題,請先按照說明中心「 驗證設定」一節的說明,確認基本設定正確無誤。

Analytics (分析) 追蹤疑難排解將以兩個重要問題為中心:

  1. 追蹤程式碼中的錯誤/樣式語法 (例如空白字元、拼寫錯誤、參數名稱不正確)
  2. 報表中遺漏的資料

本文件的其他部分將說明如何使用疑難排解工具,找出並修正這兩個基本問題。

追蹤程式碼常見錯誤

不論您使用的是非同步語法還是傳統語法,都可以參考下列注意事項,以避免自訂或調整追蹤程式碼時發生最常見的錯誤。如想瞭解如何輕鬆檢查這些錯誤,請參閱「使用 ga_debug.js 進行除錯」一文。

  • 方法名稱使用的大小寫不正確。
    請記得,方法須區分大小寫。如果使用的方法名稱時沒有適當大小寫,方法呼叫將無法運作。範例:
      _gaq.push(['_trackpageview']);   // wrong
      _gaq.push(['_trackPageView']);   // wrong
      _gaq.push(['_trackPageview']);   // correct
  • 方法名稱不正確。
    如果追蹤功能無法正常運作,請確認您使用的方法名稱正確無誤。範例:
      _gaq.push(['_setDomain', 'example.com']);       // wrong
      _gaq.push(['_setDomainName', 'example.com']);   // correct
  • 使用引號傳送非字串值
    只有字串應加上引號。所有其他類型都應留空。
    任何非字串的值 (例如布林值、物件常值、函式或陣列) 皆應傳入不加引號。如果您傳入的內容要解譯為字串,請只使用引號。如果您是從傳統語法進行遷移,任何傳入且不含引號的函式參數,在非同步語法中都不應加上引號。範例:
      _gaq.push(['_setAllowLinker', 'false']);    // wrong
      _gaq.push(['_setAllowLinker', false]);      // correct
  • 字串開頭或結尾包含空白字元。
    範例:
      _gaq.push(['_setAccount', ' UA-65432-1']);    // wrong
      _gaq.push(['_setAccount', 'UA-65432-1']);     // correct

返回開頭

常見報表資料問題

如果報表中缺少資料,請參閱本節協助您找出最常見的錯誤和建議做法。

未偵測到追蹤程式碼變更或設定

第一次在網頁上安裝追蹤程式碼,或是加入額外的追蹤程式碼功能 (例如電子商務功能),只要檢查下列元素,即可輕鬆確認網頁要求是否設定正確:

  • 網頁要求 ga.js JavaScript
  • 網頁要求 __utm.gif
  • 系統正在透過 __utm.gif 要求傳送 utmacutmcc 變數
  • 所有相關的追蹤參數均適用於您希望傳送的其他資料 (請參閱下方的 GIF 要求參數清單)。

如果所有這些元素都已正確傳送,最近資料應該會在 24 小時內顯示於報表中。不過,您也可以將報表的日期範圍變更為「今天」,藉此確認資料是否更快顯示。

返回開頭

網頁或事件未顯示在報表中

如果含有追蹤程式碼的網頁並未出現在「內容」報表中,請查看以下幾點:

  • 你正在尋找正確的頁面嗎?
  • Google Analytics (分析) 以 utmp 參數值做為網頁要求,因此若網頁網址為 /test/myPage.html,請務必在「內容」報表中尋找 myPage.html。檢查 utmp 參數的值,瞭解目前傳送的是哪個網頁要求。
  • 您正在尋找正確的活動嗎?
  • Google Analytics (分析) 會使用 utme 參數的值,以 5(object*action*label)(value) 的格式追蹤事件:
    • 5 為常數
    • 而選取物件和動作
    • 標籤和值都是選項
    詳情請參閱「追蹤事件」說明文件。
  • 您每天追蹤的不重複網址或虛擬網頁超過 50,000 個嗎?
  • Google Analytics (分析) 會收集所有從網站傳送的資料,並針對前 50,000 名網頁 (按網頁瀏覽量排序) 製作報表。在內容報表中,所有其他網頁都會彙整成獨立的部分,並加上「(其他)」標籤。若要針對低流量網頁瀏覽查看詳細報表資訊,您可以建立新的資料檢視 (設定檔) 並加入篩選器來移除所有流量較高的網頁瀏覽量,這樣就能有效將其餘網頁納入前 50,000 個網址。
  • 請確認您在報表使用者介面中存取的是正確的帳戶和資料檢視 (設定檔)。
  • Google Analytics (分析) 會依網域 ID 區分不同的帳戶,網域 ID 為 UA-123456-1。這個網域 ID 是插入追蹤程式碼中,用來將網頁的資料與指定帳戶建立關聯的方式。確認您目前查看的帳戶和資料檢視 (設定檔) (「Analytics (分析) 設定」->「編輯」->「檢查狀態」) 的網域 ID 與 GIF 要求的 utmac 參數中所傳送的網域 ID 相同。

返回開頭

廣告活動追蹤相關問題

如要在 Google Analytics (分析) 中追蹤廣告活動,連至網站的廣告連結必須附加追蹤參數。接著,Google Analytics (分析) 公開和同意聲明程式碼會結合使用網頁網址和參照連結網址參數,來識別要傳送的廣告活動。這項資訊隨後就會儲存在您網站的 Cookie 中,並傳送於 GIF 要求的 utmcc 參數中。在許多情況下,網站網址重新導向會去除這些連結的追蹤參數或參照連結網址資料,但會導致廣告活動報表不正確。

如要測試重新導向是否會導致廣告活動追蹤問題,請按一下指向您網站的參照連結網址或標記連結,然後在「utmcc參數中找出正確的廣告活動資料。如要進一步瞭解如何找出及讀取 utmcc 參數,請參閱「GIF 要求參數」和「使用 ga_debug.js 進行偵錯」。

目標 (轉換) 歸因不正確

轉換是指與特定廣告活動相關聯的目標。若要確定目標與指定廣告活動或推薦連結有正確的關聯,請進行下列步驟:

  1. 按一下連至您網站的參照連結網址,這樣就會設定廣告活動 Cookie。
  2. 點進您的網站,前往轉換或目標網頁。
  3. 檢查 utmcc 參數中傳送的資料,確保廣告活動 Cookie 維持不變。

追蹤程式碼擷取到所有廣告活動資訊後,就會儲存在 Cookie 中,且使用者在多個工作階段中留存了。系統會為每個執行追蹤函式的頁面傳送廣告活動資訊,並透過 GIF 要求傳送。因此,每次網頁瀏覽都有相關聯的廣告活動/參照連結網址資料。如果其中一個網頁瀏覽廣告活動設為目標, 相關的網頁瀏覽廣告活動就會與該目標產生關聯。如要進一步瞭解如何找出及讀取 utmcc 參數,請參閱「GIF 要求參數」和「使用 ga_debug.js 進行偵錯」。

返回開頭

基本偵錯步驟

每次執行 Google Analytics (分析) 追蹤程式碼時,都會向 Google Analytics (分析) 收集伺服器要求一個像素的 GIF 圖片,名為 __utm.gif。附加在圖片的要求字串中,是 Google 針對特定網頁要求擷取的所有參數,包括:

  • 網址網頁瀏覽資訊
  • 廣告活動資訊
  • 電子商務資料
  • 瀏覽器屬性
  • Client-ID

GIF 要求中包含的資料完全對應傳送至 Google Analytics (分析) 伺服器的資料,由系統處理資料,最後在報表中顯示。因此,您可以查看 __utm.gif 要求中傳送的資料,判斷追蹤程式碼是否正常運作,以及是否傳送不正確的資料至報表。

若要對追蹤程式碼進行偵錯,請按照下列基本步驟操作:

  1. 使用第三方偵錯工具檢查 Google Analytics (分析) 中的 GIF 要求 (點選網站上的相關連結)。
  2. 並確認追蹤程式碼不含任何常見的追蹤程式碼錯誤
  3. 確認 utmp 參數存在。
  4. 確認 utmcc 參數存在且非空白。
    如果 utmcc 參數空白,系統就不會傳送 Cookie 資料,並忽略要求。
  5. 重複執行測試數次,確保每次都會傳送 GIF 要求。

返回開頭

偵錯工具

GIF 要求的網址附加了許多名稱/值參數。與其嘗試查看整個字串,您可以使用免費的工具,以更易讀的格式顯示 GIF 要求。下表列出一些可與常見瀏覽器搭配使用的工具。

為方便起見,我們開發了 Google Analytics (分析) 追蹤程式碼偵錯工具,讓您不必變更程式碼,就能排解追蹤程式碼的問題。只要啟用這項擴充功能,就能檢查正式版頁面中是否有錯誤。進一步瞭解 ga_debug.js。

瀏覽器 工具
全部 精簡型
Chrome Google Analytics (分析) 追蹤程式碼偵錯工具 新推出!
Chrome 內建開發人員工具 (例如資源)
Firefox 有效 HTTP 標頭
Firefox 螢火蟲
Firefox 查爾斯
Internet Explorer 幼兒
Internet Explorer 查爾斯
Safari 內建「Activity」視窗
Safari 查爾斯

安裝工具並完成設定後,您可以開啟要排解問題的網頁,並在工具中查看 GIF 分析。首先,您要確認相關網頁確實傳送 __utm.gif 要求。只要您看到請求,就能確認 Google Analytics (分析) 伺服器 正從該網頁收集資料。本節的其餘部分將提供使用「即時 HTTP 標頭」和 Firebug 的基本操作說明,讓您瞭解在網路瀏覽器中使用內建工具或外掛程式有多麼容易。

使用即時 HTTP 標頭

  1. 下載並安裝 Firefox 適用的 LiveHTTPHeaders;重新啟動瀏覽器。
  2. 開啟「Live HTTP 標頭」(依序點選「Tools」 >「LiveHTTPHeaders」)。
  3. 按一下「Generator」分頁標籤。
  4. 前往您的網站 (或任何已安裝 Google Analytics (分析) 追蹤程式碼的網頁)。
  5. 驗證是否為 urchin.jsga.js 提出的要求
  6. 確認你針對 __utm.gif 提出要求。

使用 Firebug

Firebug 擴充功能會以更結構化的檢視畫面顯示追蹤程式碼要求 (urchin.jsga.js) 以及 GIF 要求 (__utm.gif)。以下步驟示範如何使用 Firebug 查看 GIF 要求的詳細資料。

  1. 下載並安裝 Firebug for Firefox;重新啟動瀏覽器。
  2. 前往您的網站。
  3. 在 Firefox 中,依序選取 [Tools] > [Firebug] > [Open Firebug] > [Enable Firebug for this site] (為這個網站啟用 Firebug)。
  4. 依序按一下「Net」和「Images」
  5. 重新載入網頁,然後檢查清單中是否出現新的 __utm.gif 要求。
  6. 在「Params」分頁中驗證要求的元件。

返回開頭

使用 ga_debug.js 進行除錯

除了標準 ga.js 外,Analytics (分析) 團隊還部署了名為 ga_debug.js 的替代版 Google Analytics (分析) JavaScript。此指令碼的目的是協助 Analytics (分析) 使用者排解安裝問題。 如果您是 Analytics (分析) 新手,或是要將網站遷移至新的非同步語法,這項功能就特別實用。

指令碼會提供每個 GIF 請求的詳細資料,並在偵測到追蹤程式碼有問題時記錄警告和錯誤訊息。為此,系統會將訊息輸出至 window.console 物件。然後,您可以使用下列其中一種工具查看這些錯誤:

  • Firebug (適用於 Firefox)
  • Chrome 和/或 Safari 的內建工具
  • Firebug Lite (適用於其他瀏覽器)

若要使用 ga_debug.js 指令碼,您可以針對您有權存取和修改的網頁修改追蹤程式碼參照。方法是在該網頁的追蹤程式碼中,以 /u/ga_debug.js 取代所有指向 /ga.js 的參照。如果是大規模網站使用偵錯指令碼,建議您只在測試環境中使用這項指令碼。或者,如果要對小型網站進行偵錯,建議您只測試選取網頁,不要以這種方式測試整個網站。

重要事項:請勿修改實際運作網站來使用這個版本的 JavaScript。ga_debug.js 指令碼比 ga.js 追蹤程式碼還大,而且通常不會快取。因此,在實際運作網站上使用這項工具,會拖慢所有使用者瀏覽網站的速度。再次強調,此操作僅供您自行測試之用。

如果您使用通用 Analytics (分析) (analytics.js) 追蹤網站,可以啟用 analytics_debug.js (偵錯版本 analytics.js) 來排解追蹤程式碼的問題。如要進一步瞭解 analytics_debug.js,請參閱「 偵錯」一文。

使用 Google Analytics (分析) 追蹤程式碼偵錯工具

Google Analytics (分析) 追蹤程式碼偵錯工具是 Chrome 瀏覽器擴充功能,啟用 ga_debug.js 不需要程式碼變更程式碼。使用 ga_debug.js 可能是最簡單的方法,就是疑難排解及分析網站的追蹤行為。只要啟用這項擴充功能,就能檢查正式環境頁面上是否有錯誤,而不必修改程式碼本身的追蹤參照。

如要使用這項擴充功能,請按一下網址列右側的「擴充功能」圖示開啟該擴充功能。 然後開啟 Chrome JavaScript 控制台,在控制台中查看訊息。

  • 在 Windows 和 Linux 上,依序按一下 <頁面圖示> -> 開發人員 -> JavaScript 控制台,或按下 Control-Shift-J 鍵。
  • 在 Mac 上,依序按一下「檢視」->「開發人員」->「JavaScript 控制台」,或按下 Command-Option-J 鍵。

返回開頭

GIF 請求參數

GIF 要求過長。以下僅列舉 GIF 要求的部分內容:

http://www.google-analytics.com/__utm.gif?utmwv=4&utmn=769876874&utmhn=example.com&utmcs=ISO-8859-1&utmsr=1280x1024&utmsc=32-bit&utmul=en-us&utmje=1&utmfl=9.0%20%20r115&utmcn=1&utmdt=GATC012%20setting%20variables&utmhid=2059107202&utmr=0&utmp=/auto/GATC012.html?utm_source=www.gatc012.org&utm_campaign=campaign+gatc012&utm_term=keywords+gatc012&utm_content=content+gatc012&utm_medium=medium+gatc012&utmac=UA-30138-1&utmcc=__utma%3D97315849.1774621898.1207701397.1207701397.1207701397.1%3B...   

下表包含透過 GIF 要求傳入的許多參數清單。由於有些參數只適用於特定條件 (例如廣告活動參照連結網址或購物車),因此每次執行追蹤程式碼時,並不會傳送所有參數。使用這個參照時,請記住,您在尋找的變數是最常適用於您正在調查的網頁/要求。

變數 說明 範例值
utmac 帳戶字串。會顯示在所有要求中。 utmac=UA-2202604-2
utmcc
Cookie 值。這個要求參數會傳送網頁要求的所有 Cookie。
utmcc=__utma%3D117243.1695285.22%3B%2B __utmz%3D117945243.1202416366.21.10. utmcsr%3Db%7C utmccn%3D(referrer)%7C utm%
Urchin 流量監視器 (UTM) 開始新的廣告活動工作階段。任何指定的要求中都包含 utmcn 或 utmcr。變更廣告活動追蹤資料,但不啟動新的工作階段
utmcn=1
utmcr
表示重複造訪廣告活動。之後任何後續點擊發生同一個連結時,系統就會採用這個設定。任何指定的要求中都包含 utmcn 或 utmcr。
utmcr=1
utmcs
瀏覽器的語言編碼。部分瀏覽器不會設定這個屬性,且會設為「-」
utmcs=ISO-8859-1
utmdt
網頁標題,為網址編碼字串。 utmdt=analytics%20page%20test
Urchin 可擴充參數 值經過編碼。用於事件和自訂變數。
utmfl
Flash 版本 utmfl=9.0%20r48&
UTM

主機名稱:網址編碼字串, utmhn=x343.gmodules.com
utmhid

用來連結 Analytics (分析) GIF 請求與 Google AdSense 的隨機號碼。 utmhid=2059107202
utmipc
產品代碼。這是特定產品的 SKU 代碼。

utmipc=989898ajssi
utmipn
產品名稱,這是網址編碼字串。 utmipn=tee%20 襯衫
utmipr
單價。在項目層級設定。值只能設為美國貨幣格式的數字。
utmipr=17100.32
utmiqt
數量。 utmiqt=4
utmiva
項目變化。例如:大、中、小、粉紅色、白色、黑色、綠色。字串已編碼。
utmiva=red;
utmje
指出瀏覽器是否已啟用 Java。1 為 true。 utmje=1
Urchin 流量監視器 (UTM)
為每個 GIF 要求產生專屬 ID,以防止快取 GIF 圖片。 utmn=1142651215
utmp
目前網頁的網頁要求。 utmp=/testDirectory/myPage.html
utmr
參照連結網址的完整網址。 utmr=http://www.example.com/aboutUs/index.php?var=selected
utmsc
螢幕色彩深度 utmsc=24 位元
utmsr
螢幕解析度 utmsr=2400x1920
utmt
表示要求類型,即事件交易項目自訂變數。如果 GIF 要求中沒有這個值,系統會將要求輸入為 page utmt=event
utmtci
帳單城市 utmtci=San%20Diego
utmtco
帳單國家/地區 utmtco=聯合%20Kingdom
utmtid
訂單 ID、網址編碼字串。 utmtid=a2343898
utmtrg
帳單地區,網址編碼字串。 utmtrg=新%20Brunswick
utmtsp
運費。以單位和價格表示的值。 utmtsp=23.95
utmtst
聯盟。通常用於電子商務領域的實體應用程式。 utmtst=google%20mtv%20store
utmtto
總計。以單位和價格表示的值。 utmtto=334.56
utmttx
稅金。以單位和價格表示的值。 utmttx=29.16
utmul
瀏覽器語言。 utmul=pt-br
utmwv
追蹤程式碼版本 utmwv=1

 

返回開頭