동의 관리

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 통합 →