# Newsletters # ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Getting started In this article, you can find information about the newsletter functionality, which allows customers to register to a newsletter list, which can be sent to third-party applications via API, like Bloomreach. It is possible to create newsletter groups to categorize types of customers. Table of contents: 1. [ Functionality configuration](#bkmrk-functionality-config-1) 2. [ Registration for the newsletter subscription](#bkmrk-registration-for-the) 1. [Logged-out customers](#bkmrk-logged-out-customers) 2. [During registration](#bkmrk-during-registration) 3. [Logged-in customers](#bkmrk-logged-in-customers) 3. [ Managing subscribers](#bkmrk-managing-subscribers) 4. [ Managing subscriber groups](#bkmrk-managing-subscriber-) 5. [ Subscribers import](#bkmrk-subscribers-import) 6. [ Subscribers export](#bkmrk-subscribers-export) --- # ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Functionality configuration To enable the customers to register for the newsletter on the website it needs to be first enabled in the system settings. Newsletter configuration can be found in: ***System > System / Settings > Built-in Functions > Newsletter***
![POWERPNT_35eiG9Xvd6.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075750389276.png)
*Visualization of the newsletter functionality system settings*
In the Newsletter section you can find three switches: - **Enabled** - Switch which enables / disables the functionality and the ability to use it by the customers. - - Additionally, the title of the newsletter confirmation e-mail can be changed in the ***System > System / Settings > General > E-mails***
![POWERPNT_yKuHHrLhKs.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075745688348.png)
*Visualization of the E-mails tab in the System / Settings*
--- # ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Registration for the newsletter subscription ## Logged-out customers Customers who do not have an account on the e-commerce platform, or are not logged in are able to register for the newsletter using the /newsletter webpage. Usually, the /newsletter webpage is linked in the e-commerce platform footer, but that depends on Yves Rocher needs.
![POWERPNT_dgZ9rV298A.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075808199068.png)
*Visualization of the /newsletter page*
On the /newsletter webpage customers are able to type their e-mail address and their additional information, and register for the newsletters. When the is activated in the [System / Settings](#bkmrk-functionality-config-1) customers will receive an e-mail confirmation if they want to register for a newsletter. If this functionality is disabled, the customers will instantly join the newsletter list. Customers are unable to cancel their subscription from this page - it has to be done using the URL in the newsletter or from the customer panel described in [Logged-in customers.](#bkmrk-logged-in-customers) ## During registration During the registration process, when the customer selects the agreement, that they agree to an e-mail communication they will sign in to the newsletter list.
![Screenshot 2023-11-03 at 12-18-15 CZ UAT - Yves Rocher internetový prodej kosmetických výrobků na obličej a tělo parfémů a líčení. Kosmetika Yves Rocher pro přírodní krásu.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11123139302172.png)
*Visualization of the registration form*
Same as for [logged-out customers](#bkmrk-logged-out-customers) when the is activated in the [System / Settings](#bkmrk-functionality-config-1) customers will receive an e-mail confirmation if they want to register for a newsletter. If this functionality is disabled, the customers will instantly join the newsletter list. Customers are able to cancel their subscription using the URL in the newsletter or from the customer panel described in [Logged-in customers.](#bkmrk-logged-in-customers) ## Logged-in customers Registered and logged-in customers are able to register to the newsletter functionality in their customer panel by accessing the /customer/newsletter option. Logged-in customers will also get redirected to this webpage when they access the previously mentioned /newsletter URL.
![POWERPNT_gG2zTq5AAt.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075776927132.png)
*Visualization of the /customer/newsletter page*
In the /customer/newsletter webpage customer only has to fill in their e-mail address and are able to register to the newsletter list. Customers registering to the newsletters this way do not have to accept the newsletter registration even if the **Double activation** is enabled.
![POWERPNT_r8BWDzSDTC.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075808228380.png)
*Visualization of the /customer/newsletter page*
When the customer is logged-in and registered to a newsletter functionality they are able to cancel their subscription from the /customer/newsletter webpage. --- # ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Managing subscribers All customers that are registered for a newsletter functionality, or have canceled their subscription can be found in the admin panel. Subscribers list is located in the: ***Customers > Subscribers / list*** This tab contains filters, which will help manage the desired customers
![POWERPNT_pcMLm3W3Bn.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075892969756.png)
*Visualization of the Subscribers / list filters*
There are the following filters available: - Creation time - A time range when the subscribers were created - Update time - A time range when the subscribers were last updated - Show MD5 e-mail hash column - Adds a new column that contains MD5 e-mail hash
![POWERPNT_sJbKbgBrRx.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075892975516.png)
*Visualization of the Subscribers list tab*
In the subscriber list table you can find the following options: - **(1)** **Show X Entries** allows to filter how many entries should be visible at once - **(2)** Various table columns. All of them can be sorted by clicking on them. - **ID** - Subscribers internal ID - **First/last name** - Subscribers first and last name - **E-mail** - Subscribers e-mail address - **Status** - Subscribers status. Available statuses are **Active** and **Blacklisted**. Blacklisted customer unsubscribed to the newsletter, or was manually blacklisted, and won't receive receive newsletter e-mails. - **Creation time** - A date and hour when the customer has subscribed to a newsletter. - **Actions** - Two available actions: - **Edit** - Allows to edit the selected customer. More about adding and editing the customer can be found below - **View** - View the selected subscriber. Viewing doesn't allow to edit any data. - **(3) Add** button allows to manually add a new subscriber. Adding and editing a subscriber looks exactly the same. Below you can find more information about the available fields, when adding or editing a new customer. - **(4) Search** field allows to search the subscribers by their name / surname as well as their e-mail address. - **(5) Pages list** allows to show the next batch of customers on the another pages accoriding to applied sorting option and filters.
![powerpoint.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075892978844.png)
*Visualization of the customer in the subscribers / list*
When editing or adding a new customer you can find there the following fields: - **Customer** - A button that redirects to customers e-commerce profile. This option is only available if both subscriber e-mail and e-commerce account e-mail are the same. - **E-mail** - Subscribers e-mail address. This field is mandatory. - **Subscriber's groups** - Groups that the subscriber is assigned to. You can find more about the subscriber groups in the [ Managing subscriber groups](#bkmrk-managing-subscriber-) chapter. - **First name** - Customers first name - **Last name** - Customers last name - **Gender** - Customers gender - **Birthday** - Customers birthday date - **Active** - A switch that defines if the subscriber is active or not. Not active subscribers won't receive any newsletters. - **Is blacklisted?** - A switch, which defines if the subscriber is blacklisted. Blacklisted subscribers won't receive any newsletters. Additionally, all agreements the subscriber has agreed on will be visible at the bottom of the page. --- # ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Managing subscriber groups Subscribers can be put in subscriber groups, which allows to easily manage them, and send a desire newsletters to a certain selected group. Subscriber groups can be manged in ***Customers > Subscribers groups***
![POWERPNT_uMu4ejcZK6.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11122515828508.png)
*Visualization of the filters in subscribers groups.*
Subscribers groups filters allow to filter by **is active?** flag, which defines if the selected group is set as active or not.
![POWERPNT_RSYWP4nwWa.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11122515836444.png)
*Visualization of the subscribers groups*
In the subscribers groups table you can find the following options: - **(1)** **Show X Entries** allows to filter how many entries should be visible at once - **(2)** Various table columns. All of them can be sorted by clicking on them. - **ID** - Subscriber group internal ID - **Name** - Internal name of a subscriber group. - **Description** - Short description of a subscriber group. - **Is active?** - Subscriber group activity status. - **Actions** - **Edit** - Allows to edit the selected subscriber group. More about adding and editing the customer can be found below - **(3) Add** button allows to addition of a new subscriber group. Adding and editing a subscriber looks exactly the same. Below you can find more information about the available fields, when adding or editing a new group. - **(4) Search** field allows to search the subscribers groups by their name. - **(5) Pages list** allows to show the next batch of groups on the another pages accoriding to applied sorting option and filters.
![POWERPNT_bezhCP487E.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11122606842524.png)
*Visualization of the subscriber group creation*
In the subscriber group creation / edition you can define the following fields: - **Name (mandatory)** - An internal name of a subscriber group. - **Description** - Internal description of a subscriber group. - **Is active?** - An activity flag, which defines if the selected group is active for use. --- # ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Subscribers import Subscribers can be imported using the import functionality located in ***Import / Export > Import***
![POWERPNT_uG3PAft4eX.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11123014338076.png)
*Visualization of the subscribers import*
In order to import subscribers you have to select the "Newsletter subscribers CSV" option and select the prepared .csv file.
![POWERPNT_GfKViKPmyb.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11123014341532.png)
*Visualization of the subscribers csv file*
Subscribers .csv file can have any file name and must contain the following columns: - **email (mandatory)** - Customers e-mail address. - **Gender** - Customers gender. Accepted values are **M** for males and **F** for females. - **Group** - Subscriber group internal name. This field will assign the selected customer to a selected subscriber group. - **first\_name** - Customers first name - **last\_name** - Customers last name - **birthday** - Customers birthday in DD/MM/YYYY format. --- # ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Subscribers export Subscriber lists can be exported using the: ***Import / Export > Export / Subscribers***
![POWERPNT_eaAt5XqwGR.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11123044809372.png)
*Visualization of the subscribers csv file*
In the Export / Customers you can filter out desirable data by using the selected filters: - **Groups** - A list of selectable subscriber groups that should be exported. - **Creation time** - A range of dates whenever the subscriber was created. - **Update time** - A range of dates whenever the subscriber was updated. - **Show MD5 e-mail hash column** - Adds the MD5 e-mail hash column in the exported file. By pressing the "**Export**" button the file will be exported with the selected filters.
![POWERPNT_CA29rH5hz4.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11123044812316.png)
*Visualization of the exported subscribers file*
In the exported subscribers file you can find the following columns: - **ID** - Subscriber internal ID. - **First\_name** - Customers first name. - **Last\_name** - Customers last name. - **Email** - Subscribers e-mail address. - **is\_active** - Activity status of a subscriber. 1 means active, 0 means not active. - **is\_blacklisted** - blacklisted status of a subscriber. 1 is blacklisted, 0 is not blacklisted. - **Gender** - Customers gender. M is for Male, F is for Female. - **Status** - Subscribers status. Available statuses are: - **Only newsletter** - Customer is only registered to the newsletter communication and doesn't have an account on a e-commerce platform. - **Customer** - The customer has a created account on an e-commerce platform - **Mc\_hash** - MD5 e-mail hash. This field is only visible if the **Show MD5 e-mail hash column** filter was selected. - **Joy\_id** - Customers JOY ID. - **Birthday** - Customers birthday date. - **Subscribe time** - A date with an hour when the customer has subscribed to an e-mail communication.