Skip to main content
Important: Please ensure your CMP configuration includes new Vendor ID 1469 for 1st Party data tracking. Additionally, include Vendor ID 301 if cookie sync is enabled. Learn more
The setConsent method is used to manage user consent for data collection and processing. This is essential for compliance with privacy regulations like GDPR, CCPA, and other data protection laws.

​
Syntax

import { setConsent } from 'zeo-collect';

setConsent(properties, callback)

​
Parameters

ParameterTypeRequiredDescription
propertiesObjectYesObject of consent properties and their status
callbackFunctionOptionalCallback to handle function response
The consent properties is a object containing key-value pairs. It includes:

​
track (boolean)

  • true: Allows the SDK to send tracking events (e.g., from setEventProperties, page views).
  • false: Prevents the SDK from sending tracking events.
  • Any additional key-value pairs in the object.
  • Used for tracking consent related to marketing (e.g., newsletterOptIn, personalizationConsent).
  • Passed as query parameters in spl call under z_p.
  • Do not directly control SDK tracking or cookie behavior.
Brand consents are processed and sent to Zeotap independently of the track and cookieSync settings. Even if primary tracking consent is denied, brand consent information can still be transmitted.

​
Usage Examples

import { setConsent } from 'zeo-collect';

setConsent({
    track: true
});

import { setConsent } from 'zeo-collect';

setConsent({
    track: false
});

import { setConsent } from 'zeo-collect';

setConsent({
    zeotapVendorConsent: true,
    abcVendorConsent: false
});

import { setConsent } from 'zeo-collect';

setConsent({
    track: true,
    zeotapVendorConsent: true,
    abcVendorConsent: false
});
NoteIn case of, default consent (opt_out: false) or CMP consent (use_consent: true and check_for_cmp: true) setting primary consent flag will be ignored even if it was sent as part of setConsent method
You can also pass consent with a callback function as shown below. The data parameter is an object that contains status and message which helps to debug the status of the function call. 
import { setConsent } from 'zeo-collect';

setConsent({
    track: true,
    zeotapVendorConsent: true,
    abcVendorConsent: false
}, (data) => {
    // Implement function to handle response
    // {status: "SUCCESS", message: "Consent set successfully"}
});

​
Best Practices

  1. Request Consent Early: Ask for consent before collecting any data.
  2. Provide Clear Information: Explain what each consent category means and how data will be used.
  3. Respect User Choices: Honor the user’s consent decisions and don’t repeatedly ask.
  4. Store Consent Locally: Save consent preferences locally to avoid asking repeatedly.
  5. Allow Easy Updates: Provide an easy way for users to change their consent preferences.
  6. Default to Denied: When in doubt, default to denying consent rather than assuming consent.
Last modified on June 25, 2026