Follow the next steps to configure the Newsletter subscription in the Business Manager:

1. Login in to Business Manager.

2. Go to Merchant Tools > Emarsys Integration.

3. Select the Newsletter subscriptions item.

4. The page opens with the Global footer tab selected by default.

5. The merchant needs to select the Opt-in strategy. There are two options available:

• Single Opt-In (the recipient gets the opt-in system field set to true immediately in the Emarsys Platform). Optionally, the merchant can select an external event that gets fired after the user record was transmitted to Emarsys.

• Double Opt-In (the recipient needs to click a confirmation link in an email in order to get the system field opt-in in the Emarsys Platform set to true). If double opt-in is selected, then the merchant must select the external event that should be triggered in the Emarsys Platform to send out the confirmation email. Optionally, the merchant can set a second event that will be triggered as soon an end user clicks the confirmation link (e.g. to send a welcome email).

6. Click the Apply button to save the configuration.

1. Login in to Business Manager.
2. Go to Merchant Tools > Emarsys Integration.
3. Select the Newsletter subscriptions item.
4. Click the Checkout page tab.
5. The merchant needs to select the Opt-in strategy. There are two options available:

• Single Opt-In (the recipient gets the opt-in system field set to true immediately in the Emarsys Platform). Optionally, the merchant can select an external event that gets fired after the user record was transmitted to Emarsys.

• Double Opt-In (the recipient needs to click a confirmation link in an email in order to get the system field opt-in in the Emarsys Platform set to true). If double opt-in is selected, then the merchant must select the external event that should be triggered in the Emarsys Platform to send out the confirmation email. Optionally, the merchant can set a second event that will be triggered as soon an end user clicks the confirmation link (e.g. to send a welcome email).

6. Click the Apply button to save the configuration.

As soon as an end user finishes a transaction, the order data should be transmitted to the Emarsys Platform and the corresponding external event must be triggered. The external event will trigger an order confirmation email. B2C Commerce will check in the Emarsys Platform if the user record already exists and based on the result it will update the record or create a new one. Also, the merchant has the option to choose what fields will be included in the order confirmation email.

To configure and map the B2C Commerce fields, that will be added to the order confirmation email, with the defined Emarsys placeholders, a custom configuration screen has been created. Please find below the steps you need to follow to make the necessary configurations for order confirmation emails:

1. Navigate to Business Manager > Merchant Tools > Emarsys Integration > Order Confirmation configuration.

2. Click the Add fields button.

3. From the dropdown, select the B2C Commerce available field and then define the placeholder name in the right column.

4. Select the external event that will be triggered after the order is placed and the record is created or updated in the Emarsys Platform.

5. To remove some of the defined B2C Commerce field and Emarsys placeholder name pairs, select the corresponding Remove checkbox and click the Apply button.

As soon as a shipment was finished, an email should be sent to the end user and the corresponding external event must be triggered. The external event will trigger a shipping confirmation email.

To configure and map the B2C Commerce fields, that will be added to the shipping confirmation email, with the defined Emarsys placeholders, a custom configuration screen has been created. Please find below the steps you need to follow to make the necessary configurations for shipping confirmation emails:

1. Navigate to Business Manager > Merchant Tools > Emarsys Integration > Shipping Confirmation configuration.

2. Click the Add fields button.

3. From the dropdown, select the B2C Commerce available field and then define the placeholder name in the right column.

4. Select the external event that will be triggered after the shipment is finished.

5. To remove some of the defined B2C Commerce field and Emarsys placeholder name pairs, select the corresponding Remove checkbox and click the Apply button.

As soon as a shipment was finished, an email should be sent to the end user and the corresponding external event must be triggered. The external event will trigger an order cancelled email.

To configure and map the B2C Commerce fields, that will be added to the shipping confirmation email, with the defined Emarsys placeholders, a custom configuration screen has been created. Please find below the steps you need to follow to make the necessary configurations for order cancelled emails:

1. Navigate to Business Manager > Merchant Tools > Emarsys Integration > Order Cancelled Configuration Email.

2. Click the Add fields button.

3. From the dropdown, select the B2C Commerce available field and then define the placeholder name in the right column.

4. Select the external event that will be triggered after the shipment is finished.

5. To remove some of the defined B2C Commerce field and Emarsys placeholder name pairs, select the corresponding Remove checkbox and click the Apply button.

The initial database load feature will upload the existing B2C Commerce customers to the Emarsys Platform. Please find below the steps required to accomplish this:

• Create the mapping between B2C Commerce and Emarsys fields using the initial database load configuration screen. The mapping will be used to generate an auto-import profile on the Emarsys side and to create a CSV file with the B2C Commerce customers

