Link IDs

Blueshift HTML editor now supports link IDs. With this feature, you can gain more insights into how your customers interact with the emails that you send them. With basic click tracking, you can find out which link your customer clicked on by the url of that link. This approach is not helpful if you have multiple links placed at different positions in the template with the same url. With basic link tracking, you will not know exactly which link the user clicked on. However, with link ids, it is possible to identify exactly which link the user clicked. Each link is assigned a unique ID, which makes it possible to identify the link, even if it shares the same url with other links.

**Note: Link ids currently do not support dynamic content because link ids are assigned at the time of template creation.  Thus, if link ids is enabled and there is any liquid in the shared asset or email template, the user should check if the liquid still looks correct after save.

Link ID Fields:

  • Link ID: The number that is unique for every link within a template. It is denoted by “data-bsft-link-id” attribute present on the “<a>” and “<area>” tags. Please note that this number is automatically generated and should never be edited manually. Whenever a new link is created, make sure that this field is empty or not present at all. Also, note that the link IDs for links inside a shared asset are denoted by the “data-bsft-link-ids” attribute present on the “<shared_asset>” tag.
  • URL: The url that the user is directed to when the link is clicked. It is denoted by the “href” attribute by the “<a>” and “<area>” tags. Please note that if the “href” attribute of a tag is not provided or is empty, a link id will not be assigned to that particular tag.
  • Description: The description text of the link. It is denoted by the text between the “<a>” tags or the “alt” attribute of the “<img>” and “<area>” tags.
  • Group Name: This field allows you to group links. It is denoted by “data-bsft-group-name”. This field is optional and can be set if you feel the need to assign a group to a link.
Caution: Ensure that you are careful when you work on HTML templates with the link ID feature enabled. If you accidentally overwrite the system generated link ID, it can prevent the feature from working as desired. 


Please note that the link ID of a link remains the same until it’s url, description, or group name is changed.  In the image below, you will see what a template with a link looks like before you save it. 



In the Figure 2 image below, you will see what it looks like after it is saved. Note that the link ids are assigned when the template is saved.



 In Figure 3 image below, see how a group name is added to a link. The group name has been added, but the change has not been saved yet. Screen_Shot_2019-09-04_at_9.46.08_PM.png


Figure 4 image below shows what the template looks like after it has been saved. The link id of a link changes if it’s url, group name or description is changed. In this case, it changed because a group name was added.



Link IDs with Shared Assets


Link IDs are also assigned to links in shared assets, but they work a little differently. In the Figure 5 image below, see what the content of a shared asset looks like before it is saved. 


 Figure 6 shows what it looks like after it is saved. Note that the link id appears like “{{ bsft_link_<LINK_ID> }}”. This is because the link ID is written in Liquid in shared assets, which is rendered when the shared asset is added to a template. The link IDs in shared assets also change when the url, group name or description of the link changes.


Figure 7 shows what a template looks like when you add the shared template from Figure 6 to a template and shows an unsaved version. 



Figure 8 below shows what it looks like after it is saved. The link ids field shows how the liquid link IDs inside the shared asset content are rendered. When the link ids in a shared asset are changed, the link ids are automatically updated in all the templates accessed by the shared asset.



Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request