Evalanche Shopware 6 Connector

🇩🇪 German

The Evalanche connector for Shopware 6 establishes a connection between the email marketing software Evalanche (sc-networks.de) and the store system Shopware 6 (shopware.com). With the help of the app, newsletter registrations are transferred from Shopware to Evalanche. The double opt-in process of Evalanche can be used. Unsubscriptions from the newsletter are matched bidirectionally.

Table of contents

1 Installation
2 Configuration
- 2.1 Evalanche basic configuration
  - 2.1.1 Hostname
  - 2.1.2 Username
  - 2.1.3 Password
- 2.2 Evalanche Client Configuration
  - 2.2.1 Client Id
  - 2.2.2 Object Id of the client
  - 2.2.3 Pool Id
- 2.3 Evalanche Double Opt-In Configuration
  - 2.3.1 Enable Double-Opt-In
  - 2.3.2 Double-Opt-In Mail Id
- 2.4 Evalanche Tracking Configuration
  - 2.4.1 Select Tracking Method
3 Field Matching
4 Attributes in Evalanche
5 Log files
6 Scheduled tasks

Installation

The app can be downloaded from the Shopware Store (store.shopware.com) and installed in Shopware. It is recommended to create a backup of newsletter subscribers in Shopware and in Evalanche before installing and setting up the app.

After successful installation and activation, the app offers two configuration areas:

"Configuration" to configure the interface and "Field Matching" to match Shopware with Evalanche data fields.

Configuration

Next to the version information of the app, the small menu takes you to the configuration of the interface.

The configuration of the interface can be done per sales channel or across all sales channels (inheritance).

Evalanche basic configuration

Hostname

The URL of the Evalanche instance. In most cases, the Evalanche instance will be accessible through a subdomain at SC-Networks. Example <myEvalanche>.scnem.com

Username

Enter username of the Evalanche API user set up for this purpose.

The rights role of the API user in Evalanche should include in the System area all rights of the Profiles and Mailing areas, and for Interfaces the right to call WebServices 2.0. In the Objects area all rights are set.

Password

Password of the Evalanche API user.

Evalanche Client Configuration

Client Id

Mandatory ID of the Evalanche client to which the Shopware newsletter subscribers are to be transferred. The Mandatory ID is displayed as 'Internal ID' in the Evalanche settings in the Account subitem:

Object Id of the client

Enter object ID of the client. This is displayed when moving the mouse pointer in Evalanche in the left navigation on the client name. The object ID is there at the end of the displayed URL.

Pool Id

ID of the pool in which the Shopware newsletter subscribers are to be entered. The ID can be found in Evalanche in the left navigation under the item 'Profiles'. Select the desired pool here and the ID is displayed at the top next to the title of the pool.

Evalanche Double Opt-In Configuration

Enable Double-Opt-In

If you want to use the double opt-in process for newsletter subscriptions, you can activate it here.

Double-Opt-In Mail Id

If the double opt-in process is to be mapped via Evalanche, the ID of the double opt-in mail can be stored here. The ID can be found in Evalanche under the eMailings:

Important to note:
Even if the double opt-in mail is defined from Evalanche, Shopware still sends out its own double opt-in mail..

To prevent this, the following business events must be deactivated in the shop settings:

Newsletter sign-up confirmed (newsletter.confirm)
Newsletter sign-up registered (newsletter.register)

Evalanche Tracking Configuration

Select Tracking Method

Here you can define, which tracking setting the new newsletter subscribers should get automatically in Evalanche. The tracking of the profiles in Evalanche can be activated or deactivated with this setting.

Field Matching

The app needs a matching of the fields to match the data from Shopware to Evalanche. The matching is pre-filled during the installation of the app, but can be customized as desired.erden.

You can access the field matching via the Shopware administration as follows:
Settings → Aps → Evalanche connector.

Matching is done per sales channel and is not inherited. Therefore, it is mandatory to select a sales channel for matching. The connection status to Evalanche is checked and all fields are read from Evalanche and made available for matching.

The following data fields must be matched:

Attribute name	Description of the contained data
ADDRESS	Address of the newsletter recipient
EMAIL	E-mail address of the newsletter recipient
SALUTATION	Salutation of the newsletter recipient
TITLE	Title of the newsletter recipient
FIRSTNAME	First name of the newsletter recipient
NAME	Last name of the newsletter recipient
COMPANY	Company of the newsletter recipient
ZIPCODE	Postal code of the newsletter recipient
CITY	City of the newsletter recipient
COUNTRY	Country of the newsletter recipient
STATE	State of the newsletter recipient
TELEPHONE	Phone number of the newsletter recipient
LANGUAGE	Language of the newsletter recipient
SWSOURCE	Name of the Shopware Sales Channel from which the subscription was generated
TRACKING_DISABLED	Tracking disabled

Attributes in Evalanche

The app creates the following, new attributes in the configured Evalanche pool:

Attribute name	Description	Data type	Data type ID
SWSOURCE	The name of the Shopware sales channel from which the registration was generated.	Single-line input	5
SWDATEOFDOI	Shopware DOI mail date	Date with time	11

Log files

The app creates log files in the standard log directory of Shopware.
These begin in the name with "krme_evalanche_basic_dev- " and can be used for debug purposes.
They contain information about the connection status and the transferred data (new or updated newsletter profiles).

Scheduled tasks

To ensure regular synchronization between Shopware and Evalanche, the Shopware Scheduled Tasks must be active:
https://docs.shopware.com/en/shopware-6-en/tutorials-and-faq/creating-scheduled-tasks