📖 This guide explains:
What is Custom Scripting?
Custom Scripting allows you to add third-party, non-native scripts to your Flipbook by injecting them into its header and footer tags.
What can you use Custom Scripting for?
You can inject any script into your Flipbook with Custom Scripting, meaning the sky is the limit. Some use cases for Custom Scripting are:
you may have a custom analytics solution you use across your business. Custom Scripting allows you to inject it into your Flipbook,
integrating the same third-party cookie banner experience on your Flipbook, as you do on your website,
implementing a chatbot that allows your visitors to chat to your customer service agents, directly from your Flipbook,
use it to add visual and audio effects to your Flipbook to highlight seasonal promotions, or create an immersive browsing experience.
💡 We offer for ready-built integrations for Adobe Analytics and Google Analytics.
How to enable Custom Scripting on your account
Custom scripting is available on all iPaper accounts, but can only be accessed by account Administrators.
💡 If you’re unsure who your account administrator is, you can easily find out, using this method.
As an account Admin, you need to enable Custom Scripting before you can start injecting your custom scripts into your Flipbook:
From the Flipbook overview view, right-click on either the account, folder, or Flipbook level for which you wish to inject a custom script.
Select Edit settings from the drop-down menu.
Select the Modules tab.
Select Custom Scripting from the vertical menu on the left.
On the Custom Scripting view, select the toggle to enable it. Once enabled, the toggle will turn green.
Once you've clicked on Save changes, you’re ready to start injecting your custom scripts!
Using Custom Scripting with inherited settings
The Inherited Settings feature lets you apply custom scripts across multiple Flipbooks.
Inject a script at the account level, and it will be applied across your iPaper account. Doing so at the folder level will apply the script to all Flipbooks and subfolders within the folder. For individual Flipbooks, inject the script directly at the Flipbook level to limit its scope.
💡 Learn more about how Inherited Settings work:
Why two script fields?
💡 We have designed Custom Scripting as such to allow for the firing of multiple scripts, asynchronously.
We recommend adding scripts to the Scripts field at the Flipbook, folder, or account level. For special cases requiring additional scripts for a specific Flipbook or subfolder, use the Extra Scripts field to differentiate between global and localized scripts.
Additional considerations when using Custom Scripting
Custom Scripting is incredibly versatile in that you can inject almost any kind of third-party script into your Flipbook. When using it, however, there are a few things to be aware of:
We do not recommend Custom Scripts that interact with or alter the Document Object Model (DOM), as they may affect Flipbook performance and cause loading or functionality issues.
⚠️ Scripts that interact with the DOM and are added to the header or footer fields are used at your own risk. iPaper cannot guarantee their functionality or provide support for them. Before using such scripts, contact us for advice on alternative solutions.
For custom-built analytics solutions, the data layer is not directly accessible, as it is with our native Google and Adobe Analytics integrations.
⚠️ To ensure your custom analytics script works correctly, you must create a custom data layer using our JS API. We recommend using the JS API for integration, as event listeners are not officially supported.
💬 If there's anything you're unsure about, or have questions about how you can use Custom Scripting, just reach out to us via the messenger.