独立站技术规范手册LEYUN · SITE SPEC & COMPONENT LIBRARY

独立站 Cookie 同意弹窗组件与同意管理规范

栏目:合规弹窗组件 · 核实更新:2026-11-20 · 模板资产

先说结论本节给出合规弹窗组件中「独立站 Cookie 同意弹窗组件与同意管理规范」的结构模板、字段定义、适配要点与合规边界。模板仅作参考,上线前请自行核验当地法规与平台规则。

适用行业与场景

  • 面向欧盟、英国等 Cookie 法规适用地区的独立站
  • 使用分析、广告、第三方工具而需要取得同意的站点
  • 曾因未经同意加载追踪脚本被投诉或处罚的卖家
  • 需要在同意前完全不加载追踪代码的站点
模板 / 代码片段html
<!-- 同意前不加载任何追踪脚本:脚本在同意后才注入 -->
<div class="cc-bar" id="ccBar" role="region"
     aria-label="Cookie 使用说明" hidden>
  <p class="cc-text">
    本站使用必要 Cookie 以保证页面功能正常;
    经你同意后,我们才会加载统计与广告相关的 Cookie。
    详情见<a href="/privacy/">隐私政策</a>。
  </p>
  <div class="cc-actions">
    <button type="button" class="cc-btn cc-accept" data-cc="all">全部接受</button>
    <button type="button" class="cc-btn cc-reject" data-cc="necessary">仅必要项</button>
    <button type="button" class="cc-btn cc-settings" data-cc="settings">偏好设置</button>
  </div>
</div>

<!-- 偏好设置面板 -->
<div class="cc-modal" id="ccSettings" hidden>
  <div class="cc-modal-in">
    <h2>Cookie 偏好设置</h2>
    <fieldset class="cc-group">
      <legend>必要项(始终启用)</legend>
      <label><input type="checkbox" checked disabled>
        会话保持、购物车、页面安全</label>
    </fieldset>
    <fieldset class="cc-group">
      <legend>统计类</legend>
      <label><input type="checkbox" data-cc-cat="analytics">
        访问统计(${analyticsProvider})</label>
    </fieldset>
    <fieldset class="cc-group">
      <legend>广告类</legend>
      <label><input type="checkbox" data-cc-cat="ads">
        广告投放与再营销(${adsProvider})</label>
    </fieldset>
    <button type="button" class="cc-btn cc-save">保存偏好</button>
  </div>
</div>

<script>
/* 关键:默认不注入任何追踪脚本。
   同意状态由 localStorage 记录,撤回后需再次注入/移除。 */
(function () {
  var CONSENT_KEY = 'cc_consent_v1';
  var bar = document.getElementById('ccBar');
  var saved = null;
  try { saved = JSON.parse(localStorage.getItem(CONSENT_KEY)); } catch (e) {}

  if (saved && saved.necessary) { bar.hidden = true; loadTrackers(saved); return; }
  bar.hidden = false;

  function loadTrackers(c) {
    if (c.analytics && !window.__ga) {
      var s = document.createElement('script');
      s.async = true; s.src = '${analyticsSrc}';
      document.head.appendChild(s); window.__ga = 1;
    }
    if (c.ads && !window.__ads) {
      var a = document.createElement('script');
      a.async = true; a.src = '${adsSrc}';
      document.head.appendChild(a); window.__ads = 1;
    }
  }

  document.querySelectorAll('[data-cc]').forEach(function (btn) {
    btn.addEventListener('click', function () {
      var mode = btn.getAttribute('data-cc');
      var c = mode === 'all'
        ? { necessary: true, analytics: true, ads: true }
        : { necessary: true, analytics: false, ads: false };
      localStorage.setItem(CONSENT_KEY, JSON.stringify(c));
      bar.hidden = true;
      loadTrackers(c);
    });
  });
})();
</script>
字段与参数说明
字段 / 参数类型说明与取值范围
同意状态键文本localStorage 键名,含版本号便于后续更新
必要项固定始终启用,不提供关闭
统计类开关可单独拒绝
广告类开关可单独拒绝
选择粒度枚举全部接受 / 仅必要 / 偏好设置
撤回入口链接页脚提供"修改 Cookie 设置"入口
弹窗角色ARIArole="region" 或 role="dialog"
文案文本说明用途,不做恐吓式表述

SEO 与结构化适配说明

SEO 与结构化适配要点
同意前完全不加载追踪脚本这是判定合规的关键 —— 「先加载再弹窗」在多数解释下不被认定为有效同意
必须提供"拒绝"选项只有"接受"按钮的弹窗不满足要求,且拒绝按钮的视觉权重不应被刻意弱化
提供按类别设置只给全有或全无两档在部分解释下不被认可
同意状态可撤回页脚需提供修改入口,且撤回后要真正停止追踪
必要项与可选项分开列必要项不提供开关,可选项逐类列出
弹窗不得遮挡主要内容首次访问时遮住主内容会影响搜索引擎对页面的评估

合规风险提示

  • 不得把"拒绝"做成需要多次点击才能生效
  • 不得在同意前预加载追踪像素
  • 不得把弹窗做成无法关闭且无替代入口
  • 不得使用恐吓式文案诱导同意
  • 同意记录需可留存以备核查

以下场景不可直接使用本模板,上线前请自行核验当地法规与平台规则。

修改示例

<!-- 修改示例:把"接受 + 关闭X"改为三选项合规形态 -->
<!-- 原始:只有接受与关闭 -->
<div class="cc-bar">
  <p>我们使用 Cookie 改善您的体验。</p>
  <button onclick="acceptAll()">接受</button>
  <button onclick="closeBar()">关闭</button>
</div>

<!-- 修改后:全部接受 / 仅必要 / 偏好设置 -->
<div class="cc-bar" id="ccBar" role="region"
     aria-label="Cookie 使用说明" hidden>
  <p class="cc-text">
    本站使用必要 Cookie 以保证页面功能正常;
    经你同意后,我们才会加载统计与广告相关的 Cookie。
  </p>
  <div class="cc-actions">
    <button type="button" class="cc-btn cc-accept" data-cc="all">
      全部接受</button>
    <button type="button" class="cc-btn cc-reject" data-cc="necessary">
      仅必要项</button>
    <button type="button" class="cc-btn cc-settings" data-cc="settings">
      偏好设置</button>
  </div>
</div>

<!-- 两个容易出错的细节:
     1. 三个按钮的文案明确区分后果,
        "关闭"不告诉用户会发生什么,"仅必要项"告诉了
     2. 视觉权重:拒绝按钮与接受按钮尺寸一致,
        不做成灰色小字链接
        (部分监管解释关注拒绝选项的可达性) -->

FAQ 高频问题

弹窗必须有三个选项吗?
至少要有"接受"和"拒绝",多数解释下还应提供按类别设置的入口。
弹窗要在页面加载时立刻出现吗?
不能遮挡主要内容。可在页面加载后或滚动一定距离后出现,但不能等到用户浏览多个页面之后。
同意状态保存多久?
通常 6 个月。多数法规要求定期重新征求同意,建议在版本更新时一并重新征求。
已有弹窗但仍被投诉?
常见原因是追踪脚本在弹窗出现前就已加载,或者拒绝选项不可达。
版本更新记录2026-11-20:首次发布,按 Google 官方公开文档与公开技术资料整理;后续随搜索引擎规则变化更新。涉及引擎行为的细节以 Google 官方最新文档为准。

声明:本页仅为公开技术规则的整理汇总,不构成优化承诺;涉及搜索引擎行为的描述以 Google 官方最新文档为准,具体站点请以 Search Console 实测数据为准。