README

Listrak

Introduction

The Listrak plugin integrates your Shopware 6 store with Listrak’s marketing platform—bringing advanced features like abandoned cart recovery, customer data sync, and storefront tracking to help you grow your business.

Key Features

Customer Data Sync
- Automatically send customer registrations and newsletter signups to Listrak.
Order Data Sync
- Push order information to Listrak for personalized post-purchase campaigns.
Admin Panel Integration
- Manage API credentials and feature toggles directly from the Shopware admin panel.
Abandoned Cart Recovery
- Capture cart data and sync it with Listrak for automated follow-up campaigns.

Get Started

Installation & Activation

Download

Git

Clone the Plugin Repository:
Open your terminal and run the following command in your Shopware 6 custom plugins directory (usually located at custom/plugins/):
```
git clone https://github.com/solution25com/listrak-shopware-6-solution25.git
```

Packagist

 composer require solution25/listrak

Install the Plugin in Shopware 6

Log in to your Shopware 6 Administration panel.
Navigate to Extensions > My Extensions.
Locate the newly cloned plugin and click Install.

Activate the Plugin

After installation, click Activate to enable the plugin.
In your Shopware Admin, go to Settings > System > Plugins.
Upload or install the “Listrak” plugin.
Once installed, toggle the plugin to activate it.

Verify Installation

After activation, you will see Listrak in the list of installed plugins.
The plugin name, version, and installation date should appear as shown in the screenshot below.

Plugin Configuration

Access Plugin Settings

Go to Settings > System > Plugins.
Locate Listrak and click the three dots (...) icon or the plugin name to open its settings.

Data Integration Settings

Listrak Merchant ID
- Enter the Merchant ID provided by Listrak.
Listrak Data Client ID
- Enter the Client ID from your Listrak Data Integration.
Listrak Data Client Secret
- Enter the Client Secret from your Listrak Data Integration.
Test API connection
- Test Data API connection.

Email Integration Settings

Listrak List ID
- Enter the List ID provided by Listrak.
Listrak Email Client ID
- Enter the Client ID from your Listrak Email Integration.
Listrak Email Client Secret
- Enter the Client Secret from your Listrak Email Integration.
Salutation Field Id
- Optionally enter the Salutation field id from your Listrak Email Profile field, if it exists.
First Name Field Id
- Optionally enter the first name field id from your Listrak Email Profile field, if it exists.
Last Name Field Id
- Optionally enter the last name field id from your Listrak Email Profile field, if it exists.
Test API connection
- Test Email API connection.

Sync Settings

Perform a full synchronization of existing customer data by clicking on Full Customer Synchronization
Perform a full synchronization of existing customer data by clicking on Full Order Synchronization
Perform a full synchronization of existing newsletter recipient data by clicking on Full Newsletter Recipient Synchronization
Enable Listrak Browser Tracking by clicking on the toggle.
Enable ongoing Customer Synchronization by clicking on the toggle.
Enable ongoing Order Synchronization by clicking on the toggle.

Save Configuration

Click Save in the top-right corner to store your settings.

How It Works

Shopware Events

The plugin listens to key Shopware events like cart updates, customer registrations, and order placements.

Data sent to Listrak

Data is sent to Listrak automatically via secure API calls, including retries and error logging.

FAQ

Is a Listrak account required?
- Yes. You need an active Listrak account, a Data Integration and an Email Integration for syncing data.

Wiki Documentation

Read more about the plugin configuration on our Wiki.

solution25 / listrak

Maintainers

Details