print

Integrating TRUENDO CMP with Any Website (Auto-Blocking and Manual Integration)

Introduction#

This guide provides step-by-step instructions on how to integrate the TRUENDO Consent Management Platform (CMP) into any website. TRUENDO CMP helps you manage cookies and user consent in compliance with privacy regulations like GDPR. You have two integration options:

  1. With Auto-Blocking: Automatically find and permit/block categorized cookies without any coding.
  2. Without Auto-Blocking: Manually connect your cookies to the CMP.

By following this guide, you'll be able to set up TRUENDO CMP on your website efficiently.

1. Prerequisites#

Before you begin, ensure you have the following:

  • Access to Your Website's Code: Ability to edit HTML files and insert scripts.
  • TRUENDO Account: If you don't have one, you'll need to create it.
  • Site ID: Provided by TRUENDO for your specific project.

2. Integration with Auto-Blocking#

A. Create or Log In to Your TRUENDO Account

  1. Access the TRUENDO Console:

  2. Create an Account or Log In:

    • New Users: Click on "Create Account" and follow the registration process.
    • Existing Users: Enter your credentials and log in.

B. Retrieve Your Integration Script

  1. Navigate to the Banner Settings:

    • In the TRUENDO Console dashboard, locate the left sidebar.
    • Click on "Banner" to access banner customization and integration options.

  2. Scroll to Integration via Script:

    • Scroll down to the "Integration via Script" section.

  3. Copy Your Script Snippet:

    • You'll see a script that looks similar to this:

      <!-- TRUENDO Privacy Center -->
<script id="truendoAutoBlock" type="text/javascript" src="https://cdn-geo.priv.center/"YOUR SITE ID"/?id="YOUR SITE ID"></script>
<!-- End TRUENDO Privacy Center -->

    • Note: Replace YOUR_SITE_ID with the actual Site ID provided by TRUENDO.

C. Insert the Script into Your Website

  1. Locate the <head> Section:

    • Open your website's HTML files.
    • Find the <head> tag in your HTML code.

  2. Insert the Script as the First Script:

    • Paste the TRUENDO script immediately after the <head> tag, ensuring it is the very first script on the page.

    Example:

    <html>
<head>
  <!-- TRUENDO Privacy Center -->
 <script id="truendoAutoBlock" type="text/javascript" src="https://cdn-geo.priv.center/"YOUR SITE ID"></script>
  <!-- End TRUENDO Privacy Center -->
  <!-- Other scripts -->
  <script src="other-script.js"></script>
</head>
<body>
  <!-- Your website content -->
</body>
</html>

  3. Save Your Changes:

    • After inserting the script, save the HTML file.

  4. Upload the Updated File:

    • If applicable, upload the updated HTML file to your web server.

You have successfully integrated TRUENDO CMP with auto-blocking enabled.

3. Integration Without Auto-Blocking#

If you prefer to manually manage which cookies are blocked or allowed, follow these steps.

A. Replace the Script

  1. Use the Non-Auto-Blocking Script:

    • Replace the auto-blocking script with the following one:

      <!-- TRUENDO Privacy Center -->
<script id="truendoAutoBlock" type="text/javascript" src="https://cdn-geo.priv.center/"YOUR SITE ID"></script>
<!-- End TRUENDO Privacy Center -->

    • Note: Ensure YOUR_SITE_ID is replaced with your actual Site ID.

  2. Insert the Script into the <head> Section:

    • Similar to the auto-blocking script, place this script within the <head> section of your HTML file.

  3. Save and Upload:

    • Save the changes and upload the updated HTML file to your web server.

B. Manually Connect Your Cookies

  1. Identify Your Cookies:

    • Determine which cookies your website uses that require consent management.

  2. Connect Cookies in the TRUENDO Console:

    • In the TRUENDO Console, navigate to the "Cookies" section.

    • Add each cookie, specifying:

      • Name: The name of the cookie.
      • Category: Assign the appropriate category (e.g., Necessary, Preferences, Statistics, Marketing).
      • Description: Provide a brief description of the cookie's purpose.

  3. Implement Script Controls:

    • Manually adjust your scripts to respect the consent given by the user.
    • Use the TruendoCookieControlCallback function to control script execution based on consent.

    Example:

    <script type="text/javascript">
  function TruendoCookieControlCallback(cookieSettings) {
    if (cookieSettings.statistics) {
      console.log('Statistics cookies enabled.');
      // Initialize statistics scripts
    } else {
      console.log('Statistics cookies disabled.');
      // Disable statistics scripts
    }
  }
</script>
    • Place this script after the TRUENDO CMP script in your HTML code.

  4. Adjust Your Scripts Accordingly:

    • Wrap your script initializations within the appropriate consent checks.
    • Ensure that scripts only run if the user has given consent.

4. Verifying the Integration#

To ensure TRUENDO CMP is correctly integrated:

  1. Clear Browser Cookies:

    • Before testing, clear your browser's cookies to reset consent preferences.

  2. Access Your Website:

    • Open your website in a browser.

  3. Check for the Consent Banner:

    • The TRUENDO consent banner should appear upon visiting the site.

  4. Test Consent Scenarios:

    • Accept All Cookies:

      • Click "Accept All" on the banner.
      • Verify that all scripts and cookies are functioning.

    • Decline Non-Essential Cookies:

      • Choose to accept only necessary cookies.
      • Ensure that non-essential scripts are not running.

    • Customize Preferences:

      • Use the banner to customize consent.
      • Verify that scripts run or are blocked according to the selections.

  5. Use Developer Tools:

    • Open your browser's developer tools.
    • Check the Network tab to see which scripts and cookies are loaded.
    • Verify that only allowed cookies are set.

5. Additional Considerations#

  • Script Loading Order:

    • Always ensure that the TRUENDO CMP script is the first script in the <head> section.
    • This is crucial for auto-blocking to function correctly.

  • Regular Updates:

    • Keep your TRUENDO CMP script updated to the latest version to benefit from improvements and security updates.

  • Compliance:

    • Regularly review your cookie policies and ensure that all cookies are categorized correctly.
    • Stay informed about changes in privacy regulations.

  • User Experience:

    • Customize the appearance and text of the consent banner in the TRUENDO Console to match your website's branding.

6. Support and Resources#

  • TRUENDO Support:

    • If you encounter issues or have questions, contact TRUENDO support at support@truendo.com or simply use the chat bubble.

7. Conclusion#

Whether you choose auto-blocking for ease of integration or manual setup for greater control, TRUENDO CMP provides a robust solution for consent management.

Thank you for choosing TRUENDO CMP for your consent management needs.

End of Guide

×