用文件夹统一管理 GTM 与追踪代码

先确认共同配置范围与权限

多张页面共用一组 GTM 或追踪代码时，把它放在这些页面共同所属的文件夹。只属于单页的代码，应在该页编辑器管理。文件夹配置会作用于全部子文件夹，以及以后在该范围内创建的页面。

在“通用设置管理”保存配置，需要文件夹可编辑权限。立即把脚本应用到已发布页面，还需要对全部目标页面拥有发布权限。任一目标页面权限不足都会阻止这次线上应用。若配置已经保存，应交给具备相应权限的发布人更新线上脚本，或在其下一次正常发布页面时应用。修改前先确认影响页面、计测负责人和变更内容。

把需要共用脚本的页面放进文件夹

1. 在页面列表工具栏选择“新建 → 新文件夹”；需要子文件夹时，使用目标文件夹行末的 ··· → 新文件夹。
2. 把页面拖到目标文件夹行或面包屑上，也可使用页面行末的 ··· → 移动到。
3. 检查上下级目录，明确哪些页面会共用相同代码。

例如上层保存全站 GTM，下层保存特定活动追踪代码。移动已发布页面前也要检查新目录的继承范围。删除文件夹会同时删除其中的子文件夹和页面；仅为整理目录时，先移出需要保留的页面再考虑删除。

添加 GTM 容器 ID

1. 打开文件夹行末的 ··· → 通用设置管理。
2. 在“脚本设置”选择“添加 GTM 容器”。
3. 填写易识别的名称和实际使用的“GTM 容器 ID”。
4. 检查内容与列表顺序；未保存的修改尚未生效。

ID 形式例如 GTM-ABC1234，这里只是示例，需要替换成你们的真实 ID。无需把 GTM 整段代码粘贴到 ID 栏。位置显示为“自动”，系统会放到所需位置。依赖 GTM 的代码排在它后面，但仍要在最终页面验证异步加载后的实际运行。

为自定义代码选择正确位置

1. 在同一窗口选择“添加自定义代码”，填写名称与代码。
2. 核对代码提供方的安装要求，选择“head 内”“body 开头”或“body 结尾”。
3. 确认它与现有脚本、GTM 内已配置标签没有重复。

head 内应放置合法的头部内容，例如 <script>、<style>、<meta>。纯文本、<div> 或 <img> 可能被浏览器挤到 body，导致线上脚本更新失败。出现提示时，修正内容或按用途改选 body 位置。不要放入不能公开给浏览器的密钥或服务端凭据。

保存后核对线上更新结果

1. 确认影响目录与代码后，点击“保存”。
2. 没有已发布页面时确认保存成功；有已发布页面时，继续查看线上更新结果、更新数量和失败数量。
3. 若提示权限不足，检查文件夹可编辑权限，以及全部目标页面的发布权限。由具备相应权限的负责人点击“更新线上页面”应用配置。
4. 若是个别页面更新失败，修复原因后点击“重试更新线上页面”；若提示本次只处理了部分页面，再用“更新线上页面”继续处理。

配置可能已保存，但线上反映失败；这些页面仍可能运行旧脚本，不能只看到“已保存”就结束。这里更新的是文件夹脚本，不替换页面正文，也不把未发布草稿上线。重试文件夹脚本更新时，不需要为此发布无关的正文修改。

理解多层继承与重复加载

页面会依次带上上层目录到所在目录的代码，子文件夹配置不会替换父级配置。上层为全站 GTM、下层为活动专用代码时，活动页面会同时继承两者。

如果父子目录都放了同一个 GTM 或标签，可能造成重复运行。新增之前先查看上级配置。共同代码应放在与作用范围匹配的层级；单页例外使用下方的停用方式。移动页面调整目录后，也要重新检查实际继承和公开网址，不能只看列表位置。

在单页核对来源或停用继承脚本

1. 在页面编辑器左侧打开“资源 → 代码”。
2. 在“继承自目录”查看脚本名称和来源文件夹。
3. 只需在当前页面停用时，关闭对应行开关；修改脚本内容则回到来源文件夹的“通用设置管理”。
4. 页面自己的代码在下方 Head 脚本或 Body 脚本中编辑并保存。要让这些修改上线，还需由有发布权限的人重新发布页面。

继承脚本开关只影响当前页面，不会删除文件夹中的代码。未发布页面切换开关需要编辑权限；已发布页面还需要发布权限，切换后要检查线上更新结果。文件夹的线上更新不会顺带应用尚未发布的页面自有代码。重新发布自有代码时，也要审核本次一起发布的正文修改。

检查脚本行为、重复与更新遗漏

用桌面和手机打开最终网址，由开发或计测负责人核对请求和接收结果。看到代码存在，不代表计测成功。导出 HTML 时可通过注释标记辨认文件夹脚本；结合导出检查与安装检查核对代码和数据链路。