Step 1: Add Candu Script Tags
To get started adding Candu content into your application, you will need to add the Candu script tag into the <head> of your site to give Candu permission to embed content.
To find your Candu Script, go into the Candu Dashboard Settings > Installation tab from the top bar menu. Copy the top code block as seen below:
It will look something like this:
Each installation script will have a unique Client Token. The Client Token is used to access Content via the Candu SDK. This can also be found from the Workspaces tab under Access Keys.
Please note: If you are intending to send Candu user data via an integration like Segment.com, you will also need to pass us through UserIDs via the install script. We need a unique identifier so we can map and identify Users between your application and the third-party integration.
It is most common to use an ID which is usually a number like '7480' but if you do not assign IDs like this, you can alternatively use email addresses as the unique identifier.
Step 2: Whitelist Your Domains
Before any content can be added or published, you must whitelist all domains where you want Candu content to appear.
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. For example if you want to use Candu on lots of different pages within your product or across multiple domains, you can simply put a * as a domain.
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.
Once you've added the script tag to the head of your site and whitelisted your domains, you can starting creating Candu content and use the Candu Chrome Extension to embed content to any existing <div> on the page.
Guides on Previewing, Publishing & Embedding Content.
Step 3: Send Candu Data for Segmentation/Variables (Optional)
If you are wanting to personalize your Candu content using Segmentation and/or Variables, you will need to either send us data directly via the install script, Webhooks or connect a third-party data source like Segment.com.
Full guide on setting up segmentation is here.
We also recommend setting up Signed Identities if ensure your user data is as secure as possible. Note: only workspace Owners and Admins can enable/disable Signed Identities.
ℹ️ Can't get content to appear? Check our Troubleshooting guide for potential resolutions. You can always contact us at [email protected]