發布日期:2021 年 7 月 29 日
代碼是插入網站的第三方程式碼片段,通常會使用代碼管理工具。代碼最常用於行銷和數據分析。
代碼和代碼管理工具對效能的影響因網站而異。代碼管理工具就像信封:代碼管理工具提供容器,但要填入什麼內容以及如何使用,主要由您決定。
本文將說明如何最佳化代碼和代碼管理工具,提升效能和 Core Web Vitals。雖然本文以 Google 代碼管理工具為例,但其中討論的許多概念也適用於其他代碼管理工具。
對 Core Web Vitals 的影響
代碼管理工具通常會耗用快速載入網頁和保持回應所需的資源,間接影響 Core Web Vitals。下載網站的代碼管理工具 JavaScript 或後續呼叫,可能會耗用頻寬。主執行緒的 CPU 作業時間,可能用於評估及執行代碼管理工具和代碼中的 JavaScript。
Largest Contentful Paint (LCP) 容易在關鍵網頁載入時間發生頻寬爭用。此外,封鎖主執行緒可能會延遲 LCP 轉譯時間。
Cumulative Layout Shift (CLS) 可能會受到影響,原因是在首次算繪前延遲載入重要資源,或代碼管理工具將內容插入網頁。
Interaction to Next Paint (INP) 容易受到主執行緒上的 CPU 爭用影響,我們發現代碼管理工具的大小與 INP 分數較差之間存在關聯。
選擇合適的代碼類型
標記對成效的影響因標記類型而異。一般來說,圖片代碼 (「像素」) 的成效最好,其次是自訂範本,最後是自訂 HTML 代碼。供應商代碼會因允許的功能而異。
請注意,標記的使用方式會大幅影響成效。「像素」之所以能發揮高效能,主要是因為這類代碼的性質對使用方式有嚴格限制;自訂 HTML 代碼不一定會對效能造成負面影響,但由於這類代碼提供使用者較高的自由度,因此很容易因使用不當而影響效能。
考量代碼時,請務必考量規模:任何單一代碼對成效的影響可能微不足道,但如果在同一個網頁上使用數十或數百個代碼,影響可能會變得相當顯著。
並非所有指令碼都應透過代碼管理工具載入
如果資源會立即影響使用者體驗的視覺或功能層面,例如 Cookie 通知、主頁橫幅或網站功能,通常不適合透過代碼管理工具載入。如果使用代碼管理工具載入這些資源,通常會延遲傳送。這會導致使用者體驗不佳,也可能提高 LCP 和 CLS 等指標。
此外,部分使用者會封鎖代碼管理工具。如果使用代碼管理工具導入使用者體驗功能,可能會導致部分使用者的網站無法正常運作。
謹慎使用自訂 HTML 代碼
自訂 HTML 代碼已推出多年,在大多數網站上都廣泛使用。自訂 HTML 代碼可讓您輸入自己的程式碼,幾乎沒有任何限制,因為顧名思義,這個代碼的主要用途是在網頁中加入自訂 <script> 元素。
自訂 HTML 代碼有多種用途,對成效的影響也大不相同。評估網站成效時,請注意,大多數工具會將自訂 HTML 代碼的成效影響歸因於插入代碼的管理工具,而非代碼本身。

自訂 HTML 代碼可將元素插入周圍網頁。在網頁中插入元素可能會導致效能問題,在某些情況下也可能造成版面配置位移。
- 在大多數情況下,如果網頁中插入元素,瀏覽器就必須重新計算網頁上每個項目的大小和位置。這項程序稱為版面配置。單一版面配置對效能的影響微乎其微,但如果發生過多,就可能成為效能問題的來源。在低階裝置和 DOM 元素數量較多的網頁上,這種現象的影響較大。
- 如果周圍區域已轉譯,但 DOM 中插入了可見的網頁元素,就可能導致版面配置位移。這種現象並非代碼管理工具獨有,但由於代碼通常比網頁其他部分更晚載入,因此在周圍網頁算繪完成後,代碼通常會插入 DOM。
使用自訂範本
自訂範本支援部分與自訂 HTML 代碼相同的作業,但建構於沙箱版 JavaScript,可提供 API 處理指令碼插入和像素插入等常見用途。顧名思義,進階使用者可以建立範本,並在建構時考量效能。技術能力較低的使用者可以接著使用範本。這通常比提供完整的自訂 HTML 存取權更安全。
由於自訂範本受到的限制較多,這些代碼出現效能或安全性問題的可能性也較低。基於相同原因,自訂範本不適用於所有用途。

