同意管理
SDK 的 setConsent() 方法随时更新同意状态。信号映射为 Google Consent Mode v2 格式并包含在每个事件负载中。
setConsent() API
setConsent()
// Grant both analytics and marketing
converlay.setConsent({ analytics: true, marketing: true })
// Deny marketing (e.g., user declines cookie banner)
converlay.setConsent({ analytics: true, marketing: false })
// Update a single signal without affecting the other
converlay.setConsent({ marketing: false })同意输入字段
| 领域 | 类型 | 默认 | 描述 |
|---|---|---|---|
analytics | boolean | true | 允许分析跟踪 |
marketing | boolean | true | 允许营销/广告跟踪 |
GCM v2 映射
SDK 将您的同意输入映射到 Google 同意模式 v2 信号:
| 同意输入 | GCM v2 信号 |
|---|---|
analytics | analytics_storage |
marketing | ad_storage |
marketing | ad_user_data |
marketing | ad_personalization |
默认同意(默认拒绝)
默认情况下,analytics 和 marketing 均为 true。对于符合 GDPR 的区域,在拒绝同意的情况下进行初始化:
Deny by default
const converlay = createConverlay({
shopDomain: 'my-store.myshopify.com',
consent: {
analytics: false,
marketing: false,
},
})事件依然火爆
无论同意状态如何,SDK 都会发送事件。同意信号包含在有效负载中,Converlay 的服务器使用它们来决定哪些目标平台接收每个事件。这确保了一旦获得同意就可以缓冲和转发事件。
Shopify 客户隐私 API
如果您的无头店面使用 Shopify 的客户隐私 API,您可以直接同步同意更改:
Shopify integration
// Listen for Shopify Customer Privacy API consent changes
if (window.Shopify?.customerPrivacy) {
window.Shopify.customerPrivacy.subscribe(
'visitorConsentCollected',
(event) => {
converlay.setConsent({
analytics: event.analyticsAllowed,
marketing: event.marketingAllowed,
})
}
)
}第三方同意管理者
对于 OneTrust、Cookiebot 或类似的同意管理器:
OneTrust example
// OneTrust example
window.OptanonWrapper = () => {
const groups = window.OnetrustActiveGroups || ''
converlay.setConsent({
analytics: groups.includes('C0002'),
marketing: groups.includes('C0004'),
})
}