Webpush inserts

Common tags used in webpush messages

You can use all tags from Insert usage.

Adding UTM and tracking parameters to link

If the message includes links, you automatically add parameters (such as UTM) and track click events by using {% preparelink %}{% endpreparelink %}. This will generate a redirect URL based on the hosting environment of your workspace:

If your workspace is hosted on:

• Microsoft Azure EU, the default domain redirect URL is link.snrs.it,
• Microsoft Azure USA, the default domain redirect URL is link.azu.snrs.it
• Google Cloud, the default domain redirect URL is link.geb.snrs.it.

Configuring a custom domain for redirect URL

If you have already set up a custom domain (for example, for first-party tracking), you can use it immediately without any additional configuration; simply contact Synerise Support for assistance. Otherwise, to set up a custom domain for the redirect URL, meet the following requirements:

• If you want to provide your own certificate, make sure it is in X.509 format and you must provide a private key.
• Send the SSL certificate to Synerise Support or give an approval for generating a certificate through Let’s Encrypt.
• Configure DNS - add the CNAME record. Depending on the cloud where your workspace is hosted:
  • for Microsoft Azure EU, set the CNAME to: link.snrs.it
  • for Microsoft Azure USA, set the CNAME to: link.azu.snrs.it
  • for Google Cloud Platform, set the CNAME to: link.geb.snrs.it
• Submit a customer service request for configuring your domain in Synerise.

Preview in messages

If you use a custom redirect URL, the links in the message preview still use the default domain. The custom domain is applied while sending the messages to customers.

Usage

• Emails:
  • If your link is stored as a Jinja variable and then used as a variable in the HTML, you must use a preparelink tag to generate a link with the parameters:
    

    {% set a = "/" %}
    <a href="{% preparelink %}{{a}}{% endpreparelink %}">Link text</a>

  • If the link is defined in the template as plain HTML, the parameters and tracking are added automatically when parsing the HTML. You don’t need to use the insert:

    <a href="">Link text</a>

• Mobile push and SMS:

  • {% preparelink %}YOUR_URL{% endpreparelink %}    
        

Example of a parsed link:

/?snrs_medium=email&snrs_action=newsletter.click&snrs_test=false&snrs_var=4715029&snrs_cp=6b716f86-a14d-4b8c-8795-872f7432a046&snrs_cl=b5d8c721-c2b7-42ac-9cd5-7714dedf73bf&snrs_category=client._DEVICE_.browser.mail&snrs_he=1940871749&snrs_redir=1

Using inserts in webpush messages

Inserts can be used in all fields of the webpush definition.

In the URL, Icon, and Image fields, if any jinjava is used, the following tag must be added at the end of the code of the field:

{%- if false -%} withoutRedirect=1 {%- endif -%}