正確插入指令碼
使用代碼管理工具插入指令碼是很常見的做法。建議的做法是使用自訂範本和 injectScript API。
如要瞭解如何使用 injectScript API 轉換現有的自訂 HTML 代碼,請參閱「轉換現有代碼」。
如果您必須使用自訂 HTML 代碼,請注意下列事項:
- 程式庫和大型第三方指令碼應使用指令碼標記 (例如
<script src="external-scripts.js">) 載入,以便下載外部檔案,而不是直接將指令碼內容複製並貼到標記中。雖然不使用<script>標記可省去下載指令碼內容的來回作業,但這種做法會增加容器大小,並導致瀏覽器無法單獨快取指令碼。 - 許多供應商建議將
<script>標記放在<head>頂端。不過,如果是透過代碼管理工具載入的指令碼,通常不需要這麼做。在多數情況下,代碼管理工具執行時,瀏覽器已完成剖析<head>。
使用像素
有時,第三方指令碼可以替換為圖片或 iframe 像素。與指令碼相比,像素支援的功能可能較少,因此通常較不建議採用。不過,在代碼管理工具中使用像素時,像素可以更動態,因為它們可以在觸發條件上觸發並傳遞不同的變數。
像素是最有效率且安全的代碼類型,因為觸發後不會執行 JavaScript。像素的資源大小非常小 (小於 1 KB),不會造成版面配置位移。
請洽詢第三方供應商,進一步瞭解他們對像素的支援。此外,您也可以嘗試檢查程式碼中是否有 <noscript> 標記。如果供應商支援像素,通常會在 <noscript> 標記中加入像素。

像素的替代方案
像素之所以廣受歡迎,主要是因為在伺服器回應不相關的情況下 ( 例如將資料傳送至數據分析供應商),像素曾是提出 HTTP 要求最便宜且最可靠的方式之一。navigator.sendBeacon() 和 fetch() keepalive API 旨在解決相同的使用情境,但可以說比像素更可靠。
繼續使用像素並無不妥,因為像素受到良好支援,且對效能的影響極小。不過,如果您要自行建構信標,建議您考慮使用其中一個 API。
sendBeacon()
navigator.sendBeacon() API 適用於在伺服器回應不重要時,將少量資料傳送至網路伺服器。
const url = "https://example.com/analytics";
const data = JSON.stringify({
event: "checkout",
time: performance.now()
});
navigator.sendBeacon(url, data);
sendBeacon() 的 API 受到限制:僅支援發出 POST 要求,不支援設定自訂標頭。所有新式瀏覽器都支援這項功能。
Fetch API keepalive
keepalive 是一個旗標,可讓 Fetch API 用於發出非封鎖要求,例如事件回報和數據分析。使用方式是在傳遞至 fetch() 的參數中加入 keepalive: true。
const url = "https://example.com/analytics";
const data = JSON.stringify({
event: "checkout",
time: performance.now()
});
fetch(url, {
method: 'POST',
body: data,
keepalive: true
});
如果 fetch() keepalive 和 sendBeacon() 看起來很相似,那是因為它們確實很相似。事實上,在 Chromium 瀏覽器中,sendBeacon() 現在是以 fetch()
keepalive 為基礎建構。
選擇 fetch() keepalive 或 sendBeacon() 時,請務必考量所需的功能和瀏覽器支援。fetch() API 的彈性明顯較高,但瀏覽器對 keepalive 的支援程度低於 sendBeacon()。
瞭解標記的作用
代碼通常是按照第三方供應商提供的指引建立。 如果不清楚供應商程式碼的作用,建議您向瞭解的人員詢問。徵詢第二意見有助於判斷代碼是否可能造成效能或安全性問題。
建議您在代碼管理工具中,為代碼加上擁有者標籤。我們很容易忘記代碼擁有者是誰,因此不敢移除代碼,以免造成問題。
觸發條件
概括來說,最佳化代碼觸發條件通常包括確保不觸發不必要的代碼,以及選擇在業務需求與效能成本之間取得平衡的觸發條件。
觸發條件是 JavaScript 程式碼,會增加代碼管理工具的大小和執行成本。雖然大多數觸發因素都很小,但累積起來的效果可能會舉例來說,如果有多個點擊事件或計時器觸發條件,代碼管理工具的工作負載會大幅增加。
選擇適當的觸發事件
代碼對成效的影響可能不盡相同。一般來說,代碼越早觸發,對成效的影響就越大。資源通常會在初始載入網頁期間受到限制,因此載入或執行特定資源 (或代碼) 會占用其他資源。
雖然為所有代碼選擇適當的觸發條件很重要,但對於載入大型資源或執行冗長指令碼的代碼來說,這一點尤其重要。
代碼可在網頁瀏覽 (通常是 Page load、DOM Ready、Window Loaded) 或根據自訂事件觸發。為避免影響載入網頁,請在 Window Loaded 之後觸發非必要代碼。
使用自訂事件
使用自訂事件,即可在 Google 代碼管理工具內建觸發條件未涵蓋的網頁事件發生時,觸發條件。舉例來說,許多代碼會使用網頁瀏覽觸發條件。不過,DOM Ready 和 Window Loaded 之間的時間可能很長,因此難以微調代碼觸發時機。自訂事件可以解決這個問題。
首先,請建立自訂事件觸發條件,並更新代碼以使用這項觸發條件。

