Creating links allows you to direct recipients to specific content. Links can also be extended, using recipient data to create dynamic link addresses. Loading images hosted at a third-party source also supports dynamic data fields as part of the address, allowing the loaded image to be different depending on the recipient data stored in Agillic.
- Creating a Link (Email, Web, Print)
- Dynamic Data Fields in Links
- Creating a Link (SMS)
- Disabling Agillic Link Tracking
Creating a Link (Email, Web, Print)
To create a link, go into one of your communications and highlight some of your text. Click the Link panel in the right sidebar to reveal the link configuration interface.
If your HTML template has been designed to utilise 'block parameters', you can access the link configuration interface by hovering over the content block and then clicking the 'i'. Navigate to the relevant panel under Options on the right-hand side.
Accessing the Link configuration on a content block utilising 'block parameters'
When the link drop-down is selected, the following options are available to you:
| UI Copy | Explanation |
| Link to menu item | Link to an Agillic portal page |
| Link to resource | Link to a resource from the Assets Manager such as an image or PDF |
| Link to external site | Link to an external URL (If the URL requires Basic Authentication), you have the option of selecting a predefined configuration from the 'Auth' drop-down |
| Web copy of the email | Link to a web copy of the email which will open in the default browser |
| Social share | Share an email, web page, or an external web page on a social media platform |
| Other (Mailto, FTP) | Other types of links such as links to email addresses (mailto:customerservice@demo.agilliccandy.com) Note: This option does not support merging data fields. |
| PDF link | Link to an Agillic print file |
Mailto with extended predefined parameters
The following string includes a mailto link with predefined parameters for:
- Mailto address
- CC email address
- BCC email address
- Subject line
- Email body
<a href="mailto:email@domain.com?cc=email@domain.com&bcc=email@domain.com&subject=subjectText&body=bodyText">Email</a>
Link URL Parameters
You have the option of defining a custom URL parameter and Agillic Person Data field to be inserted as the value. The parameter will automatically be added to all links contained in the email. In the example below we have adding the URL Parameter 'token', and selecting the Person Data field 'TOKEN_ID' as the value. This will result in '?token={PLACEHOLDER}' being added to all links, where 'Placeholder' represents whatever the recipient may have stored in 'TOKEN_ID'.
Adding a Link URL Parameter named 'token', and selecting the Person Data field 'TOKEN_ID' to be used as the value
Dynamic Data Fields in Links
It's possible to use a Person Data field or Lookup to insert dynamic values as part of a link. The format varies slightly, depending on the context.
Dynamic Data Fields as part of an external Link
In the example below, please replace the placeholder text with the relevant values:
Link - <a href="https://agilliccandy.com/{PLACEHOLDER}">Click here</a>
Example - <a href="https://agilliccandy.com/{FIRSTNAME}">Click here</a>
Dynamic Data Fields as part of an externally hosted image
When merging data from a Data Lookup or Person Data field:
Link - <img src="<persondata>PLACEHOLDER</persondata>">
Example - <img src="<persondata>BRAND_LOOKUP.IMG_URL</persondata>">
Example - <img src="https://agilliccandy.com/images/<persondata>IMG_ID</persondata>">
When merging data from a Unique Lookup:
Link - <img src="<uniquelookup>PLACEHOLDER</uniquelookup>">
Example - <img src="<uniquelookup>BRAND_LOOKUP.IMG_URL</uniquelookup>">
Example - <img src="https://agilliccandy.com/images/<uniquelookup>IMG_ID</uniquelookup>">
Creating a Link (SMS)
Before inserting a link into your SMS, you should first consider if you want to insert a link with or without tracking.
URL with tracking
When using the interface to add a link in an SMS, the link will pass through Agillic first. This allows you to attach Events and track link interaction. Because of this, all links will use the following formats.
In the example below, the placeholder text will be replaced with the relevant values (instance name and tracking code).
Link - https://{PLACEHOLDER}.agillic.eu/web/s/{PLACEHOLDER}
Example - https://agilliccandy-stag.agillic.eu/web/s/t06f8i41V0c
If you have set up a verified domain, the domain name will appear instead. For this to take effect, you will have to enable domain name validation, and contact Agillic Support to make the final necessary changes.
Once fully set up, all links will use this format (placeholders represent the instance name and tracking code):
Link - https://{PLACEHOLDER}/web/s/{PLACEHOLDER}
Example - https://candy.agillic.com/web/s/t06f8i41V0c
Read more about Verified Domains.
URL without Tracking
You can create a link to an external URL even when don't want the link to be modified in any way. Be aware that this results in a loss of tracking and the ability to attach Events. This is useful if you experience issues 'deep-linking' to site or apps due to the parameters being added, or when having a 'clean' link is more important than analytics.
To add a link without Agillic tracking, simply type in the link of the external site without using the link interface.
Example - https://agilliccandy.com/news/great_offer
This will technically send the URL as plain text, but most phones will automatically interpret it is a link, allowing the recipient to click on the URL to visit the page.
Below, you will find the link types available to SMS:
| UI Copy | Explanation |
| Link to menu item | Link to an Agillic 'Portal Page' |
| Link to resource | Link to a resource from the Assets Manager |
| Link to external link | Link to an External URL |
Dynamic Data Fields in SMS Links
It's possible to utilise Person Data and Unique Lookup data as part of links in text messages (SMS).
In the example below, replace the placeholder text with the relevant values:
Link - https://agilliccandy.com/{PLACEHOLDER}
Example - https://agilliccandy.com/{FIRSTNAME}
Example - https://agilliccandy.com/images/{BRAND_LOOKUP.IMG_ID}
Disabling Agillic Link Tracking
If you want to disable Agillic link tracking to stop yourself from interfering with deep links to apps and the like, you have the option to do so on a per domain basis.
With this feature enabled, Agillic will not append Events or apply any redirection to the specified external links.
Create and import a file named 'notrack.txt' containing one domain per line that you wish to disable tracking for. Wildcards (*) are supported, allowing you to simply write 'agillic.com*', matching all sub-pages under 'agillic.com'. You can also place the wildcard in front of the domain to match subdomains to this domain. Please note that if you use "www." in your links, you will also need to add the wildcard in front of the domain to make it work.
Link - agillic.com*
Example - would also match 'agillic.com/preferences/email'
Link - *agillic.com*
Example - would also match 'shop.agillic.com/order_conf'
The file must be placed at the following location. In the example below, please replace the placeholder text with the relevant values (name of your instance):
Link - https://{PLACEHOLDER}-stag.agillic.eu/bcmportlet/webdav/bcm/media/text-resources/
Example - https://agilliccandy-stag.agillic.eu/bcmportlet/webdav/bcm/media/text-resources/
Make sure the publish to Production once you've finished.