In order to generate the mapping, a new configuration screen has been created.

1. Go to Merchant Tools > Emarsys Integration > Database Load Configuration.

2. Click Add fields.

3. Use the dropdowns to map Emarsys fields with B2C Commerce available attributes.

4. Click the Apply button to save the configuration.

Once the settings for the initial database load feature has been made, the Initialize Emarsys Database job schedule needs to be configured and run. The customers will be exported to the Emarsys Platform in bulks of configurable sizes. The default size of a bulk is set to 10000 customers, but the merchant has the option of updating this value inside Business Manager, by navigating to Administration > Operations > Jobs > Emarsys-InitDatabase > ExportCustomerInfo and setting the value for the Profiles export threshold field.

When the job schedule is finished, the merchant will have to manually disable it. The Export Status field is used to prevent customers from exporting data after the initial database load was done, so that even if the job is not disabled, the export will be skipped. The value of Export Status field is automatically set once all the customers from B2C Commerce were loaded into the Emarsys Platform.

You can manually send order confirmation email to the customer at the order number via the Emarsys service.

After sending the message, the order changes the status of (sendEmarsysShippingEmail).

After the successful execution of the Emarsys-Setup job, all initial events configuration is already set. The External event page is developed to change event configuration easily. In order to get there, you should:

1. Login in to Business Manager.
2. Select your site in the top left corner of the page.
3. Go to Merchant Tools > Emarsys Integration > External Events.

All external events are separated by their type into two tables: Newsletter Subscription Events and Other Events. Events mapping are taken from the appropriate fields of the EmarsysExternalEvents custom object.

Each table has an Add event button over the top right corner. You should use this button to map new SFCC events. Depending on the type of the event, a new SFCC event should be listed in one of the  EmarsysExternalEvents source fields (newsletterSubscriptionSource or otherSource) but should not be on the page (should not yet be mapped). If you want to change configuration of mapped SFCC events, you should click the Change button in the appropriate row.

After clicking the Add event button, the Create event dialog appears. Use the upper selector to choose the SFCC event you want to map. You can map events from the newsletterSubscriptionSource field with any allowed Emarsys event (of the same type), while events from the otherSource field are allowed to be mapped only with the appropriate Emarsys event. Click the Add button to apply mapping for the selected SFCC event.

If the appropriate Emarsys event is chosen for mapping, this Event will be created using the Emarsys API. If there are any issues during request, an error notification will be shown at the top of the events page.

The interface of the page allows the user to map SFCC Newsletter Subscription Events with any Emarsys Newsletter Subscription Events. Events of other type may be mapped only with the appropriate Emarsys events or to be disabled. In order to disable any SFCC event, choose the none option in the mapping selector. To apply mapping changes, click the Apply button.

The end user can subscribe to newsletters from the footer on every page of the storefront. There are 2 ways to do that:

• Subscribe directly by typing the email address in the subscription box and clicking the Subscribe button.

• By clicking the Subscribe button without entering any data into field. This will redirect the user to the Sign-up form. Completing all the necessary fields and clicking on Sign me up for email button will subscribe the user. The data is sent to Emarsys.

The end user also has the option to subscribe to a newsletter during the checkout process, as described below.

1. As a guest or registered user add a product to cart.

2. Proceed to checkout.

3. At the Billing step, type in your email address in the e-mail field.

4. Select Please add me to the B2C Commerce email list. B2C Commerce does not share or sell personal info and I have read the Privacy Policy and I agree checkboxes.

5. Complete all the mandatory fields and proceed to next step, so that the end user data is send to the Emarsys Platform.

Registered users have the option to subscribe to or unsubscribe from newsletters from the B2C Commerce My Account section.

1. Open the storefront and log in.

2. In the left navigation bar, click the Email Settings link.

3. Clicking the Subscribe button will open an email sign-up form. Complete the fields and click the Sign me up for email button to subscribe to newsletters.

4. Clicking the Unsubscribe button will unsubscribe the end user from newsletters.

Depending on which opt-in strategy has been configured for the subscription methods and on the unsubscription strategy (direct or indirect), the end user can be redirected to several landing pages as follows:

• Thank you page - Single Opt-in strategy

• Data submitted page - Double Opt-in strategy

• Thank you page - Double Opt-in strategy

• Action page - Indirect unsubscribe

• Thank you page - Unsubscribe

Emarsys needs a daily salesitems CSV feed with new orders (new orderitems) of the last 24 hours. This feed must be delivered to an FTPS server on a daily basis. For this, it is required to set logon credentials for this server in the B2C Commerce backend (hostname, username, password, destination folder).

Navigate to Merchant Tools > Emarsys Integration. Here you should see the SmartInsight Configuration link:

