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

Preamble

• A subscriber exists in the form of an email address, but not only:
  • you may have additional details about it, these will have to appear on the file you import so that you can define a custom field associated with each of this additional information
  • a great deal of other information can be collected during theregistration of a subscriber via a form
  • you can him. add a lot of other information manual at all times
• The information associated with each subscriber can be used to segment your audience, send targeted messages, and improve commitment.
• By using these additional details, you increase the chances of conversion and loyalty, creating a stronger and personalized relationship with each subscriber.

Take advantage of the additional details collected

See the contents of the fields

Be aware of this other guide (under Edit a subscriber's card).

See field names

Custom fields are managed in the Followers section:

1. Click here in order to access the management of your product on the Manager Infomaniak (Need help?).
2. Click directly on Domain Namesallocated to the product concerned.
3. Click on Followers in the left side menu.
4. Click on the tab Fields:
   

Insert the fields on the Newsletter

When creating a new Newsletter, insert custom fields...

1. ... in the subject and preview text at the very first stage of writing:
   
2. ... in the body of your Newsletter according to the chosen model/theme:
   
   1. with a pure HTML template insert the name of the variable in capital letters surrounded by asterisks and separators: *|NOM-DE-LA-VARIABLE|*
   2. with other types of models (blocks / wisiwyg) you need to insert a text block, click on it to be able to enter text, and click above the writing window to access the variables:
      

List of basic variables

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

Preamble

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

Build a Subscriber List

To access the management of newsletter subscribers:

1. Click here in order to access the management of your product on the Manager Infomaniak (Need help?).
2. Click directly on Domain Namesallocated to the product concerned.
3. Click on Followers in the left side menu.
4. Click the blue button Add contacts:
   
5. Read and accept the CGUs.
6. Make a choice among the different ways to build up a list of subscribers:
   

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

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

Once the spreadsheet type document is written, export it to .csv what will create a kind of text document with separators between each information present in the different cells:

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

The desired field must be assigned to the desired information (information is grouped according to the original columns). It is possible to create fields which would not yet exist (the type of field may be forced to numbers or at a date, boleen, etc.), idem for the group in which to place the imported contacts:

That's it, that's it, that's it, that's it, that's it. Groups or under Followers, your import is visible:

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

The format must be respected, e.g.:

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 in the field dedicated to this purpose, click the blue button Continue The sequence is identical to point A above.

C. Filling with an individual contact form

Import contacts one after the other using the proposed form. Add fields free (the type of field may be forced to digits or to a date, bolean, etc.) and groups, which will all be available for the following additions (except in the example animation below since it loops on a single first addition):

D. Automatic import from other Infomaniak tools

Import contacts of your Address books Infomaniak and the tool of Infomaniak ticket office if available (with the possibility to import only users who have specified that they want to receive a Newsletter).

Edit a subscriber's card

To edit the information about your subscribers:

1. Click here in order to access the management of your product on the Manager Infomaniak (Need help?).
2. Click directly on Domain Namesallocated to the product concerned.
3. Click on Followers in the left side menu.
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 changed):
   
   1. If you want to add a new field, you have to add it globally by going back to the menu Followers.
   2. Click on the tab Fields.
   3. Click on Create a field.
      
   4. The subscriber's card can now be edited at the level of this new field:
      

Remove Subscribers

To remove subscribers from the Newsletter:

1. Click here in order to access the management of your product on the Manager Infomaniak (Need help?).
2. Click directly on Domain Namesallocated to the product concerned.
3. Click on Followers in the left side menu.
4. Click for search or filter a type of subscriber if necessary.
5. Click on the box for select one or more subscribers.
6. Click on Delete:
   
    
7. Confirm Removal

You can also click on Unsubscribe for Remove so that contacts are always on the list. To review them, you will need to change the default filtering on the array, and choose Unregistered:

Forget a subscriber

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

• Forget
  • Subscriber will be deleted from all your lists.
  • All information will be completely erased in 30 days.
  • The data will not be recoverable.
• Remove
  • The subscriber will be deleted from all your lists; however, the information will be kept in case it re-subscribes to a list.
     

Export Subscribers

To export the list of subscribers to the Newsletter, in format .csv and according to selected criteria:

1. Click here in order to access the management of your product on the Manager Infomaniak (Need help?).
2. Click directly on Domain Namesallocated to the product concerned.
3. Click on Followers in the left side menu.
4. Click for search or filter a type of subscriber if necessary.
5. Click on the box for select one or more subscribers.
6. Click on Export:
   ‍‍
7. Click the blue button once the export has been prepared to download the data to a CSV file (format .csv).

The file contains these columns:

• Email
• Status
• Sent
• Opens
• Clicks
• Subscription Date
• firstname
• Lastname
• ip register
• then 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 tool Newsletter Infomaniak.

Preamble

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

Enable UTM feature

To access your Newsletter:

1. Click here in order to access the management of your product on the Manager Infomaniak (Need help?).
2. Click on the domain name relevant in the table that appears.
3. The interface of the Newsletter is displayed.

Activate this option at the very first step of creating your Newsletter. You will find 3 fields to indicate type keywords utm_parameters:

• source of the campaign ( utm_source)
• campaign support ( utm_medium So, e-mail e.g.)
• name of the campaign ( utm_campaign = on name of your campaign e.g.)

Therefore:

1. Inform the 3 UTM fields in step 1 of creating Newsletter.
2. Insert a link to the URL of your site (this should be correctly configured and analyzed by Google Analytics e.g.) in the body of the Newsletter in step 3.
3. When the drive clicks on it, it will arrive on the URL followed by the terms "?utm_source=...&utm_medium=...&utm_campaign=..."with obviously your keywords instead of "...".

