URL Embedding allows you to specify both a div selector within your application or webpage AND a URL where you want Candu content to display.
This is useful for:
When you have a repetitive div selector across multiple pages - once Candu content is embedded in this single div, it will display content on all pages (probably not what you want!)
When you have URL paths that contain variable information meaning URLs are unique for different users/customers
Candu will look for both a div match and URL match to ensure content is displayed in the right place.
Setting Up URL Embeds
From the Candu editor, go to the content that you want to limit to or hide from a certain URL.
Go to Settings > Embed. If you have embedded the content via the Candu Chrome Extension, the div selector will already be populated. If you have manually embedded Candu content via code, you will need to input the div selector manually (the div that is hosting your content).
You can then input the URL so that your content is embedded on the correct pages within your application or hidden from certain pages.
You can also add more than one URL and easily remove once added.
What are Wildcard URLs?
Wildcard URLs provide a way for you to load your Candu content dynamically, depending on the page URL.
As an example, consider the following URL: https://candu.ai/workspaces/678/22
The 678 refers to the unique 'UserID' and 22 to the unique 'OrgID' which are both portions of the URL path that will change depending on the customer or user. The rest of the URL will remain the same.
You can simply replace the variable parts of a URL with an asterisk (*), also known as a wildcard. By adding in an *, you are telling Candu that you want the URL matching to allow that part of the URL to be variable.
When replacing the 'userid' and 'org' portions of the URL with an *, the URL will appear as follows: https://candu.ai/workspaces/**
Another example is when an application offers a different URL per customer such as:
companyname.candu.ai
You can add a wildcard for this use case: *.candu.ai
Setting up Wildcard URLs
The process is the same as adding a standard URL Embed apart from the format of the URLs entered.
Use one asterisk (*) to match one variable in a URL e.g. customername.candu.ai
Use two asterisks (**) to match more than one unique variable e.g https://candu.ai/workspaces/90/78/reports > https://candu.ai/workspaces/**/reports
Use a ? when there is one variable character
⚠️ Please note you cannot test wildcard URLs in preview mode prior to content actually being embedded. We recommend embedding content in a staging environment or creating an 'Only Me' segment for testing purposes.