On the SmartInsight configuration page, the user can add or remove mapped fields. These fields will be used to create the CSV file with this data. These fields will be displayed as columns in exported files.

The salesitems CSV has to contain at least the following columns:

1. order - order number

2. date - date of the order (YYYY-MM-DD)

3. customer - unique customer ID (this ID must be available in Emarsys Suite as well)

4. item - ProductId of the sold item (this ID must be in the products CSV as well!)

5. quantity - quantity of the ordered item

6. c_sales_amount - Price of the sold items (this value must be negative if an order was cancelled!)

Customer is able to add additional order attributes to the data feed. For this, they should click the Add fields link and fill the Attribute name and name that will we displayed in the file. The column name of these additional columns must start with “c_”.

Elements that were added on the Site Preferences > Custom Site Preferences > Emarsys SmartInsight Configuration page are displayed in the Available elements dropdown list.

Navigate to Administration > Job Schedules and click the Edit icon next to the Emarsys Export Orders job.

On this page, the user can set up the Emarsys Export Order Job configurations:

• Enabled - Checkbox which enabled or disabled the Emarsys Export Orders job on the site.
• Name - The Job’s name.
• Description - Description of this Job.
• Runtime - The user can set up the time and period when the job will run automatically.

To run the job user should click the Run button.

After finishing the successful Job, go to the SFTP server and check the folder that was set up on the Emarsys SmartInsight Configuration page. The new exported file with orders should be in this folder.

The file name should be in such format: sales_items_<YYYYMMDD_HHiiss>_<shopinfo>.csv

Open the new exported file with orders. All the order that fit the set timeframe are displayed in the file with certain columns that were added on the Merchant Tools > Emarsys Integration > SmartInsight Configuration page:

Emarsys Catalog is a predictive recommendation engine which uses machine learning algorithms to offer your customers the best products wherever they interact with your business. The data used by the Catalog to make these recommendations is collected by the Web Extend scripts.

Emarsys Catalog is being used to recommend products based on a self-learning algorithm. Recommended products can be rendered within shop pages and within emails. To get this working, the Catalog requires a CSV product data feed which will be fetched from a remote location (HTTP / FTP / SFTP).

Log in to BM where the Emarsys integration is enabled.

The Web Extend JavaScript API is a data collection system that captures the activity and behavior of website visitors. This information is used to enrich your Emarsys contact database with Web Extend fields, and to generate personalized product recommendations for the Catalog solutions.

Log in to BM where the Emarsys integration is enabled.

Navigate to the Merchant Tools > Site Preferences > Custom Site Preferences > Emarsys Catalog Configuration link:

On this page, the user can set up the Emarsys JS Configuration:

• Predict: Enable tracking code - The Checkbox which enabled or disabled the JavaScript tracking code on the site.

• The user can select the widget type to be shown on the storefront for different pages:
  • Thank You For Your Order Page
  • Product Detail Page
  • Home Page
  • Cart Page
  • Search Page
  • Category Page
• Widget types:
  • Personal - the Personal widget offers targeted recommendations which match a visitor’s known characteristics and interests, based on their own browse history and the wisdom of the crowd. It helps them to find products they are interested in before they even know they want them.
  • Topical - this is a special widget. Each visiting customer will see a different selection of products based on what they are most likely to be interested in and displayed in sections designed to catch their interest and optimize conversion.
  • Related - the Related widget suggests alternative products to the items currently being viewed. It does this by looking at the browse behavior for the whole web shop and identifying product-to-product relationships.
  • Also Bought - the classic ‘people who bought x, also bought y‘ widget, Also Bought offers recommendations based on items that have frequently been bought with the item currently being viewed. This is a more targeted version of the Related widget and can be used well in combination with it.
  • Cart - similar to Also_Bought, the Cart widget offers recommendations based on the current selection of items in the customer’s shopping cart. It looks for relationships between these items and then makes additional cross- and up-sell recommendations (e.g. a spare power cord for cars, an extra SD card, etc.).
  • Category - similar to the Personal widget, the Category widget directs customers to the right products, but within a particular category, depending on the specific category page they are on.

Open the Storefront and visit pages where recommendation widgets must be shown.

Navigate to the Merchant Tools > Site Preferences > Custom Site Preferences > Emarsys Catalog Configuration link:

On this page, the user can set up the Emarsys JS Configuration:

• Predict: Enable tracking code - The checkbox which enabled or disabled the JavaScript tracking code on the site.

Navigate to the storefront and visit pages where the tracking code is supposed to run (category page, search page, pdp, etc.). Check the Emarsys Predict Dashboard, here you should see a real-time chart that shows what action you've performed.