OneTrust

Configure the Freshpaint Web SDK to automatically sync with your user's consent elections

OneTrust is a privacy and security provider that offers a consent management product to stay compliant with regulations such as GDPR and CCPA/CPRA.

OneTrust allows customers to create custom consent categories, such as marketing and analytics, to group third-party scripts. Freshpaint supports mapping your desired destinations to OneTrust consent categories to ensure that your users' data only goes to the analytics and marketing platforms they consent to.

Prerequisites

This guide assumes you have already set up the Freshpaint Javascript SDK and set up at least one data destination in the Freshpaint app. If not, follow these guides to get set up

• Installing the Freshpaint Javascript SDK

• Configuring a Destination

It is also necessary to mark the Freshpaint SDK script and cookies as essential in OneTrust for full functionality. If it is not, Freshpaint will not be able to manage user session data effectively resulting in lower quality data in downstream analytics platforms.

Installation

Admin Console (Beta)

Contact your Freshpaint rep or email [email protected] if you'd like to be included in the Beta.

The Consent Management UI gives you the ability to categorize all of your destinations into OneTrust-specific consent categories.

Navigate to the Consent Management section on the sidebar and select OneTrust > Configure to begin configuring the integration.

You can choose between an opt-in and opt-out consent model:

• Opt-in: Defaults to not sending events to destinations until the user has given consent

• Opt-out: Defaults to sending events to destinations unless the user opts out

Destinations will be given a default categorization that you can change by updating the Consent Category drop down menu.

The category mapping is as follows:

• C0001: Essential

• C0002: Performance

• C0003: Functional

• C0004: Targeting

• C0005: Social Media

If you have custom categories you would like to use for a Freshpaint destination, please contact your Freshpaint rep or email [email protected].

When the configuration matches your specifications, click the Publish button to save the changes.

Navigate back to the Consent Management page and toggle the OneTrust integration to Enabled. Note: all destinations need to be categorized before enabling the integration.

Enabling the Consent Management integration can impact what data is sent to destinations. Ensure you have it configured properly and have the consent manager installed on your websites.

Manual (Freshpaint Web SDK Initialization)

The OneTrust integration can be configured within the Freshpaint Javascript SDK's init function call by passing in an object that maps all Freshpaint Destinations to OneTrust categories. Make sure you double check your consent category labels in the OneTrust portal.

freshpaint.init("<environment_id>", {
  "consent_management": {
    "onetrust": {
      "category_mapping": {
        // You may have configured your OneTrust categories to be
        // different from C0001, etc.
        "C0001": ["Mixpanel", "Google Analytics 4 Proxy"],
        "C0002": ["Facebook Pixel"]
      }
    },
    // consent_model: optional, defaults to "opt-in"
    // used if Freshpaint SDK loads prior to your consent manager
    // options:
    // - "opt-in" means all destinations are disabled by default
    // - "opt-out" means all destinations are enabled by default
    "consent_model": "opt-out"
  }
})

Any destinations not provided at initialization will be disabled for both Autotrack and Precision Tracking events.

Use freshpaint.set_config({debug: true}) when setting this up for the first time to get console warnings for misconfigurations.