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

跨境合规弹窗触发规则与状态管理规范

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

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

适用行业与场景

  • 需要同时部署多种合规弹窗的站点
  • 弹窗之间相互干扰、用户体验差的场景
  • 需要建立统一弹窗管理机制的模板站
  • 多语言站需要按地区显示不同弹窗的站点
模板 / 代码片段html
<!-- 统一弹窗调度器:按优先级与地区决定显示哪一个 -->
<script>
(function () {
  /* 优先级:必须先于其他弹窗显示的合规要求在前 */
  var RULES = [
    {
      id: 'age',
      priority: 10,
      scope: 'all',
      requires: '${ageRequired}',       /* 该品类是否需要年龄确认 */
      requiresConsent: true,
      blocking: true                    /* 阻塞页面交互 */
    },
    {
      id: 'prop65',
      priority: 20,
      scope: 'US-CA',
      requires: '${prop65Required}',
      requiresConsent: false,
      blocking: false
    },
    {
      id: 'cookie',
      priority: 30,
      scope: 'regions-requiring-consent',
      requires: '${cookiesRequired}',
      requiresConsent: true,
      blocking: false
    },
    {
      id: 'epr',
      priority: 40,
      scope: 'EU',
      requires: '${eprRequired}',
      requiresConsent: false,
      blocking: false
    }
  ];

  var STORE = 'compliance_state_v1';
  var state = {};
  try { state = JSON.parse(localStorage.getItem(STORE)) || {}; } catch (e) {}

  function region() {
    /* 由服务端按 IP 判断后写入,避免前端判断不准 */
    return document.documentElement.getAttribute('data-region') || 'GLOBAL';
  }

  function inScope(rule) {
    if (rule.scope === 'all') return true;
    if (rule.scope === 'EU') return ['DE','FR','ES','IT','NL','PL'].indexOf(region()) >= 0;
    if (rule.scope === 'US-CA') return region() === 'US-CA';
    if (rule.scope === 'regions-requiring-consent') {
      return ['EU','UK','CH','NO','BR'].indexOf(region()) >= 0;
    }
    return true;
  }

  var queue = RULES
    .filter(function (r) { return r.requires && inScope(r); })
    .filter(function (r) { return !state[r.id]; })
    .sort(function (a, b) { return a.priority - b.priority; });

  /* 每次只显示一个,关闭后再显示下一个 */
  function next() {
    var r = queue.shift();
    if (!r) return;
    var el = document.getElementById(r.id + 'Modal');
    if (!el) return next();
    el.hidden = false;
    if (r.blocking) document.body.classList.add('modal-blocking');
    el.querySelectorAll('[data-close]').forEach(function (b) {
      b.addEventListener('click', function () {
        el.hidden = true;
        document.body.classList.remove('modal-blocking');
        state[r.id] = true;
        try { localStorage.setItem(STORE, JSON.stringify(state)); } catch (e) {}
        next();
      });
    });
  }
  next();
})();
</script>

<!-- 地区判定由服务端写入 html 标签:
<html data-region="US-CA"> -->
字段与参数说明
字段 / 参数类型说明与取值范围
弹窗 ID文本唯一,与组件根元素 id 对应
优先级数值数值小的先显示
适用范围枚举all / EU / US-CA / 特定地区
触发条件布尔按品类与页面类型配置
是否阻塞布尔是否阻止页面交互
状态存储键文本统一版本号,便于规则更新时重新征求
地区判定方式说明服务端按 IP 判断并写入属性

SEO 与结构化适配说明

SEO 与结构化适配要点
一次只显示一个多个弹窗叠加既影响体验,也让用户无法做出有意义的选择
阻塞型弹窗优先级最高年龄确认、未成年人限制这类要求,不应被 Cookie 弹窗延后
地区判定放服务端前端按语言或时区判断地区不可靠,会漏掉真实用户所在辖区
状态集中管理统一存储键便于规则更新后统一失效
非阻塞型弹窗可延后展示型提示类可在用户停留后再出现
每个弹窗都能被关闭没有关闭路径的弹窗在部分检查中直接判为不合规

