What is a Source?
Last updated
Last updated
Source definitions from the bot linkAs the name implies, the “source” is the place from where the user navigated to your bot. For example, if you placed a bot link in a Telegram channel, the source for users who clicked this link and started the bot would be your Telegram channel.
You can read more about why it is important to understand where the user came from in our blog.
We introduced the concept of a “source” for easier and quicker reporting. Each user can have only one source at a time (though it can change later, and how to handle this is described in the article on attribution models).
The source is determined from the data in the start parameter.
You can read about what the start parameter is in this section.
Since a single bot link can contain more than one parameter, we added the ability to set rules for determining the source. In the example image, the user's source will be “google”:
Source determination settings depend on the settings for processing the start parameter.
You can set up source determination rules for each bot individually. To do this, go to the "My Bots" section and select the desired bot. On the bot information page, find the "UTM Tags" (start processing rules) section and go to the source determination settings.
The settings page consists of two parts:
Settings Form (described below)
Preview Results: When you change the settings, you will see how various links will be processed and how the source will be determined (marked with a source tag ). You can add your own example links.
This determines how the source will be identified. There are three options available:
Auto — This is the default value.
The system will automatically select the required parameter. If the parameter name contains the word “source,” this parameter will be chosen; otherwise, the first parameter in the list will be taken.
Allowed Parameters
You can specify your list of parameters. When such a parameter name is found, it will be marked as the source.
Forbidden Parameters
You can specify a list of parameters that will not be considered in determining the source. The system will choose a parameter containing the text “source” or simply the first parameter in the list.
