Short Links Settings
eSputnik uses the esclick.me domain for link wrapping by default. However, you can make your communication with subscribers more consistent and recognizable by creating your domain for link shortening, for example — yourbrandname.link.
Creating a Custom Domain
- Go to your account settings → Links → Short links tab and click New custom domain.
- Enter your domain name and click Done. The type, host, target, and SSL certificate are generated automatically; you only need to set up a DNS CNAME record pointing to our secure server.
Creating a Destination Domain
If you need the links to direct users to specific content in the app, create a destination domain.
- Click New destination domain.
- Enter the domain name and upload the associated files:
- For iOS: a TXT file (no larger than 128 KB) containing data in JSON format.
- For Android: a JSON file (no larger than 128 KB).
Creating Paths to Open Links in a Browser/App
The paths specified in links allow you to determine where to open them, in a browser or in a mobile app.
The paths in links are processed in the following channels:
In channels such as Mobile Push and In-App, links to Android apps require special processing settings.
Paths for opening links in Android apps must be added in the association file that you upload to eSputnik, as such settings are made in the AndroidManifest.xml file.
Paths for opening links in iOS applications can also be added to the association file, or specified directly in the eSputnik settings:
Paths examples
You can use the * symbol instead of the domain name — then the path will work for all destination domains created in your account.
| Example | Description |
|---|---|
NOT /unsubscribe* | Links starting with /unsubscribe (e.g., /unsubscribe, /unsubscribe-now) always open in the browser. |
/faq/* | Links that start with /faq/ (e.g., /faq/123, /faq/general) always open in the app. |
/about | The specific path /about opens in the application. This rule does not affect other paths, such as /about/team. |
/contact* | Links that start with /contact (e.g., /contact, /contact-us) always open in the app. |
NOT /*/external* | Links that start with /contact (e.g., /contact, /contact-us) always open in the app. |
/products/*/details | Links that match the pattern /products/[any path]/details (e.g., /products/123/details, /products/toys/details) always open in the app. |
NOT /promo* | Links starting with /promo (e.g., /promo, /promo/offer) always open in a browser. |
Note
The examples above do not work in the system by default — you must specify similar paths in the association files or in the eSputnik settings.
Other features of the functioning of the paths:
- Any other links that do not meet the rules specified in the paths will open in the app.
- An associated file that does not have a path specified cannot be downloaded.
- At least one path must be specified in the account settings.
- The letter u is added to links that open in the application, for example,
https://click.example.com/u/jh3kkj3kl.
Domain Activating and Deactivating
Only one custom domain can be active. If several are registered in the account, the last one created will be added to the top of the list and activated. You can deactivate a domain and activate any of the listed ones instead.
Note
Links wrapped in the esclick.me domain that were sent earlier will continue to work.
Updated 1 day ago