ConverlayConverlay

同意管理

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 })

同意输入字段

领域类型默认描述
analyticsbooleantrue允许分析跟踪
marketingbooleantrue允许营销/广告跟踪

GCM v2 映射

SDK 将您的同意输入映射到 Google 同意模式 v2 信号:

同意输入GCM v2 信号
analyticsanalytics_storage
marketingad_storage
marketingad_user_data
marketingad_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'),
  })
}