更新時間:2024年12月26號
在GA4中,追蹤「檔案下載」是常見的事件分析需求,例如:
- PDF下載
- ZIP壓縮檔下載
- Word/Excel文件下載
- 軟體安裝檔下載
這一篇會教你兩種方法:
- GA4加強型評估(推薦)
- GTM自訂追蹤
GA4檔案下載事件(file_download)是什麼?
GA4透過Enhanced Measurement(加強型評估)自動偵測下載行為,並產生file_download事件。
當使用者點擊「可下載檔案連結」時觸發。
GA4 支援追蹤的檔案類型
當使用者點按的連結會連往下列類型檔案:pdf|xlsx?|docx?|txt|rtf|csv|exe|key|pp(s|t|tx)|7z|pkg|rar|gz|zip|avi|mov|mp4|mpe?g|wmv|midi?|mp3|wav|wma
file_download 事件會帶哪些參數?
| 參數 | 說明 |
|---|---|
| file_name | 檔案名稱 |
| file_extension | 副檔名 |
| link_url | 下載 URL |
| link_text | 點擊文字 |
| link_domain | 網域 |
| link_classes | CSS class |
| link_id | 元素 ID |
假設要追蹤這個位置的檔案下載,點擊後會下載一個zip的檔案:
方法一:GA4加強型評估(最快方式)
在GA4中,點擊 「管理」——「資源設定」——「資料收集和修改」——「資料串流」——「網站串流」——「加強型評估」,就可以看到加強型評估事件的設定介面:
優點:不需要GTM、5分鐘完成、適合一般網站
限制(很多人踩雷):
- SPA網站可能失效:因為沒有完整page load
- JS按鈕下載無法追蹤:GA4無法識別
- 非標準URL不觸發:比如API download response、redirect download
方法二:GTM自訂file_download(專業做法)
如果你需要精準追蹤下載按鈕、排除特定檔案、自訂事件參數,必須用GTM
Step 1:開啟內建變數
在GTM中點擊「變數」——「設定」,勾選Click URL和Click Text:
Click URL對應檔案下載的事件參數link_url
Click Text對應檔案下載的事件參數file_name
Step 2:新建觸發條件
在GTM中點擊「觸發條件」——「新增」——「請選擇觸發類型以開始設定…」——「所有元素」,命名為 “download”, 然後做如下設定:
點擊下載的文字是“檔案下載”,所以設定Click Text 等於 檔案下載。
根據你的實際情況去設定觸發條件。
Step 3:設定代碼
在GTM中點擊「代碼」——「新增」——「請選代碼發類型以開始設定…」——「Google Analytics (分析):GA4 事件」,命名為 “GA4-Event-File Downlad”, 然後做如下設定:
這裡的事件參數盡量用加強型評估事件裡檔案下載裡的事件參數。
Step 4:預覽調試
接下來就是預覽調試,在GTM裡點擊右上角的「預覽」:
事件準確觸發。
GA4查看檔案下載數據
有多種方式可以看到搜索詞:
方法 1:標準報表
些增強型評估事件的事件參數並沒有在報表裡的事件,所以需要通過探索去獲取,如file_download,比如我想看某個文檔被點擊下載的次數,打開事件報表:
並沒有這個資料,所以需要通過探索去獲取這個資料。
方法 2:探索報表(推薦)
有些增強型評估事件的事件參數並沒有在報表裡的事件,所以需要通過探索去獲取,在GA4中點擊「探索」——「任意形式」,然後做如下設定:
- 列:檔案名稱
- 值:事件計數、活躍使用者
- 篩選器:事件名稱 包含 file_download
就可以知道不同檔案的下載人數和次數。
常見問題(FAQ)
為什麼file_download 有資料?
通常是沒開 Enhanced Measurement、下載不是標準 URL、JS 觸發行為
ZIP/PDF沒被記錄?
常見原因redirect download






