限制部署代碼

雖然我們不建議使用 Google 代碼管理工具限制代碼類型，但基於各種原因，您可能需要限制網站上部署的代碼類型。舉例來說，有些網站擁有者可能基於程式碼穩定性或資料收集方面的考量，不希望 Google 代碼管理工具使用者在網站上加入特定代碼。本文說明如何在代碼管理工具中限制代碼部署作業。

如要控制網頁上允許使用哪些代碼、觸發條件和變數，請在資料層中使用 gtm.allowlist 和/或 gtm.blocklist 鍵。這些鍵會覆寫容器中的任何設定。在正確加入封鎖清單後，即使您已將代碼、觸發條件和變數設為在 Google 代碼管理工具中觸發，這些項目也不會觸發。

以下範例示範如何使用許可清單和封鎖清單初始化資料層。這兩種清單為選用，您可以單獨或搭配使用 (如圖所示)。兩個清單都必須是 Array 類型，且清單中的值必須是 String 類型。在觸發任何代碼之前，應將這些值推送至資料層：

<script>
window.dataLayer = window.dataLayer || [];
dataLayer.push({
  'gtm.allowlist': ['<id>', '<id>', ...],
  'gtm.blocklist': ['<id>', '<id>', '<id>', ...]
});
</script>

清單中的每個 ID 都對應至特定標記、觸發事件或變數類型，或類型類別。類別代表具有相同功能的代碼、觸發條件和變數群組。舉例來說，所有可將像素傳送至非 Google 網域的代碼都會具有 nonGooglePixels 類別。類別可用於封鎖目前和未來代碼、觸發條件和變數中的功能。

請務必瞭解管理許可清單和封鎖清單的規則：

1. 許可清單：設定許可清單後，只有「屬於」許可清單的相關代碼、觸發條件和變數才會執行，可以是明確的 (使用類型 ID)，也可以是隱含的 (清單中包含「所有」類別)。
2. 封鎖清單：設定封鎖清單後，只有在代碼、觸發條件和變數「不在」封鎖清單中時，系統才會執行這些項目，不論是明確 (透過類型 ID) 或隱含 (在清單中包含「任何」類別) 皆然。
3. 封鎖清單會覆寫許可清單 一旦設定這兩項條件，系統會優先採用封鎖清單。您可以為某類別的標記使用許可清單，並為該類別中的特定標記使用封鎖清單，但反之則不成立。您「無法」針對標記類別使用封鎖清單，以及該類別中特定標記的許可清單。
4. 類別之間有關係 有些類別與其他類別有關係。舉例來說，可執行非 Google 指令碼的代碼 (依定義) 可以傳送非 Google 像素。因此，封鎖 nonGooglePixels 也會自動封鎖 nonGoogleScripts。屬於這兩個群組的所有代碼、觸發條件和變數都會遭到封鎖。

下表列出可用的代碼、觸發條件和變數、其類型，以及其所屬的類別：

下表列出可用的類別，以及這些類別與其他類別的關係。「自動加入白名單」欄代表當該列的類別也加入白名單時，會隱含加入白名單的類別清單。同樣，「Block Lists Automatically」資料欄代表類別，當來自該資料列的類別列入封鎖清單時，系統會隱含封鎖該類別的類別。