⚠️ Custom Scripting options are only available to Account Administrators. Unsure who your Account admin is? Here's how to find out.
This article assumes you're familiar with consent management tools. If you're not, this resource provides a good introduction.
📖 This guide explains:
Select the right Consent Management option for your Flipbook
iPaper supports three different consent management options, which can be applied to any Flipbook, or folder:
None: We do not handle consent and do not present any form of Consent Management banner.
Integration: No cookie banner is presented by iPaper, and you will have to integrate your existing consent management platform with iPaper. We assume only “strictly necessary” consent by default.
Basic Banner: iPaper presents a basic cookie consent banner that allows the user to manage consent.
💡 This guide explains how to integrate an existing, third-party consent management platform into your Flipbooks. If you'd rather use iPaper's native Basic Cookie consent banner, see our guide, below:
The advantages of integration
Once consent is given, it applies across your entire domain
Integration ensures that once a visitor consents to cookies on your website, they won’t need to provide consent again when viewing your Flipbook during the same session. Similarly, if they consent in your Flipbook first, they won’t need to do so again when browsing other parts of your website.
Better brand conformity
If you're using a third-party consent management tool, you've likely customized the banner to match your brand's visual identity. By integrating the same consent management solution across your website and Flipbooks, you ensure a consistent brand experience, whether visitors start their session on your Flipbook or website.
Greater control of cookie consent across territories, or brands
Different markets have varying cookie consent requirements, and businesses operating across multiple regions must ensure compliance.
iPaper’s solution allows visitors to accept or decline all cookies but doesn’t offer specific cookie permission controls. Your third-party solution, may offer such customization based on regional requirements.
Integrating third-party consent management with iPaper
The process for integrating your third-party consent management with iPaper Flipbooks depends on how your Flipbook is presented—either on its own subdomain (with a unique URL) or iframed/embedded on another webpage.
⚠️ We recommend testing the third-party consent management implementation on a single Flipbook first, before applying it at the folder or account level, to ensure it works correctly.
Start by reviewing the technical instructions for implementing your third-party consent script in iPaper, available on our documentation site below.
💡 We have specific guides available for UserCentrics, OneTrust, CookieBot, and Cookieinformation implementations.
In standalone flipbooks
1. Enable Custom Scripting
1. Enable Custom Scripting
In order to integrate a third-party solution with iPaper, you’ll need to have custom scripting on your account. To get this enabled, just reach out to our Customer Care team, and we’ll get this activated for you.
Once custom scripting is enabled on your account, you’ll be able to see the Custom Scripting pane, under the Modules tab either on the folder, or account level.
Navigate to the Custom Scripting pane from the left-hand menu.
Paste the integration code supplied by your third-party consent management solution into the Scripts box.
⚠️ In addition to your third-party solutions' integration code, you must also include code that passes user consent levels from your third-party script, to iPaper.
2. Set the correct Consent Management option
2. Set the correct Consent Management option
With Custom Scripting enabled, and your integration code implemented as per the method above, you'll also need to make sure that you've selected the appropriate Consent Management option in iPaper.
Navigate to the Settings pane for your Flipbook and click the General tab.
In the left-hand menu, select Consent Management.
You'll be presented with 3 options: None, Integration, or Basic Banner. You'll want to select the Integration option. That's it!
In embedded / iframed flipbooks
You can integrate a third-party consent management solution when your iPaper Flipbook is embedded within another page on your website.
The process is the same as for standalone Flipbooks, but instead of implementing it via iPaper, you'll need to implement the code directly on the page where the Flipbook is embedded.
💡 If you’re using a tag manager on the page or site, you can inject the consent management tool's code directly through it.
How do I know if I've correctly integrated my third-party consent management solution?
An easy way to double-check whether everything is tracking as it should be, is by checking the Page views statistic for your Flipbook. To do this, navigate to your Flipbook's Statistics pane, then select the Key Statistics pane.
If the Page Views statistics show no data despite accepting all cookie categories on your Flipbook, it likely means the integration was not done correctly. Specifically, the 'allowPerformanceCookies' variable is not being passed to iPaper as true.
We recommend reviewing your integration code, especially the part where the cookie acceptance from your third-party solution is linked to iPaper's performance cookie.
Applying your integration across folders or on a whole account using inherited settings
Using inherited settings, you can implement a third-party consent solution to apply across your entire iPaper account, or to any Flipbooks within a specific folder. To understand more about inherited settings and how they affect your Flipbooks, check out our guide, below.
If you have questions about integrating your third-party consent management, our Customer Care team is here to help. Just reach out to us using the messenger.