solution25
  • E-commerce

    Odkryjmy potencjał Państwa sklepu.

    Bezpłatna analiza sklepu
    Frame 1321315514

    Shopware

    Platinum Partner, lider w regionie DACH

    Więcej
    Kluczowe koncepcje Shopware Kto korzysta z Shopware? Jak zostać dobrym partnerem Shopware Hosting Shopware Checklista Shopware przed startem Dlaczego Shopware w 2025 roku? B2B z Shopware B2C z Shopware Wydajność Shopware Shopware PaaS na Platform.sh Shopware na rynek amerykański Przewodnik SEO dla Shopware
    Frame 1321315514 1

    Shopify

    Szybki start, skalowanie międzynarodowe

    Więcej
    Czym jest Shopify? Dla kogo jest Shopify? Do kogo należy Shopify? Czy można połączyć Amazon z Shopify? Co potrafi Shopify? Ile kosztuje Shopify? Jak wybrać motyw Shopify? Jakie są wady Shopify? Jakie są zalety Shopify?
    Frame 1321315514 2

    Migracje

    Zmiana platformy bez utraty sprzedaży

    Więcej
    Shopware 5 do Shopware 6 Shopify do Shopware 6 Magento do Shopware 6 OXID do Shopware 6 Migracje Jak dobrze przygotować migrację Shopware Jak dobrze przygotować migrację Shopware Jak uniknąć błędów przy migracji Shopware Przygotowanie danych zamówień do migracji Shopware Przygotowanie danych produktowych do migracji Shopware Migracja treści w Shopware Rola SEO w migracjach Shopware Bezpłatna konsultacja
    Frame 1321315514 3

    Integracje

    Płatności, podatki, fulfillment, marketing

    Więcej
    Shopware 6 BlueSnap Shopware 6 Cybersource Shopware 6: odzyskiwanie porzuconych koszyków Shopware 6 Store Credit Shopware 5 Optimizely Campaign Shopware 6 PayTrace Payment Shopware 6 NMI Payment Shopware 6 MaxMind: ochrona przed oszustwami Shopware 6: indywidualne ceny dla klientów Subskrypcje z Shopware Shopware 6 Listrak Shopware 6 MultiChannel Content Shopware 6: dostawy częściowe Shopware 6 AgeChecker.net Shopware 6 Pudo Point Dlaczego API first otwiera nowe możliwości Tańsza integracja ERP PayPal jako operator płatności Integracja Klaviyo z Shopware 6 Integracja HubSpot z Shopware 6 Integracja e-mail marketingu Mailchimp Integracja Google Analytics Integracja Zapier z Shopware 6 Shopware 6 BlueSnap Shopware 6 Cybersource Shopware 6 Abandoned Cart Saver Shopware 6 Store Credit
    Frame 1618873659

    Migracja do Shopware razem z nami.

    Więcej informacji
    Shopware: przegląd Kluczowe koncepcje Shopware Kto korzysta z Shopware? Jak zostać dobrym partnerem Shopware Hosting Shopware Checklista Shopware przed startem Dlaczego Shopware w 2025 roku? B2B z Shopware B2C z Shopware Wydajność Shopware Shopware PaaS na Platform.sh Shopware na rynek amerykański Przewodnik SEO dla Shopware
    Shopify: przegląd Czym jest Shopify? Dla kogo jest Shopify? Do kogo należy Shopify? Czy można połączyć Amazon z Shopify? Co potrafi Shopify? Ile kosztuje Shopify? Jak wybrać motyw Shopify? Jakie są wady Shopify? Jakie są zalety Shopify?
    Migracje: przegląd Shopware 5 do Shopware 6 Shopify do Shopware 6 Magento do Shopware 6 OXID do Shopware 6 Migracje Jak dobrze przygotować migrację Shopware Jak dobrze przygotować migrację Shopware Jak uniknąć błędów przy migracji Shopware Przygotowanie danych zamówień do migracji Shopware Przygotowanie danych produktowych do migracji Shopware Migracja treści w Shopware Rola SEO w migracjach Shopware Bezpłatna konsultacja
    Integracje: przegląd Shopware 6 BlueSnap Shopware 6 Cybersource Shopware 6: odzyskiwanie porzuconych koszyków Shopware 6 Store Credit Shopware 5 Optimizely Campaign Shopware 6 PayTrace Payment Shopware 6 NMI Payment Shopware 6 MaxMind: ochrona przed oszustwami Shopware 6: indywidualne ceny dla klientów Subskrypcje z Shopware Shopware 6 Listrak Shopware 6 MultiChannel Content Shopware 6: dostawy częściowe Shopware 6 AgeChecker.net Shopware 6 Pudo Point Dlaczego API first otwiera nowe możliwości Tańsza integracja ERP PayPal jako operator płatności Integracja Klaviyo z Shopware 6 Integracja HubSpot z Shopware 6 Integracja e-mail marketingu Mailchimp Integracja Google Analytics Integracja Zapier z Shopware 6 Shopware 6 BlueSnap Shopware 6 Cybersource Shopware 6 Abandoned Cart Saver Shopware 6 Store Credit
  • Oprogramowanie i AI

    Odkryjmy potencjał Państwa sklepu.

    Bezpłatna analiza sklepu
    Frame 1321315514 4

    Tworzenie oprogramowania

    Platformy i portale zintegrowane z systemami

    Wkrótce
    Frame 1321315514 5

    Tworzenie aplikacji

    Aplikacje webowe i mobilne, API first

    Wkrótce
    Frame 1321315514 6

    Rozwiązania AI

    Integracja modeli, wzbogacanie danych, asystenci

    Wkrótce
    Frame 1321315514 7

    Migracje

    Zmiana platformy bez utraty sprzedaży

    Więcej
    Frame 1321315514 8

    Integracje

    Płatności, podatki, fulfillment, marketing

    Więcej
    Frame 1618873659 1

    Nasza najnowsza wtyczka Shopware: MCP Connector.

    Zobacz wtyczkę
  • Rozwiązania

    Odkryjmy potencjał Państwa sklepu.

    Bezpłatna analiza sklepu

    Więcej linków

    Frame 1321315514 16 GitHub Frame 1321315514 17 Shopware Store
    Frame 1321315514 10

    Wtyczki Shopware

    Rozszerzenia z naszej własnej produkcji

    Więcej
    Frame 1321315514 11

    Integracje Optimizely

    Campaign Client w ścisłej współpracy z Shopware

    Więcej
    Frame 1321315514 12

    docks25

    Platforma do migracji i integracji

    Więcej
    Frame 1321315514 13

    StatHubs

    Wskaźniki sklepu w jednym dashboardzie

    Wkrótce
    Frame 1321315514 14

    Ströer Products

    Rozwiązanie Ströer na rynek europejski

    Wkrótce
    Frame 1321315514 15

    profihost

    Hosting i utrzymanie, Enterprise Partner

    Wkrótce
    Frame 1618873659 2

    Nasza wtyczka Optimizely Campaign.

    Zobacz wtyczkę
  • Firma

    Odkryjmy potencjał Państwa sklepu.

    Bezpłatna analiza sklepu

    O nas

    Wydarzenia i Summit

    Wiedza

    Kariera

    Frame 1618873659 3

    Tworzone przez ludzi, którzy rozumieją e-commerce.

    Więcej informacji
  • Blog
  • Kontakt
  • Język: PL

    Wybierz język

    • DE
    • US
    • FR
    • AT
    • CH
    • NL
    • UK
    • IT
    • PL
    • ES
    • DK
  • DE
  • US
  • FR
  • AT
  • CH
  • NL
  • UK
  • IT
  • ES
  • DK
  1. Home /
  2. Listrak
