Setting Up Link Tracking

With Cataleya, you now have the ability to track the links used in conversation flow allowing you to have insights about link clicks

This functionality is available in our "Business Plan"

Since it is important to track the link clicks when you are running a campaign to have insights about webpage visits and to identify the success of your campaign, Cataleya uses third party tool Short.io to shorten all the URLs present in the conversational flow for tracking.

The process that Cataleya follows to track the links is the 3 step process. Lets go through each step in detail;

  1. API checks for the Links: On click of 'Deploy' button, our API is called and it checks for all the action blocks where the 'Link Tracking' is enabled by you

  2. URLs sent to Short.io: Once all the URLs that are to be tracked are identified, the same are sent to Short.io for shortening

  3. Short Links received: Short.io then reverts it back with the short URLs that will be visible to the visitors and on click of which the original URL will open up In case of inbound bot, the short URL generated will be generic however unique for each visitor In case of outbound bot, we generate separate requests for each and each recipient of the campaign. For instance if there are 5 URLs that need to be sent to 100 recipients, a total of 500 URLs will be generated.

How does the URL look like?

Here is the snippet of how URLs will look like;

Original Link:

help.cataleya.io

Short URL:

“http://test.catapp.link/vFYjNi”

When a short URL is clicked, this is how the URL is expanded:

“http://help.cataleya.io/?__catbid=9433&__catcid=1&__catvid=1933158&__catvkey=9aa7b077115048039301b6d1fca07f16&__catreid=9aa7b077115048039301b6d1fca07f16”

The following parameters are appended on the URL;

  • Catbid: Identifies the bot ID of the bot from which the dialogue or URL is executed

  • Catcid: Identifies the channel from which the dialog or URL is sent

    • 'catcid = 1' Indicates Web channel

    • 'catcid = 3' Indicates WhatsApp channel

    • 'catcid = 4' Indicates Facebook channel

    • 'catcid = 5' Indicates SMS channel

  • Catvid: Indicates visitor ID at Cataleya level (Every visitor speaking with Cataleya's chatbot is given a unique ID)

  • Catvkey: Indicates visitor key at Cataleya level

  • Catreid: Indicates recipient ID, this helps us identify who was the actual recipient that opened/clicked the link.

In case the channel is WhatsApp or SMS, the recipient ID will be the phone number of the recipient In case the channel is Facebook, the recipient ID will be unique Facebook ID generated by the Facebook Incase the channel is Web, the recipient ID will be same as the visitor key generated at Cataleya level If the channel is WhatsApp or SMS, the entire phone number along with country code will be visible in the URL when expanded from the Short URL

Last updated