Installing Candu via Google Tag Manager

This guide will walk you through adding Candu to an individual page using Google Tag Manager.

Google Tag Manager is a tag management system which allows users to create and manage tags (little snippets of code) without a developer. Tags can be embedded in your website’s JavaScript or HTML to do different things, like track analytics, run ads, or--in our case--display content built in Candu.

⚠️ Ad blockers can block content that uses Google Tag Manager. For essential content, we recommend using an installation method that does not require GTM.

Steps for Adding Candu via GTM

Start by opening your organization's Google Tag Manager, or sign up for a new account. Make sure Google Tag Manager is pointing to the page where you want to install content. If it's not, work with a developer and follow the installation steps.

To start adding Candu to your page, click "New Tag" on the GTM dashboard, then select "Tag Configuration" and scroll until you find the "Custom HTML" option.

Google Tag Manage to embed Candu content, product adoption

In the textbox labeled "HTML", add the code snippet that is stored in Settings > Installation from your Candu Dashboard as seen below:

product adoption, Embed Candu content with Google Tag Manager

When you're done, you should see something like this in GTM:

Google Tag Manager Script Install with Candu, product adoption

Once you've added your code and whitelisted your site, you can add a trigger. We recommend using the All Pages > Page View option to ensure Candu content appears for all users.

Trigger GTM tags for your Installation with Candu, product adoption

Be sure to Save your work! When everything looks good, click Submit to publish.

Whitelisting Your Page

Before any content can be added or published, you must whitelist your page within Candu.

  • Go to Settings > Workspaces

  • Add your domain to the list under "Whitelisted Domains"

  • Please note that you can use wildcards here as needed. Add a * before or after the URL to add a wildcard

If you encounter CORS errors when publishing content, it likely has to do with whitelisting. To check, try whitelisting just the wildcard and clear the cache.

For more troubleshooting tips, check out our Installation Troubleshooting Guide.

Did this answer your question?