Short Links Settings

Yespo 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

  1. Go to your account settings → Links → Short links tab and click New custom domain.
New custom domain
  1. 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.
Domain name

Creating a Destination Domain

If you need the links to direct users to specific content in the app, create a destination domain.

  1. Click New destination domain.
New destination domain
  1. 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).
Associated files

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 Yespo, 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 Yespo settings:

Paths

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.

ExampleDescription
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.
/aboutThe 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/*/detailsLinks 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 Yespo 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.

Domain Activating and Deactivating

📘

Note

Links wrapped in the esclick.me domain that were sent earlier will continue to work.