如要觸發,請將對應的事件推送至資料層。
// Custom event trigger that fires after 2 seconds
setTimeout(() => {
dataLayer.push({
'event' : 'my-custom-event'
});
}, 2000);
使用特定觸發條件
定義特定觸發條件,避免在不必要時觸發代碼。 最簡單有效的方法之一,就是確保代碼只在實際使用的網頁上觸發。

內建變數可納入觸發條件,限制代碼觸發。
在適當時間載入代碼管理工具
您可以調整代碼管理工具本身的載入時間,藉此提升成效。無論如何設定,觸發條件都必須在代碼管理工具載入後才能觸發。請嘗試調整載入代碼管理工具的時間,因為這可能會有相同或更大的影響。這項決策會影響網頁上的所有代碼。
延後載入代碼管理工具,可避免不小心過早載入代碼,進而防止日後發生效能問題。
變數
使用變數讀取網頁資料。在觸發條件和代碼中都很有用。
與觸發條件一樣,變數也會在代碼管理工具中加入 JavaScript 程式碼,因此可能導致效能問題。變數可以相對較小,例如讀取網址、Cookie、資料層或 DOM 部分內容的程式碼。也可以包含自訂 JavaScript,且功能和大小不受限制。
請盡量減少使用變數,因為代碼管理工具會持續評估變數。移除不再使用的舊變數,縮減代碼管理工具指令碼的大小和處理時間。
代碼管理
有效率地使用標記,可降低發生效能問題的風險。
使用資料層
資料層是 JavaScript 物件陣列,包含網頁相關資訊。這些物件包含您要傳遞給 Google 代碼管理工具的所有資訊。
資料層也可用於觸發代碼。
// Contents of the data layer
window.dataLayer = [{
'pageCategory': 'signup',
'visitorType': 'high-value'
}];
// Pushing a variable to the data layer
window.dataLayer.push({'variable_name': 'variable_value'});
// Pushing an event to the data layer
window.dataLayer.push({'event': 'event_name'});
雖然不使用資料層也能使用 Google 代碼管理工具,但強烈建議您使用。資料層會將第三方指令碼可存取的資料整合至單一位置,進而提高資料使用情形的能見度。此外,這也有助於減少多餘的變數計算和指令碼執行。
使用資料層,您就能控制代碼存取的資料,而不必提供完整的 JavaScript 變數或 DOM 存取權。
資料層的效能優勢可能不直觀,因為更新資料層會導致 Google 代碼管理工具重新評估所有容器變數,並可能觸發代碼,這需要執行 JavaScript。雖然資料層可能遭到濫用,但一般來說,如果資料層似乎是效能問題的來源,容器本身可能有效能問題。資料層會讓這些問題更加明顯。
移除重複和未使用的代碼
如果代碼除了透過代碼管理工具插入,也包含在網頁的 HTML 標記中,就可能出現重複代碼。
未使用的代碼應暫停或移除,而非透過觸發條件例外狀況封鎖。暫停或移除代碼會將程式碼從容器中移除,但封鎖代碼不會。
移除未使用的代碼後,請檢查觸發條件和變數,判斷是否也能一併移除。
暫停的代碼會影響容器大小,但總酬載會比代碼啟用時小。
使用允許和拒絕清單
使用許可和拒絕清單,針對網頁上允許的代碼、觸發條件和變數,設定精細的限制。這項功能可用於強制執行效能最佳做法和其他政策。
允許和拒絕清單是透過資料層設定。
window.dataLayer = [{
'gtm.allowlist': ['<id>', '<id>', ...],
'gtm.blocklist': ['customScripts']
}];
例如,您可以禁止使用自訂 HTML 代碼、JavaScript 變數,或直接存取 DOM。這表示只能使用像素和預先定義的代碼,以及資料層中的資料。雖然這項做法限制較多,但可讓代碼管理工具的導入作業更有效率且安全。
考慮使用伺服器端代碼
建議您考慮改用伺服器端代碼,尤其是想進一步控管資料的大型網站。伺服器端代碼會從用戶端移除供應商程式碼,並將處理作業從用戶端卸載至伺服器。
舉例來說,使用用戶端代碼時,如要將資料傳送至多個 Analytics 帳戶,用戶端必須為每個端點分別發出要求。使用伺服器端代碼時,用戶端會向伺服器端容器發出單一要求,然後將這項資料轉送至不同的 Analytics 帳戶。
請注意,伺服器端代碼僅適用於部分代碼。代碼相容性因供應商而異。
詳情請參閱「伺服器端代碼簡介」。
容器
代碼管理工具通常允許在設定中加入多個執行個體,通常稱為「容器」。一個代碼管理工具帳戶可控管多個容器。
每個網頁只使用一個容器
在單一網頁上使用多個容器,可能會產生額外負擔和指令碼執行作業,導致效能問題。至少會複製核心代碼程式碼本身,因為它是做為容器 JavaScript 的一部分提供,無法在容器之間重複使用。
很少有能有效使用多個容器的情況。不過,如果控制得當,這種做法有時也能發揮作用。例如:
- 包括較輕的「早期載入」容器和較重的「後期載入」容器,而非一個大型容器。
- 為技術能力較低的使用者提供受限容器,並為較複雜的代碼提供限制較少但控管更嚴格的容器。
如果每個網頁必須使用多個容器,請按照 Google 代碼管理工具指南設定多個容器。
視需要使用不同的容器
如果您使用代碼管理工具管理多項資源 (例如網頁應用程式和行動應用程式),使用的容器數量可能會影響工作流程效率。以免影響成效。
如果多個網站的用途和結構相似,則可有效使用單一容器。舉例來說,雖然品牌的行動應用程式和網頁應用程式可能提供類似的功能,但應用程式的結構可能不同,因此透過不同的容器管理會更有效率。
如果過度重複使用單一容器,可能會導致容器變得更複雜、更大,因為必須使用複雜的邏輯來管理代碼和觸發條件。
留意容器大小
容器大小取決於代碼、觸發條件和變數。 雖然小型容器仍可能對網頁效能造成負面影響,但大型容器幾乎肯定會造成負面影響。
最佳化代碼用量時,容器大小不應是最重要的指標。不過,容器大小過大通常是警訊,表示容器未妥善維護,且可能遭到濫用。
Google 代碼管理工具會將容器大小限制在 300 KB 以內,並在容器大小達到上限的 70% 時發出警告。
大多數網站應盡量將容器大小控制在限制範圍內。相較之下,網站容器的中位數約為 50 KB。Google 代碼管理工具程式庫本身壓縮後約為 33 KB。
為容器版本命名
容器版本是容器內容在特定時間點的快照。使用有意義的名稱,並附上簡短說明,指出其中有意義的變更,有助於日後更輕鬆地偵錯效能問題。
標記工作流程
請務必管理代碼變更,以免對網頁效能造成負面影響。
部署前先測試
在部署前測試代碼,找出成效和其他問題。
測試代碼時,請考量下列事項:
- 代碼是否正常運作?
- 標記是否會導致版面配置位移?
- 代碼是否會載入任何資源?這些資源有多大?
- 代碼是否會觸發長時間執行的指令碼?
預覽模式
預覽模式可讓您在實際網站上測試代碼變更,不必先部署至公開網站。預覽模式包含偵錯控制台,可提供代碼相關資訊。
在預覽模式下執行 Google 代碼管理工具時,由於需要額外負擔在偵錯控制台中顯示資訊,因此執行時間會有所不同 (稍微慢一點)。因此,不建議比較在預覽模式和正式環境中收集的 Web Vitals 測量結果。不過,這項差異應該不會影響代碼本身的執行行為。
獨立測試
另一種測試代碼的方法,是設定一個空白網頁,其中包含一個容器,容器內只有一個代碼 (即您要測試的代碼)。這種測試設定較不符合實際情況,且無法偵測到某些問題 (例如代碼是否會導致版面配置位移),但可以更輕鬆地隔離及評估代碼對指令碼執行等作業的影響。瞭解 Telegraph 如何使用這種隔離方法,提升第三方程式碼的效能。
監控代碼成效
Google 代碼管理工具監控 API 可用來收集特定代碼執行時間的相關資訊。這項資訊會回報至您選擇的端點。
詳情請參閱「如何建構 Google 代碼管理工具監控程式」。
容器變更須經核准
第一方程式碼通常會在部署前經過審查和測試。標記也應如此。
其中一種做法是新增兩步驟驗證,要求管理員核准容器變更。或者,如果您不想強制執行兩步驟驗證,但仍想追蹤變更,可以設定容器通知,接收所選容器事件的電子郵件快訊。
定期稽核標記使用情形
使用標記的其中一項挑戰是,標記往往會隨著時間累積:標記會新增,但很少移除。定期稽核代碼是扭轉這種趨勢的方法之一。理想的執行頻率取決於網站代碼的更新頻率。
為每個代碼加上標籤,清楚標明擁有者,就能輕鬆找出負責該代碼的人員,並確認是否仍需要該代碼。
稽核代碼時,請記得清理觸發條件和變數。也常是效能問題的成因。
詳情請參閱「控管第三方指令碼」。