同意管理

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

ConsentInputフィールド

フィールド	型	デフォルト	説明
`analytics`	`boolean`	`true`	アナリティクストラッキングを許可
`marketing`	`boolean`	`true`	マーケティング/広告トラッキングを許可

GCM v2マッピング

SDKは同意入力をGoogle Consent Mode v2シグナルにマッピングします：

ConsentInput	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 Customer Privacy API

ヘッドレスストアフロントでShopifyのCustomer Privacy 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'),
  })
}

前へ← ユーザー識別次へReact統合 →