GitHub

Listrak

437436448 B0a01c49 1dcf 4a71 Bcb3 63b39e1d7d84
Udostępnij

Spis treści

Bezpłatna 15-minutowa konsultacja bezpośrednio z naszymi ekspertami.

Bezpłatna konsultacja +49 421 438 1919–0
Udostępnij

Wprowadzenie

Wtyczka Listrak łączy Państwa sklep Shopware 6 z platformą marketingową Listrak i zapewnia rozszerzone funkcje, takie jak odzyskiwanie porzuconych koszyków, synchronizacja danych klientów i śledzenie zachowań w storefroncie, aby wspierać rozwój sprzedaży. Z wtyczki mogą korzystać również sklepy internetowe w Polsce, które prowadzą e-mail marketing w Listrak.

Główne funkcje

1. Synchronizacja danych klientów
Automatyczne przesyłanie rejestracji klientów i zapisów do newslettera do Listrak.
2. Synchronizacja danych zamówień
Przesyłanie informacji o zamówieniach do Listrak na potrzeby spersonalizowanych kampanii po zakupie.
3. Synchronizacja danych produktów
Przesyłanie informacji o produktach do Listrak na potrzeby spersonalizowanych kampanii po zakupie.
4. Integracja z panelem administracyjnym
Zarządzanie danymi dostępowymi API i przełącznikami funkcji bezpośrednio w panelu Shopware.
5. Odzyskiwanie porzuconych koszyków
Rejestrowanie danych koszyka i synchronizacja z Listrak na potrzeby automatycznych kampanii przypominających.
6. E-maile transakcyjne
Wysyłka e-maili transakcyjnych przez Listrak.

