# OneTrust integration

## Configuration in AB Tasty Platform

You can configure OneTrust consent management directly within the AB Tasty platform through the **Settings > Privacy > Manage Visitor Consent** section using the JavaScript option.

#### Accessing the Configuration

1. Navigate to **Settings** in your AB Tasty dashboard
2. Go to **Privacy** section
3. Select **Manage Visitor Consent**
4. Choose **JavaScript option** for custom consent implementation

### OneTrust Group ID Checking

#### Legacy Implementation

For older OneTrust implementations:

```
javascriptUnwrapCopyreturn typeof window.OnetrustActiveGroups !== 'undefined' && 
       window.OnetrustActiveGroups.includes('C0002') && 
       window.OnetrustActiveGroups.includes('C0003');
```

#### Current Implementation

For recent OneTrust implementations that return comma-delimited strings:

```
javascriptUnwrapCopy// Check for Analytics consent (group 2)
return typeof OnetrustActiveGroups !== 'undefined' && 
       OnetrustActiveGroups.includes(',2,');

// Check for Marketing consent (group 4)
return typeof OnetrustActiveGroups !== 'undefined' && 
       OnetrustActiveGroups.includes(',4,');
```

{% hint style="success" %}
 Using  `.includes(',2,')` prevents false positives (e.g., matching group 12 when checking for group 2).
{% endhint %}

### Platform Configuration Details

#### JavaScript Consent Function Setup

In the AB Tasty privacy settings, you'll need to configure a JavaScript function that returns `true` when consent is granted and `false` when it's not. This function will be called by AB Tasty to determine whether to:

* Activate campaigns
* Collect visitor data
* Set tracking cookies

#### Configuration Options

{% tabs %}
{% tab title=" Single Consent Check" %}

```
javascriptUnwrapCopy// Simple consent check for analytics
function() {
    return typeof OnetrustActiveGroups !== 'undefined' && 
           OnetrustActiveGroups.includes(',2,');
}
```

{% endtab %}

{% tab title="Multiple Consent Categories" %}

```
javascriptUnwrapCopy// Check for both Analytics and Marketing consent
function() {
    return typeof OnetrustActiveGroups !== 'undefined' && 
           OnetrustActiveGroups.includes(',2,') && 
           OnetrustActiveGroups.includes(',4,');
}
```

{% endtab %}

{% tab title="Flexible Consent (Analytics OR Marketing)" %}

```
javascriptUnwrapCopy// Allow if either Analytics or Marketing consent is given
function() {
    if (typeof OnetrustActiveGroups === 'undefined') {
        return false;
    }
    return OnetrustActiveGroups.includes(',2,') || 
           OnetrustActiveGroups.includes(',4,');
}
```

{% endtab %}
{% endtabs %}

## Advanced Configuration Features

### Consent Monitoring

The platform automatically monitors consent changes and will:

* Start campaigns when consent is granted
* Stop data collection when consent is withdrawn
* Resume tracking when consent is re-granted

### Campaign Behavior Options

You can configure how campaigns behave based on consent status:

* **Wait for Consent**: Campaigns don't start until consent is given
* **Show Without Tracking**: Campaigns run but no data is collected until consent
* **Conditional Activation**: Different campaigns activate based on specific consent categories

## Testing Your Configuration

### In AB Tasty Platform

* Use the Preview Mode to test consent scenarios
* Check the Browser Console for consent-related logs
* Verify campaign activation in different consent states

### Browser Testing

```
javascriptUnwrapCopy// Test consent status in browser console
console.log('OneTrust Groups:', OnetrustActiveGroups);
console.log('Analytics Consent:', OnetrustActiveGroups.includes(',2,'));
console.log('Marketing Consent:', OnetrustActiveGroups.includes(',4,'));
```

## Common OneTrust Group Mappings

<table><thead><tr><th width="110.5234375">Group ID</th><th>Category</th><th>Description</th></tr></thead><tbody><tr><td><code>,1,</code></td><td>Strictly Necessary</td><td>Essential website functionality</td></tr><tr><td><code>,2,</code></td><td>Performance/Analytics</td><td>Website analytics and performance</td></tr><tr><td><code>,3,</code></td><td>Functional</td><td>Enhanced website features</td></tr><tr><td><code>,4,</code></td><td>Targeting/Marketing</td><td>Advertising and marketing cookies</td></tr></tbody></table>

### Best Practices for Platform Configuration

### 1. Start Simple

Begin with a basic consent check and gradually add complexity:

```
javascriptUnwrapCopy// Start with this
return typeof OnetrustActiveGroups !== 'undefined' && 
       OnetrustActiveGroups.includes(',2,');
```

### 2. Add Error Handling

```
javascriptUnwrapCopyfunction() {
    try {
        return typeof OnetrustActiveGroups !== 'undefined' && 
               OnetrustActiveGroups.includes(',2,');
    } catch (error) {
        console.error('Consent check error:', error);
        return false; // Default to no consent on error
    }
}
```

### 3. Log for Debugging

```
javascriptUnwrapCopyfunction() {
    const hasConsent = typeof OnetrustActiveGroups !== 'undefined' && 
                      OnetrustActiveGroups.includes(',2,');
    
    console.log('AB Tasty Consent Check:', {
        groups: OnetrustActiveGroups,
        hasConsent: hasConsent
    });
    
    return hasConsent;
}
```

## Validation and Monitoring

After configuration, monitor your setup through:

* **AB Tasty Analytics Dashboard**: Check visitor consent rates
* **Campaign Performance**: Verify campaigns activate correctly
* **Browser Developer Tools**: Monitor console logs for consent events
* **OneTrust Reports**: Cross-reference consent data

This configuration ensures your AB Tasty implementation respects user privacy preferences while maintaining optimal testing capabilities within GDPR compliance requirements.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.abtasty.com/integrations/custom-integrations/onetrust-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.