This guide explains how to add tags (codes and variables) in the body of your text to personalize your sends with Newsletter Infomaniak.

Preamble

• A subscriber exists in the form of an email address, but not only:
  • you may have additional details about them, these must be included in the file you import so that you can define a custom field associated with each of these additional details
  • many other details can be collected during the subscription of a subscriber via a form
  • you can add many other details manually at any time
• The information associated with each subscriber can be used to segment your audience, send targeted messages, and improve engagement.
• By leveraging these additional details, you increase the chances of conversion and loyalty, thereby creating a stronger and more personalized relationship with each subscriber.

Making the most of the additional details collected

See the content of the fields

Refer to this other guide (under Edit subscriber profile).

See the field names

Custom fields are managed in the Subscribers section:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the domain name assigned to the relevant product.
3. Click on Subscribers in the left sidebar.
4. Click on the Fields tab:
   

Insert the fields into the Newsletter

When you create a new Newsletter, insert the custom fields…

1. … in the subject and preview text in the very first step of writing:
   
2. … in the body of your Newsletter according to the chosen template/theme:
   
   1. with a pure HTML template, insert the variable name in uppercase surrounded by asterisks and hyphens: *|VARIABLE-NAME|*
   2. with other types of templates (blocks / wysiwyg), you need to insert a text block, click on it to enter text, and click above the editing window to access the variables:
      

List of basic variables

This guide shows how to create / import / manage contacts within subscriber lists Newsletter Infomaniak.

Preamble

• You must obtain the explicit consent of your recipients via the double opt-in model (sending spam and using purchased/rented address lists are prohibited).
• Duplicates will be automatically removed.
• The import does not send any message to the added contacts (so read and accept the first point above).

Build a list of subscribers

To access the management of Newsletter subscribers:

1. Click here to access your product management on the Infomaniak Manager (need help?).
2. Click directly on the domain name assigned to the relevant product.
3. Click on Subscribers in the left sidebar.
4. Click on the blue button Add contacts:
   
5. Read and accept the Terms of Service.
6. Choose from the different methods to create a list of subscribers:
   

A. Import a CSV file (format .csv) or .txt file (predetermined format)

The format must be respected (a model to download is available on the page). Maximum size: 300 Mo

Once the spreadsheet document is written, export it as a .csv which will create a text document with separators between each piece of information in the different cells:

Select the .csv file from the import interface then click the blue Import button:

You must assign the desired field to the desired information (the info is grouped according to the original columns). It is possible to create fields that do not yet exist (the field type can be forced to numbers or a date, boolean, etc.), same for the group in which to place the imported contacts:

There you go, whether under Groups or under Subscribers, your import is visible:

B. Copy-paste the equivalent of a .csv or .txt (predetermined format)

The format must be respected, for example:

anna.a@domain.xyz,Anna,Alpha,1985-08-20
alfred.a@domain.xyz,Alfred,Alpha
contact@domain.xyz,Support
mail@domain.xyz

Once this information is pasted into the designated field, click the blue Continue button. The rest is identical to point A above.

C. Filling out an individual contact form

Import contacts one by one using the provided form. Add free fields (the field type can be forced to numbers or a date, boolean, etc.) as well as groups, which will all be available for subsequent additions (except in the example animation below since it loops on a single first addition):

D. Automatic import from other Infomaniak tools

Import contacts from your address books Infomaniak and from the ticketing tool Infomaniak if available (with the option to import only users who have specified that they want to receive a Newsletter).

Edit a subscriber's profile

To edit the information related to your subscribers:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the domain name assigned to the relevant product.
3. Click on Subscribers in the left sidebar.
4. Click on the subscriber whose details you wish to edit:
   
5. Click on Edit:
   
6. Edit the information (only the email address cannot be modified):
   
   1. If you want to add a new field, you must add it globally by returning to the Subscribers menu.
   2. Click on the Fields tab.
   3. Click on Create a field.
      
   4. The subscriber's record can now be edited at this new field level:
      

Delete subscribers

To delete newsletter subscribers:

1. Click here to access your product management on the Infomaniak Manager (need help?).
2. Click directly on the domain name assigned to the relevant product.
3. Click on Subscribers in the left sidebar.
4. Click to search or filter a type of subscriber if necessary.
5. Click the box to select one or more subscribers.
6. Click on Delete:
   
    
7. Confirm the deletion

You can also click on Unsubscribe instead of Delete so that the contacts remain in the list. To view them again, you will need to modify the default filtering on the table and choose Unsubscribed:

Forget a subscriber

On a subscriber's card (at point 4 above, click on the subscriber whose details you wish to edit) you can:

• Forget
  • The subscriber will be deleted from all your lists.
  • All information will be completely erased within 30 days.
  • The data will not be recoverable.
• Delete
  • The subscriber will be removed from all your lists; however, the information is retained in case they re-subscribe to a list.
     

Export subscribers

To export the list of newsletter subscribers in .csv format and according to chosen criteria:

1. Click here to access the management of your product on the Manager Infomaniak (need help?).
2. Click directly on the domain name assigned to the relevant product.
3. Click on Subscribers in the left sidebar.
4. Click to search or filter a type of subscriber if necessary.
5. Click the box to select one or more subscribers.
6. Click on Export:
   
7. Click the blue button once the export is ready to download the data into a CSV file (format .csv).

The file includes these columns:

• Email
• Status
• Sent
• Opens
• Clicks
• Subscription Date
• firstname
• lastname
• ip register
• then the free fields (text, number, date, etc.) created manually…

This guide concerns UTM tags, or Urchin Tracking Module, tags added to URLs to track and analyze the performance of online marketing campaigns from the Newsletter tool.

Preamble

• These UTM tags, which are optional, consist of specific parameters such as source, medium, campaign, term, and content, which help identify the origin of a link's traffic.
• By using UTM tags, marketers can understand which campaigns generate traffic, which channels are most effective, and which ads or strategies work best, based on data collected by web analytics tools.
• The UTM tags thus allow you to create a match between the links present in your newsletters and the tracking of a tool like Google Analytics on your site.

Enable the UTM feature

To access your Newsletter:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. If necessary, click on the domain name concerned in the table that appears.
3. The interface of the Newsletter appears.

Enable this option in the very first step of creating your Newsletter. You will find three fields allowing you to enter keywords of type utm_parameters:

• campaign source (utm_source)
• campaign medium (utm_medium such as email for example)
• campaign name (utm_campaign = the name of your campaign for example)

So:

1. Fill in the 3 UTM fields in step 1 of Newsletter creation.
2. Insert a link to the URL of your site (the latter must be properly configured and analyzed by Google Analytics, for example) in the body of the Newsletter in step 3.
3. When the reader clicks on it, they will be taken to the URL followed by the terms "?utm_source=...&utm_medium=...&utm_campaign=..." with obviously your keywords in place of "...".

If you enter multiple keywords in these fields, any spaces will be replaced with underscores underscore _.

Later, it is planned to be able to enter dynamic formulas in these fields, such as today's date for example. Also, refer to the article https://news.infomaniak.com/comment-creer-un-objectif-google-analytics.

This guide presents the available conditions for segmenting and filtering your contact lists when sending an Newsletter Infomaniak.

Preamble

• Filtering subscribers based on certain criteria allows you to send Newsletters only to specific people among your subscribers.
• The criteria can be their subscription date as well as custom fields or even actions performed or not during previous sends.
• You can combine multiple conditions and add "OR" conditions to refine your filters.

Segmenting contact lists…

Access your Newsletter:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the domain name assigned to the relevant product.

... when sending to new subscribers (based on their specifics)

Here is an example of a newsletter subscription form with an optional field to enter a location:

Once some subscribers provide this information, you will find it in the details of their contact sheet:

This type of information can be used to segment your list of subscribers and write only to part of it.

1. Click on Campaigns in the left sidebar, then click the button to start a new campaign.
2. Specify any custom terms related to the target audience:
   
3. Fill in the information in the following steps and create the Newsletter.
4. Click on the advanced mode to segment contacts and avoid sending to your entire list:
   
5. Enter the information corresponding to the criteria you have defined and based on the information collected during the registration of subscribers (custom fields or group membership or registration date).
6. Add additional conditions using AND/OR to filter your recipients as effectively as possible.
7. Check the number of filtered subscribers to whom the Newsletter will be sent.
8. Click on the blue Continue button:
   
9. Check and/or perform a test send of your Newsletter then click on Continue.
10. Define when your Newsletter should be sent (as soon as possible or scheduled for later).