Kompatybilność

  • Shopware 6.6.x

Pierwsze kroki
Instalacja i aktywacja
1. Pobieranie

Git

  • Klonowanie repozytorium wtyczki:

  • Należy otworzyć terminal i w katalogu z własnymi wtyczkami Shopware 6 (zwykle custom/plugins/) wykonać następujące polecenie:

git clone https://github.com/solution25com/listrak-shopware-6-solution25.git

Packagist

composer require solution25/listrak

2. Instalacja wtyczki w Shopware 6

  • Zalogować się do panelu administracyjnego Shopware 6.

  • Przejść do Rozszerzenia > Moje rozszerzenia.

  • Odszukać nowo sklonowaną wtyczkę i kliknąć Zainstaluj.

3. Aktywacja wtyczki

  • Po instalacji kliknąć Aktywuj, aby włączyć wtyczkę.

  • W panelu Shopware przejść do Ustawienia > System > Wtyczki.

  • Przesłać lub zainstalować wtyczkę „Listrak”.

  • Po instalacji włączyć wtyczkę przełącznikiem.

4. Weryfikacja instalacji

  • Po aktywacji Listrak pojawia się na liście zainstalowanych wtyczek.

  • Nazwa, wersja i data instalacji wtyczki powinny być widoczne jak na zrzucie ekranu poniżej.

442821698 8f7ef694 4282 46aa 8ec6 Aa35045d16c8

Konfiguracja wtyczki

1. Otwarcie ustawień wtyczki

  • Przejść do Ustawienia > System > Wtyczki.

  • Wyszukać Listrak i kliknąć ikonę z trzema kropkami (...) lub nazwę wtyczki, aby otworzyć ustawienia.

2. Ustawienia Data Integration

Listrak Merchant ID
Wprowadzić Merchant ID przekazany przez Listrak.
Listrak Data Client ID
Wprowadzić Client ID z Listrak Data Integration.
Listrak Data Client Secret
Wprowadzić Client Secret z Listrak Data Integration.
Test połączenia API
Sprawdzenie połączenia z Data API.

3. Ustawienia FTP Integration

Nazwa użytkownika FTP

Wprowadzić nazwę użytkownika FTP z Listrak FTP Integration.
Hasło FTP
Wprowadzić hasło FTP z Listrak FTP Integration.

442821850 4ac4732c Da1d 4236 Aad0 2e76ffd530db

4. Ustawienia Email Integration