If you specify several keywords in these fields, possible spaces will be replaced by signs underscore _.

Later, dynamic formulae, such as the date of the day, are expected to be included in these fields. Also read the article https://news.infomaniak.com/comment-creer-un-objectif-google-analytics.

This guide presents the conditions available to segment and filter your contact lists when sending an Infomaniak Newsletter.

Introduction

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

Segment 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 specificities)

Here is an example of a Newsletter registration form with an optional field to enter a location:

As soon as some subscribers provide this information, you will find it in the details of their contact record:

This type of information can be used to segment your subscriber list and send emails only to part of it.

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

… for future mailings (based on past subscriber actions)

1. Follow the instructions above up to point 4.
2. Click not on custom field but on Actions to choose the criteria defining the people who should receive this next Newsletter.
3. Choose the actions the subscriber must have performed to receive your next mailing, then, if necessary, add additional conditions using AND / OR to further filter your recipients.
4. Check the number of filtered subscribers to whom the Newsletter will be sent (again) and click on the blue Continue button:
   
5. Review and/or perform a test sending of your Newsletter, then click on Continue.
6. Set the time 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 (also known as a token) for the Infomaniak Newsletter tool.

Obtain 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 menu.
4. Click on the blue button Generate a key:
   
5. Click on the blue button Create a token:
   
6. Choose the appropriate product from the dropdown menu.
7. Choose a validity duration.
8. Click on the blue button Create a token:
   
9. Enter your Manager login password as requested.
10. Copy the token to a safe place - it will no longer be accessible after this.

Refer to the Newsletter API documentation.

This guide details the rules to be followed to send emails from Infomaniak to multiple recipients without this being considered as spam.

Preamble

• Infomaniak is a Swiss hosting company governed by Swiss laws.
• These federal legislation and General conditions of use state that before being added to an e-mail mailing list, potential recipients must have given their consent. 

Obtain consent from the recipient

In order for a user's registration in a newsletter to be considered voluntary, the newsletter must:

1. Have entered your e-mail address in a form dedicated to a specific subject.
2. To have clicked on a validation link automatically sent after registration (item 1); this entry must only concern the subject specified at the time of registration.
3. To be registered by the Newsletter system with its IP address and the date.

This is called a double opt-in registration.

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

The owner of an email address can report any message received as spam at any time. Collecting subscribers' registrations by double opt-in is therefore the only way to protect against a possible spam complaint.

What to do in case of spam complaint?

As a courier provider, Infomaniak must demonstrate its cooperation in the fight against spam and ensure that all its customers are not blocked/blacklisted by the courier providers of potential complainants.

In case of spam complaint, Infomaniak can therefore temporarily suspend consignments and ask the sender of the message for proof of registration of the complainant; if necessary, the complaint will lapse.

On the other hand, the complaint will be justified if no proof of registration is provided and Infomaniak may be forced to take measures: suspension of the email address, domain name or termination of the contract in case of recidivism.

How can I be in order?

If you wish to carry out e-mail campaigns, make sure you have the information in point 3 above (IP address and date of registration of each subscriber). This process ensures that the user has expressly confirmed their desire to receive communications, thereby strengthening the legitimacy of the subscriber list and reducing the risk of spam or unauthorized registration.

It is therefore advisable to build your list by inserting a contact form on your website which will make sure to collect the email addresses of your subscribers via double opt-in.

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

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

Prerequisites

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

Link an external domain

To access the management of Newsletter sending domains:

1. Click here to access the management of your product 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 directly enter) the domain name you wish to use to send newsletters:
   
4. Click on the blue Approve button.
5. Add the TXT / CNAME / DKIM records that you will receive by email and that are visible on the interface with your registrar by clicking on the button:
   

This guide explains how to handle Soft Bounce and Hard Bounce errors that can occur during email sending, particularly when using Infomaniak Newsletter.

Hard Bounce

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

• Email sent to a non-existent address
• Email domain of the recipient that is not a real domain
• Recipient's server that does not accept emails
• Etc.

Example from the Infomaniak Newsletter tool after sending with 20% Hard Bounce:

Soft Bounce

A soft bounce is an error message indicating that the email is not delivered to its recipient and is related to a temporary delivery issue: the email address is valid, and the sender can retry sending.

Several reasons can explain a soft bounce where the recipient's server temporarily refuses 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 up filters that prevent receiving certain messages
• When the email content, especially its attachments, is too large, the delivery issue occurs during sending

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

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

Example of using emoji

in the title

in the body / content

Show emoticons

on macOS

Press the keys CTRL + CMD ⌘ + SPACE

on Windows

Press the keys WINDOWS LOGO + PERIOD (.)

Alternative method:

1. Right-click on an empty area of the taskbar
2. In the menu, click on Show touch keyboard button
3. An icon of a keyboard will appear on 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 face at the bottom left of the keyboard
6. Use the various emojis available in Windows

This guide concerns authentication chips or tokens Infomaniak, which is used to verify the identity of the application and to grant it specific permissions to interact with the features and data of the application Infomaniak API in a secure manner.

Preamble

• Authentication chips or tokens are used to verify the identity of the application and to grant specific permissions to interact with the Infomaniak API's functionality and data in a secure manner.
• There's no such thing as no limit on number of token that you can create.
• The duration of an access token is "enlightened" by default but it is possible to define a custom duration at its creation.
• Be careful, if no call is made with the token for a year, it is automatically deactivated then it will be necessary to generate a new one.

Manage token API Infomaniak

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

To this end:

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

Example of application: token for API Newsletter