合规风险提示

  • 不得用前端语言推断法域
  • 不得把多个合规弹窗同时叠加显示
  • 不得让弹窗无法关闭
  • 不得在同一弹窗里混入营销内容
  • <!-- 修改示例:把规则从硬编码改为按站点配置驱动 --> <!-- 原始:每个弹窗独立判断,互相不知道对方存在 --> <script> if (needAge) showAge(); if (needCookie) showCookie(); </script> <!-- 修改后:统一规则表 + 优先级队列 --> <script> var RULES = [ { id: 'age', priority: 10, scope: 'all', required: ${ageRequired} }, { id: 'prop65', priority: 20, scope: 'US-CA', required: ${prop65Required} }, { id: 'cookie', priority: 30, scope: 'EU,UK,CH', required: ${cookiesRequired} } ]; function region() { return document.documentElement.getAttribute('data-region') || 'GLOBAL'; } function inScope(scope) { if (scope === 'all') return true; return scope.split(',').indexOf(region()) >= 0; } var queue = RULES .filter(function (r) { return r.required && inScope(r.scope); }) .sort(function (a, b) { return a.priority - b.priority; }); (function next() { var r = queue.shift(); if (!r) return; var el = document.getElementById(r.id + 'Modal'); if (!el) return next(); el.hidden = false; el.querySelectorAll('[data-close]').forEach(function (b) { b.addEventListener('click', function () { el.hidden = true; var st = {}; try { st = JSON.parse(localStorage.getItem('cs')) || {}; } catch (e) {} st[r.id] = true; localStorage.setItem('cs', JSON.stringify(st)); next(); }); }); })(); </script> <!-- 关键改进: 1. 规则集中在一张表里,新增量多语言市场时 只需加一行 scope,不必改逻辑 2. 优先级决定显示顺序, 阻塞型合规要求排在展示型之前 3. 串行显示,一次只出一个弹窗 4. 地区由服务端按 IP 判断后写入 data-region, 避免前端按语言推断导致的辖区误判 这四点让"多弹窗打架"这个必然出现的问题变得可控。 -->
  • 规则变更后需让旧状态失效并重新征求

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

修改示例

<!-- 修改示例:把规则从硬编码改为按站点配置驱动 -->
<!-- 原始:每个弹窗独立判断,互相不知道对方存在 -->
<script>
if (needAge) showAge();
if (needCookie) showCookie();
</script>

<!-- 修改后:统一规则表 + 优先级队列 -->
<script>
var RULES = [
  { id: 'age', priority: 10, scope: 'all', required: ${ageRequired} },
  { id: 'prop65', priority: 20, scope: 'US-CA', required: ${prop65Required} },
  { id: 'cookie', priority: 30, scope: 'EU,UK,CH', required: ${cookiesRequired} }
];

function region() {
  return document.documentElement.getAttribute('data-region') || 'GLOBAL';
}
function inScope(scope) {
  if (scope === 'all') return true;
  return scope.split(',').indexOf(region()) >= 0;
}

var queue = RULES
  .filter(function (r) { return r.required && inScope(r.scope); })
  .sort(function (a, b) { return a.priority - b.priority; });

(function next() {
  var r = queue.shift();
  if (!r) return;
  var el = document.getElementById(r.id + 'Modal');
  if (!el) return next();
  el.hidden = false;
  el.querySelectorAll('[data-close]').forEach(function (b) {
    b.addEventListener('click', function () {
      el.hidden = true;
      var st = {};
      try { st = JSON.parse(localStorage.getItem('cs')) || {}; } catch (e) {}
      st[r.id] = true;
      localStorage.setItem('cs', JSON.stringify(st));
      next();
    });
  });
})();
</script>

<!-- 关键改进:
     1. 规则集中在一张表里,新增量多语言市场时
        只需加一行 scope,不必改逻辑
     2. 优先级决定显示顺序,
        阻塞型合规要求排在展示型之前
     3. 串行显示,一次只出一个弹窗
     4. 地区由服务端按 IP 判断后写入 data-region,
        避免前端按语言推断导致的辖区误判
     这四点让"多弹窗打架"这个必然出现的问题变得可控。 -->

FAQ 高频问题

弹窗之间会打架吗?
会。Cookie 弹窗和年龄确认同时出现时,用户不知道该先做哪个。用优先级队列串行化即可解决。
地区判定一定需要服务端吗?
准确性要求高时是的。服务端按 IP 判断并写入 html 属性是最稳妥的做法。
一个弹窗要保存状态吗?
同意类与确认类需要。展示类提示每次出现也无妨,但频繁出现会干扰体验。
这些弹窗会不会影响 SEO?
只要内容在 HTML 源码中且不遮挡主要内容,对抓取与索引没有负面影响。
版本更新记录2026-11-20:首次发布,按 Google 官方公开文档与公开技术资料整理;后续随搜索引擎规则变化更新。涉及引擎行为的细节以 Google 官方最新文档为准。

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