跨境合规弹窗触发规则与状态管理规范
先说结论本节给出合规弹窗组件中「跨境合规弹窗触发规则与状态管理规范」的结构模板、字段定义、适配要点与合规边界。模板仅作参考,上线前请自行核验当地法规与平台规则。
适用行业与场景
- 需要同时部署多种合规弹窗的站点
- 弹窗之间相互干扰、用户体验差的场景
- 需要建立统一弹窗管理机制的模板站
- 多语言站需要按地区显示不同弹窗的站点
模板 / 代码片段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 与结构化适配说明
| 一次只显示一个 | 多个弹窗叠加既影响体验,也让用户无法做出有意义的选择 |
|---|---|
| 阻塞型弹窗优先级最高 | 年龄确认、未成年人限制这类要求,不应被 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 官方最新文档为准。
相关阅读
独立站 Cookie 同意弹窗组件与同意管理规范加州 65 号提案(Prop 65)警示弹窗组件规范GDPR 权利行使与数据通知组件规范欧盟 EPR 环保合规提示组件规范欧盟境内责任人信息弹窗组件规范声明:本页仅为公开技术规则的整理汇总,不构成优化承诺;涉及搜索引擎行为的描述以 Google 官方最新文档为准,具体站点请以 Search Console 实测数据为准。