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

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

Get Started

Installation & Activation

1. 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

1. 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.

1. 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.

1. 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

1. Access Plugin Settings

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

1. 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.

1. Email Integration Settings

• Marketing List ID
  • Enter the List ID which you can find at Help & Support > API ID Information in the Listrak Admin.
• Transactional List ID
  • Enter the List ID which you can find at Help & Support > API ID Information in the Listrak Admin.
• 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.

1. 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.

1. Save Configuration

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

Listrak Plugin - API Documentation

This document describes the custom Admin API endpoints provided by the Listrak Plugin for Shopware 6. These endpoints allow authorized users to trigger full data synchronization tasks between Shopware and the Listrak system.

Full Customer Synchronization

Endpoint
POST /api/_action/listrak-customer-sync

Description

Triggers the synchronization of all customer data from Shopware to Listrak.

System Validations

• Required plugin configuration (dataClientId and dataClientSecret) must be present.
• If not configured properly, the synchronization will not proceed.

Request Headers

Authorization: Bearer <your-access-token>
Content-Type: application/json

Successful Response

{
  "success": true
}

Example Error Response

{
  "success": false
}

Full Order Synchronization

Endpoint
POST /api/_action/listrak-order-sync

Description

Triggers the synchronization of all order data from Shopware to Listrak.

System Validations

• Required plugin configuration (dataClientId and dataClientSecret) must be present.
• If not configured properly, the synchronization will not proceed.

Request Headers

Authorization: Bearer <your-access-token>
Content-Type: application/json

Successful Response

{
  "success": true
}

Example Error Response

{
  "success": false
}

Full Newsletter Recipient Synchronization

Endpoint
POST /api/_action/listrak-newsletter-recipient-sync

Description

Triggers the synchronization of all newsletter recipients from Shopware to Listrak.

System Validations

• Required plugin configuration (emailClientId and emailClientSecret) must be present.
• If not configured properly, the synchronization will not proceed.

Request Headers

Authorization: Bearer <your-access-token>
Content-Type: application/json

Successful Response

{
  "success": true
}

Example Error Response

{
  "success": false
}

Data API Connection Test

Endpoint
POST /api/_action/listrak-data-api/test

Description

Tests the Listrak Data API connection using provided dataClientId and dataClientSecret. Returns a valid access token on success.

Request Headers

Authorization: Bearer <your-access-token>
Content-Type: application/json

Example Request Body

{
  "Listrak.config.dataClientId": "your-data-client-id",
  "Listrak.config.dataClientSecret": "your-data-client-secret"
}

Successful Response

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Example Error Response

{
  "errors": [
    {
      "status": "400",
      "detail": "Missing client ID and/or client Secret"
    }
  ]
}

Email API Connection Test

Endpoint
POST /api/_action/listrak-email-api/test

Description

Tests the Listrak Email API connection using provided emailClientId and emailClientSecret. Returns a valid access token on success.

Request Headers

Authorization: Bearer <your-access-token>
Content-Type: application/json

Example Request Body

{
  "Listrak.config.emailClientId": "your-email-client-id",
  "Listrak.config.emailClientSecret": "your-email-client-secret"
}

Successful Response

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Example Error Response

{
  "errors": [
    {
      "status": "401",
      "detail": "The provided API credentials are invalid."
    }
  ]
}

How It Works

1. Shopware Events

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

1. 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.