Marketing List ID
Wprowadzić List ID, który można znaleźć w panelu Listrak w Help & Support > API ID Information.
Transactional List ID
Wprowadzić List ID, który można znaleźć w Help & Support > API ID Information w panelu Listrak.
Listrak Email Client ID
Wprowadzić Client ID z Listrak Email Integration.
Listrak Email Client Secret
Wprowadzić Client Secret z Listrak Email Integration.
Salutation Field Id
Opcjonalnie: Field ID pola zwrotu grzecznościowego z profilu e-mail w Listrak, jeśli istnieje.
First Name Field Id
Opcjonalnie: Field ID pola imienia z profilu e-mail w Listrak, jeśli istnieje.
Last Name Field Id
Opcjonalnie: Field ID pola nazwiska z profilu e-mail w Listrak, jeśli istnieje.
Test połączenia API
Sprawdzenie połączenia z Email API.

441230989 7b1dc3b6 572e 46d3 812b 85a15b070455

5. Ustawienia synchronizacji

  • Włączyć Listrak Browser Tracking przełącznikiem.

  • Włączyć Listrak Browser Order Tracking przełącznikiem.

  • Włączyć bieżącą synchronizację klientów przełącznikiem.

  • Włączyć bieżącą synchronizację zamówień przełącznikiem.

442821910 2d2b9cd1 46dc 4379 Ab76 10bcc0be1993

6. Zapisanie konfiguracji

  • Kliknąć Zapisz w prawym górnym rogu, aby zachować ustawienia.

Wtyczka Listrak: dokumentacja API

Ten dokument opisuje własne punkty końcowe Admin API wtyczki Listrak dla Shopware 6. Za ich pomocą uprawnieni użytkownicy mogą uruchamiać pełną synchronizację danych między Shopware a Listrak.

Test połączenia z Data API

Punkt końcowy:

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

Opis
Testuje połączenie z Listrak Data API przy użyciu podanych dataClientId i dataClientSecret. W przypadku powodzenia zwraca ważny token dostępu (access token).
Nagłówki żądania

Authorization: Bearer 
Content-Type: application/json

Przykładowa treść żądania
Odpowiedź w przypadku powodzenia

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Przykładowa odpowiedź z błędem

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

Test połączenia z Email API

Punkt końcowy

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

Opis
Testuje połączenie z Listrak Email API przy użyciu podanych emailClientId i emailClientSecret. W przypadku powodzenia zwraca ważny token dostępu (access token).
Nagłówki żądania

Authorization: Bearer 
Content-Type: application/json

Przykładowa treść żądania

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

Odpowiedź w przypadku powodzenia

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Przykładowa odpowiedź z błędem

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

Jak to działa

Zdarzenia Shopware

Wtyczka reaguje na kluczowe zdarzenia Shopware, takie jak zmiany w koszyku, rejestracje klientów i zamówienia.

Dane przesyłane do Listrak

Dane są automatycznie przesyłane do Listrak przez zabezpieczone wywołania API, z ponawianiem prób i rejestrowaniem błędów.

E-maile transakcyjne

Wprowadzić Transactional List ID w ustawieniach wtyczki.
W panelu Shopware otworzyć Flow Builder w sekcji Ustawienia.
Utworzyć nowy flow.
Wybrać zdarzenie jako wyzwalacz.
Następnie wybrać akcję 'Send email with Listrak’.

442821910 2d2b9cd1 46dc 4379 Ab76 10bcc0be1993 1

vi. W otwartym oknie określić odbiorcę, Transactional Message ID oraz wszystkie pola profilu Listrak potrzebne do e-maila transakcyjnego.

442821910 2d2b9cd1 46dc 4379 Ab76 10bcc0be1993 2

vii. Po podaniu właściwych danych i zmiennych szablonu Shopware dla e-maila transakcyjnego kliknąć Add Action. W komórce Field Value można używać składni Twig.
viii. Aktywować flow i zapisać go.

Polecenia CLI

listrak:sync-products

Synchronizuje produkty dla wskazanego kanału sprzedaży z Listrak.

Argumenty:

Nazwa Opis
sales-channel-id
ID kanału sprzedaży do filtrowania produktów. (

Option Opis
--limit=
Maksymalna liczba eksportowanych produktów.
--local
Utworzenie pliku lokalnie zamiast przesyłania przez FTP.

)

Opcje:

listrak:sync-orders

Synchronizuje zamówienia dla wskazanego kanału sprzedaży z Listrak.
Argumenty:

Nazwa Opis
sales-channel-id
ID kanału sprzedaży do filtrowania. (wymagane)

Opcje:

Option Opis
--limit=
Maksymalna liczba eksportowanych zamówień.
--offset=
Przesunięcie początkowe eksportu (do przetwarzania wsadowego).
listrak:sync-newsletter-recipients

Synchronizuje odbiorców newslettera dla wskazanego kanału sprzedaży z Listrak.
Argumenty:

Nazwa Opis
sales-channel-id
ID kanału sprzedaży do filtrowania. (wymagane)

Opcje:

Option Opis
--limit=
Maksymalna liczba eksportowanych odbiorców newslettera.
--offset=
Przesunięcie początkowe eksportu (do przetwarzania wsadowego).
listrak:sync-customers

Synchronizuje klientów dla wskazanego kanału sprzedaży z Listrak.

Nazwa Opis
sales-channel-id
ID kanału sprzedaży do filtrowania. (wymagane)

Opcje:

Option Opis
--limit=
Maksymalna liczba eksportowanych klientów.
--offset=
Przesunięcie początkowe eksportu (do przetwarzania wsadowego).

FAQ

Czy potrzebne jest konto Listrak?
Tak. Do synchronizacji potrzebne jest aktywne konto Listrak, Data Integration oraz Email Integration. W przypadku sklepów w Polsce synchronizacja odbiorców newslettera powinna obejmować tylko osoby, które wyraziły zgodę na komunikację marketingową zgodnie z RODO i przepisami o komunikacji elektronicznej.

Jakich zmiennych można używać we flow dla e-maili transakcyjnych?

W zależności od typu zdarzenia dostępne są różne zmienne. Najczęściej używane to:

order

{{ order.orderNumber }}

{{ order.orderDate|date(’Y-m-d H:i’) }} (datę należy sformatować; w Polsce typowy format to d.m.Y)

{{ order.currency.isoCode }}

{{ order.lineItems }}

{{ order.deliveries }}

{{ order.transactions }}

{{ order.defaultBillingAddress.firstName }}

{{ order.defaultBillingAddress.lastName}}

{{ order.defaultBillingAddress.street}}

{{ order.defaultBillingAddress.zipcode}}

{{ order.defaultBillingAddress.city}}

{{ order.defaultBillingAddress.phoneNumber}}

itd.

salesChannel
{{ salesChannel.name }}

customer
{{ customer.firstName }}
{{ customer.lastName }}
{{ customer.email }}
itd.

Uwaga: dane takie jak pozycje zamówienia czy transakcje płatnicze należy przetwarzać w pętli za pomocą składni Twig. Jeśli planują Państwo integrację Listrak ze sklepem Shopware w Polsce, chętnie pomożemy we wdrożeniu.

Dokumentacja Wiki

Więcej o konfiguracji wtyczki w naszym WIKI.

Nasz napęd.
Państwa rozwój.

Agencja e-commerce, oprogramowania i AI.

Bezpłatna konsultacja
Firma
  • O nas
  • Wydarzenia
  • Blog
  • Kariera
Usługi
  • Agencja Shopware
  • Shopify
  • Integracje
  • Migracja
Informacje prawne
  • Polityka prywatności
  • Nota prawna
  • Shopware AI: ochrona danych
Media społecznościowe
  • LinkedIn
  • Facebook
  • Instagram
Adres
Solution25 GmbH, Bremen Marcusallee 16, 28359 Bremen, Niemcy +49 421 438 1919-0 info@solution25.com
Group 1321315537 1
Group 1321315536 1

© 2026 solution25. Wszelkie prawa zastrzeżone