print

Integrating Global Privacy Platform (GPP) with Your Website Using TRUENDO Consent Management Platform

Introduction#

The Global Privacy Platform (GPP) is a standardized framework developed by the IAB Tech Lab to streamline the management of user privacy consent and preferences for the digital advertising industry, ensuring compliance with regulations like GDPR, ePrivacy Directive, and US state laws.

It provides a unified protocol and consent string for transmitting these signals between websites, apps, and ad tech vendors, simplifying multi-jurisdictional compliance and improving operational efficiency by integrating with Consent Management Platforms (CMPs) to effectively communicate user choices to advertising partners.

1. Prerequisites#

Before you begin, ensure you have the following:

  • TRUENDO Account: Access to the features that support GPP integration.
  • Access to TRUENDO Console: Ability to log in and configure your project.

  • Knowledge of Your Website's Codebase: Ability to edit HTML and script files.


2. Enabling GPP in TRUENDO CMP#

To integrate the GPP with your website, you need to enable GPP in your TRUENDO CMP settings.

A. Access the Advanced Banner Settings

  1. Log In to TRUENDO Console:

  2. Select Your Project:

    • Choose the relevant Organization and Domain from the dropdown menus at the top of the TRUENDO Console.

  3. Navigate to the Banner Section:

    • In the left-hand sidebar, click on "Banner" to access banner settings.

  4. Scroll to Advanced Settings:

    • Scroll down to find the "Advanced" section and click on it to expand the settings.

B. Enable GPP

  1. Locate GPP Settings:

    • Find the section titled "GPP settings".

  2. Enable GPP:

    • Click on the field labeled "Disabled" next to GPP Settings.
    • A popup window will appear.

  3. Switch the Toggle:

    • In the popup, switch the toggle to "Enabled".

  4. Select Your Framework:

    • Choose your framework from the dropdown menu.

  5. Save Your Settings:

    • Click "Save" to confirm your choices.

C. GPP and SmartGeo

If you are making use of TRUENDO's SmartGeo functionality then it is very important to Enable GPP for every geo location that requires it. You will need to follow the above steps for every relevant geo region you have activated.

For more info on SmartGeo click here.


3. Integrating the GPP Script into Your Website#

To complete the integration, you need to insert the stub script into your website's code.

A. Insert the Stub Script

  1. Copy the stub Script:

    • Use the following script:

      <!--   stub from TRUENDO   -->
<script src="https://cdn.priv.center/pc/assets/scripts/stub.js"></script>
<!-- End of stub-->

  2. Paste into Your Website's Head Section:

    • Insert the script at the very top of the <head> section of your HTML page.

B. Ensure Correct Script Placement

  • Important:

    • The stub script must be the first script in the <head> section.
    • This is an GPP requirement to ensure that consent signals are properly communicated before any other scripts load.

  • Example of Correct Script Placement:

    <html>
<head>
  <!--   stub from TRUENDO   -->
  <script src="https://cdn.priv.center/pc/assets/scripts/stub.js"></script>
  <!-- End of stub -->

  <!-- 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 -->

  <!-- Other <script>...</script> -->
</head>
<body>
  <!-- Your website content -->
</body>
</html>

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

4. Verifying the Integration#

To ensure that the GPP integration is functioning correctly:

  • Clear Browser Cache and Cookies:

    • This ensures that previous consent states do not interfere with testing.

  • Access Your Website:

    • Open your website in a browser.

  • Check for Consent Banner:

    • The TRUENDO consent banner should appear.

  • Inspect Consent Signals:

    Please add the following code to your website's HTML body, and verify that stub.js is properly loaded on the page.
    Once implemented, open your browser's developer tools by pressing F12, then navigate to the Console tab.
    Provide consent when prompted, and you'll be able to view the GPP object containing the GPP string data.

        <script>
      window.TruendoEventCallback = (ev) => {
        if (ev.name === 'tru_gpp') {
          __gpp('ping', function (pingReturn, success) {
            if (success) {
              console.log('GPP Return Data:', pingReturn);
            } else {
              console.error('Ping failed');
            }
          });
        }
      };
    </script>

  • Test Vendor Consent:

    • Interact with the consent banner to provide or withhold consent for specific vendors.
    • Verify that your choices are respected by the advertising vendors integrated on your site.

  • Check for Errors:

    • Monitor the browser console for any JavaScript errors related to TRUENDO CMP or GPP.

5. Additional Considerations#

  • Legal Compliance:

    • Ensure that you comply with all legal requirements when integrating GPP, including having proper agreements with vendors.

  • Vendor List Updates:

    • Regularly update your list of vendors (services) in TRUENDO to keep up with changes in your advertising partners.

  • Consent Synchronization:

    • If you have multiple CMPs or consent mechanisms, ensure that they are synchronized to prevent conflicting consent signals.

  • Testing Across Browsers and Devices:

    • Test the integration on different browsers and devices to ensure compatibility.

  • Data Privacy Officer Consultation:

    • Consult with your Data Privacy Officer or legal team to ensure that your implementation meets all regulatory requirements.

6. Conclusion#

By following this guide, you have successfully integrated the GPP with your website using TRUENDO CMP. This integration helps you:

  • Comply with GDPR and ePrivacy Directive: Manage user consent in line with legal requirements.
  • Enhance Transparency: Provide clear information to users about data processing activities.
  • Facilitate Advertising Partnerships: Communicate consent signals to your advertising vendors effectively.

7. Support and Resources#

End of Guide

Note:

  • Always stay updated with any new developments or updates to ensure ongoing compliance and optimal functionality.
  • TRUENDO currently does not support IAB TCF frameworks like tcfcav1 and tcfeuv2 via GPP. To use IAB TCF, please utilize the classic integration method.

If you have any further questions or need additional assistance, please feel free to reach out to TRUENDO support or consult the resources provided.

×