... for the next sends (based on the subscriber's past actions)

1. Follow the instructions above until step 4.
2. Click on Actions instead of custom field to choose the criteria defining the people who will receive this next Newsletter send.
3. Choose the actions that the subscriber will have had to perform to receive your next send, then if necessary add additional conditions using AND / OR to further filter your recipients.
4. Check the number of filtered subscribers who will be resent the Newsletter, then click on the blue Continue button:
   
5. Check and/or perform a test send of your Newsletter then click on Continue.
6. Define when your Newsletter should be sent (as soon as possible or scheduled for later).

This guide explains how to create a token, or API key (or token) for the Newsletter tool.

Get a token

To obtain a Newsletter API key:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the domain name assigned to the relevant product.
3. Click on API Key in the left sidebar.
4. Click the blue button Generate a key:
   
5. Click the blue Create a token button:
   
6. Select the appropriate product from the dropdown menu.
7. Choose a validity period.
8. Click the blue button Create a token:
   
9. Enter the password to log in to the Manager as requested.
10. Copy the token to a safe place - it will no longer be accessible after that.

Consult the Newsletter API documentation.

This guide details the rules to follow to send emails from Infomaniak to multiple recipients without it being considered as spam.

Preamble

• Infomaniak is a Swiss hosting provider governed by Swiss laws, federal laws (and general terms of use) which stipulate that before being added to an email sending list, potential recipients must have given their consent.

Getting the recipient's consent

For a user's subscription to a newsletter to be considered voluntary, the user must:

1. To have entered their email address in a form dedicated to a specific topic.
2. To have clicked on a validation link automatically sent after registration (point 1); this registration must only concern the subject specified at the time of registration.
3. To be registered by the Newsletter system with the IP address and date.

This is called a double opt-in subscription.

The term "double opt-in" refers to a registration process in which a user takes two distinct actions to confirm their intention to receive communications, typically newsletters or marketing emails.

The owner of an email address can report any received message as spam at any time. Collecting subscriber sign-ups through double opt-in is therefore the only way to protect against a potential spam complaint.

What to do in case of a spam complaint?

As an email provider, Infomaniak must demonstrate its cooperation in the fight against spam and ensure that none of its customers are blocked/blacklisted by the email providers of potential complainants.

In case of a spam complaint, Infomaniak can therefore temporarily suspend deliveries and ask the sender of the message for proof of registration of the complainant; in this case, the complaint will become void.

However, the complaint will be justified if no proof of subscription is provided and Infomaniak may be forced to take measures: suspend the email address, the domain name or terminate the contract in case of recurrence.

How to comply?

If you wish to conduct email campaigns, make sure you have the information from point 3 above (IP address and registration date of each subscriber). This process ensures that the user has explicitly confirmed their desire to receive communications, thereby strengthening the legitimacy of the subscriber list and reducing the risk of spam or unauthorized sign-ups.

It is therefore recommended to build your list by inserting a contact form on your website that will ensure to collect the email addresses of your subscribers via double opt-in.

An unsubscribe link must also be visible and appear at the bottom of each of your newsletters.

This guide explains how to use the Newsletter tool with an external domain name (not managed at Infomaniak).

Prerequisites

• The domain name must belong to you.
• Synonym domains and their primary domain cannot be used to send newsletters.
  • It is possible to set up your synonyms as aliases.

Link an external domain

To access the management of Newsletter sending domains:

1. Click here to access your product management on the Infomaniak Manager (need help?).
2. If you already have a Newsletter, click on Add a domain:
   
   • Otherwise, click on Start for free:
     
3. Select Other domain from the dropdown menu before entering (or enter directly) the domain name with which you want to send newsletters:
   
4. Click the blue Approve button.
5. Add the TXT / CNAME / DKIM records that you will receive by email and that are visible on the interface to your registrar by clicking the button:
   

This guide explains how to manage errors of type Soft Bounce & Hard Bounce that can occur when sending emails, particularly when using the Newsletter Infomaniak.

Hard Bounce

A hard bounce is an email that cannot be delivered for permanent reasons.

• email sent to a fake address
• domain of the recipient's email which is not a real domain
• recipient's server that does not accept emails
• etc.

Example of the Infomaniak Newsletter tool after a send with 20% Hard Bounce:

Soft Bounce

A soft bounce is an error message indicating that the email has not been delivered to its recipient and corresponds to a presumably temporary routing problem: the email address is valid, and the sender can resend the email.

Several reasons can explain a soft bounce and therefore why the recipient's server temporarily rejects the email:

• the recipient's inbox is full: due to insufficient storage capacity, the recipient no longer receives messages
• an issue occurs with the recipient's mail server: the server is temporarily unavailable or down, or the user has inadvertently set filters that prevent the reception of certain messages
• when the content of the e-mail, including its attachments, is too large, the delivery issue occurs at the time of sending

Unless the recipient has permanently abandoned their inbox without deleting their account, a soft bounce is a temporary issue.

This guide explains how to freely integrate emojis / emoticons / smileys into the title and content of a Newsletter Infomaniak.

Example of emoji use

in the title

in the body / content

Display the emoticons

on macOS

Press the keys CTRL + CMD ⌘ + SPACE

on Windows

Press the WINDOWS LOGO + PERIOD (.)

Alternative method:

1. Right-click on an empty area of the taskbar.
2. In the menu, click on Show touch keyboard.
3. An icon will then appear in the taskbar at the bottom right of your screen.
4. Click on this icon to bring up the virtual keyboard.
5. Click on the key with a smiley at the bottom left of the keyboard.
6. Use the various Windows emojis.

This guide concerns the authentication tokens or tokens, which are used to verify the identity of the application and to grant it specific permissions to interact securely with the features and data of the API.

Preamble

• Authentication tokens or tokens serve to verify the application's identity and grant it specific permissions to securely interact with the features and data of the Infomaniak API.
• There is no limit to the number of tokens you can create.
• The duration of an access token is "unlimited" by default, but it is possible to set a custom duration at its creation.
• Warning, if no call is made with the token for a year, it is automatically deactivated; it will then be necessary to generate a new one.

Manage Infomaniak API tokens

When creating an API token, you will be able to select the application and the scope accessible by the token (to match your current needs and project).

For this:

1. Click here to access the management of your product on the Manager Infomaniak (need help?).
2. Click the blue button Create a token.
3. Select the appropriate product from the dropdown menu according to your current need and project.
4. Choose a validity period.
5. Click on the blue button Create a token.
6. Enter the password to log in to the Manager as requested.
7. Copy the token to a safe place - it will no longer be accessible after that.

Application example: token for the Newsletter API