# Wtyczka śledzenia po stronie serwera dla Shopware

> Wtyczka Shopware 6, która wysyła konwersje do Meta, GA4 i Google Ads z serwera. Jeden klucz, zgodność ze zgodami, hosting w UE.

- Strona oryginalna: https://server-side.datafirefly.com/pl/shopware-server-side-tracking.html
- Język: pl
- Zaktualizowano: 2026-07-28
- Wydawca: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pl/

---

Wtyczka do Shopware 6.5 / 6.6: wersja 1.0.0

Zainstaluj moduł **DatafireflyServerSide** w swoim sklepie Shopware 6 i wysyłaj konwersję zakupu po stronie serwera, prosto do **Meta Conversions API (CAPI), GA4, TikTok, Pinterest i Microsoft Advertising**. Podpis HMAC osobno dla każdego sklepu, konstrukcja odporna na błędy, dzięki której usterka śledzenia nigdy nie przerwie zakupu, oraz konfigurowalna opcja zgody zgodna z RODO. Jeden klucz połączenia, żadnych identyfikatorów pikseli do wklejania w Shopware.

[Załóż konto](https://admin.datafirefly.com/pricing?lang=pl) Jak zainstalować wtyczkę

Odporność na błędy: zakup nigdy nie zostaje przerwany Podpis HMAC osobno dla każdego sklepu Hostowane w UE

Wtyczkę instaluje się jak każde rozszerzenie Shopware: plik ZIP wgrany w „Moje rozszerzenia” w panelu administracyjnym, dostęp FTP nie jest potrzebny.

Przepływ od początku do końca

**Twój sklep Shopware** wtyczka DatafireflyServerSide: zdarzenie złożenia zamówienia

**Dyspozytor DataFirefly** Hostowane w Niemczech: kanał uwierzytelniany HMAC

Meta CAPI GA4 TikTok Pinterest Microsoft Advertising

Problem

## Tagi w przeglądarce gubią Twoją sprzedaż w Shopware

Piksel Meta, tag GA4 albo tag TikTok w Twoim szablonie Shopware działa w przeglądarce klienta, a tam coraz częściej zostaje zablokowany, zanim zdąży się uruchomić.

- **Blokery reklam**

  nie pozwalają wczytać tagów na stronie potwierdzenia zamówienia: zakup nigdy nie trafia do Twoich platform.
- **Safari ITP**

  i podobne zabezpieczenia skracają albo usuwają pliki cookie, na których opierają się Twoje tagi konwersji.
- **Ograniczenia cookie i tarcia wokół zgody**

  jeszcze bardziej zawężają to, co da się zmierzyć w przeglądarce w chwili zakupu.

Efekt: niepełne konwersje z Shopware, gorsze dopasowanie danych i kampanie optymalizowane na podstawie połowicznego obrazu. Płacisz za sprzedaż, której nie potrafisz w pełni zmierzyć.

Rozwiązanie

## Konwersja zakupu z Shopware, wysłana po stronie serwera

Moduł **DatafireflyServerSide** wtyczka przechwytuje zakup w chwili, gdy **zamówienie zostaje złożone** (`checkout.order.placed` ), po stronie serwera, i wysyła go **z serwera na serwer, bezpośrednio do interfejsu API konwersji każdej platformy** (CAPI): kanału zbudowanego z myślą o wiarygodnych danych konwersyjnych z pierwszej ręki.

### Odzyskane zakupy

Konwersja zakupu nie zależy już od tego, czy tag w przeglądarce przetrwa bloker reklam i ITP, więc odzyskujesz sprzedaż, która inaczej by przepadła.

### Lepsze dopasowanie danych

Wtyczka przechwytuje dostępne identyfikatory przeglądarki (`_fbp`, `_fbc`, `_ttp`, GA `clientId`), co daje bogatszy i pewniejszy sygnał dopasowania.

### Zero ryzyka dla procesu zakupu

Odporność na błędy wpisana w konstrukcję: krótkie limity czasu i pełna obsługa wyjątków. Usterka śledzenia trafia do logów, ale nigdy nie przerywa zamówienia.

Jak to działa w Shopware

## Trzy kroki do kompletnego śledzenia zakupów

1

### Zainstaluj wtyczkę Shopware

Wgraj plik **DatafireflyServerSide** ZIP w Rozszerzenia → Moje rozszerzenia → Wgraj rozszerzenie, a następnie je aktywuj. Shopware sam rejestruje nasłuch zdarzenia zamówienia.

2

### Wklej swój klucz połączenia

Otwórz konfigurację wtyczki i wklej klucz połączenia (dfss\_…) skopiowany z ekranu „Podłącz swój sklep” w koncie DataFirefly (/app). Nie wpisujesz żadnych identyfikatorów pikseli.

3

### Zakup wychodzi po stronie serwera

Przy każdym złożonym zamówieniu zdarzenie zakupu jest podpisywane HMAC i dostarczane do dyspozytora, który rozsyła je do wszystkich skonfigurowanych miejsc docelowych. Jedna instalacja, wszystkie platformy.

Co robi wtyczka

## Konektor server-side dla Shopware, w szczegółach

### Konwersja zakupu po stronie serwera

Wysyła zdarzenie zakupu w chwili złożenia zamówienia, prosto do interfejsów API konwersji.

### Podpis HMAC-SHA256

Każde żądanie jest podpisywane osobno dla sklepu (nagłówki X-Dfss-Tenant, X-Dfss-Timestamp, X-Dfss-Signature). Dane dostępowe miejsc docelowych nigdy nie trafiają do przeglądarki.

### Odporność na błędy wpisana w konstrukcję

Krótkie limity czasu HTTP i pełna obsługa wyjątków: usterka śledzenia nigdy nie psuje procesu zakupu. Niepowodzenia trafiają do logów.

### Kontrola zgody

Opcja „Wymagaj zgody”: zakup zostaje wysłany tylko wtedy, gdy wskazany przez Ciebie plik cookie zgody jest obecny. Nazwę i wartość ustawiasz pod swój CMP, a sprawdzenie odbywa się po stronie serwera.

### Lepsze dopasowanie danych

Przechwytuje dostępne identyfikatory przeglądarki (\_fbp, \_fbc, \_ttp, GA clientId) razem z danymi zamówienia i klienta.

### Wbudowane zdarzenie testowe

Sprawdź połączenie i podpis jednym poleceniem w konsoli (`bin/console datafirefly:serverside:test`), jeszcze zanim złożysz prawdziwe zamówienie testowe.

### Jeden klucz, żadnych ujawnionych sekretów

Klucz połączenia (dfss\_…) zostaje po stronie serwera. Tokeny miejsc docelowych są u dyspozytora, nigdy w witrynie sklepu.

### Hostowane w UE

Dyspozytor działa w Niemczech: Twoje dane zostają w Unii Europejskiej.

Miejsca docelowe

## Meta CAPI, GA4, TikTok, Pinterest i Microsoft Advertising z Shopware

Konwersja zakupu z Shopware trafia po stronie serwera do interfejsów API konwersji Twoich platform. Konfigurujesz to raz, w koncie DataFirefly.

[![Meta logo: Meta Conversions API (CAPI) server-side destination](https://server-side.datafirefly.com/assets/logos/meta.svg) Meta Conversions API CAPI](https://server-side.datafirefly.com/pl/meta-capi-server-side-tracking.html) [![GA4 logo: Google Analytics 4 destination via Measurement Protocol](https://server-side.datafirefly.com/assets/logos/ga4.svg) GA4 Measurement Protocol](https://server-side.datafirefly.com/pl/ga4-server-side-tracking.html) [![TikTok logo: TikTok Events API server-side destination](https://server-side.datafirefly.com/assets/logos/tiktok.svg) TikTok Events API](https://server-side.datafirefly.com/pl/tiktok-events-api-server-side-tracking.html) [![Pinterest logo: Pinterest Conversions API server-side destination](https://server-side.datafirefly.com/assets/logos/pinterest.svg) Pinterest Conversions API](https://server-side.datafirefly.com/pl/pinterest-conversions-api-server-side-tracking.html) [![Google Ads logo: destination via Google Ads Data Manager API](https://server-side.datafirefly.com/assets/logos/google-ads.svg) Google Ads Data Manager API](https://server-side.datafirefly.com/pl/google-ads-server-side-tracking.html) [![Microsoft Advertising logo: destination via Microsoft Advertising Conversions API](https://server-side.datafirefly.com/assets/logos/microsoft-ads.svg) Microsoft Advertising Conversions API](https://server-side.datafirefly.com/pl/microsoft-ads-conversions-api-server-side-tracking.html)

Google Ads (Data Manager API) jest dostępne na poziomie platformy. Wtyczka Shopware 1.0.0 dostarcza zakup do Meta CAPI, GA4, TikTok, Pinterest i Microsoft Advertising.

Instalacja

## Zainstaluj wtyczkę server-side w Shopware

Wymagania: Shopware 6.5 lub 6.6, konto DataFirefly server-side oraz wychodzący dostęp HTTPS do serverside.datafirefly.com.

1

### Pobierz swój klucz połączenia

W sekcji „Podłącz swój sklep” w koncie DataFirefly (/app) skopiuj swój **klucz połączenia** (z przedrostkiem `dfss_…`). Zawiera wszystko, czego potrzebuje wtyczka: tenant, sekret HMAC i adres końcowy są już w nim zamknięte, nie ma innych ustawień do wpisania.

2

### Wgraj plik ZIP w panelu administracyjnym

Panel Shopware → Rozszerzenia → **Moje rozszerzenia** → **Wgraj rozszerzenie**, a następnie wybierz plik ZIP wtyczki. Potem kliknij **Włącz**. W wierszu poleceń: `bin/console plugin:install --activate DatafireflyServerSide`.

3

### Skonfiguruj wtyczkę

Otwórz **konfigurację wtyczki**. Wklej swój klucz połączenia (dfss\_…). Jeśli korzystasz z CMP, włącz **Wymagaj zgody** (domyślnie wyłączone) i podaj nazwę oraz wartość pliku cookie zgody do sprawdzenia. Przełącz **śledzenie** na włączone i zapisz.

4

### Sprawdź połączenie

Uruchom `bin/console datafirefly:serverside:test`: komunikat o powodzeniu potwierdza, że klucz i podpis są poprawne. Następnie złóż prawdziwe zamówienie testowe i otwórz **Inspector** w /app, aby potwierdzić, że zdarzenie zakupu dotarło (kwota, waluta, numer).

Błędy dostarczania trafiają do logów Shopware (wpisy z przedrostkiem `[DataFirefly SS]`). Niepowodzenie śledzenia jest logowane, ale nigdy nie przerywa zamówienia.

Cennik

## Prosty cennik, który rośnie razem ze sklepem

Jedna subskrypcja obejmuje całe Twoje konto i wszystkie jego sklepy Shopware, na jednej zbiorczej fakturze. Wyższy plan to więcej witryn i więcej zdarzeń miesięcznie.

### Za darmo

Bezpłatnie, dopóki mieścisz się w miesięcznym limicie: przekroczenie niczego nie psuje.

€0 / miesiąc

**1** witryna w cenie

Do **10,000** zdarzeń / miesiąc

Bez karty płatniczej

[Zacznij za darmo](https://server-side.datafirefly.com/en/free.html)

### Starter

Dla jednego sklepu Shopware, który wdraża śledzenie po stronie serwera.

**€39** / miesiąc (Miesięcznie) · **€32** / miesiąc (Rocznie 2 miesiące gratis)

Fakturowane 390 € rocznie: zobowiązanie na 12 miesięcy, bez zwrotu proporcjonalnego.

**1** witryna w cenie

Do **500 tys.** zdarzeń / miesiąc

Jedna zbiorcza faktura

[Wybieram Starter](https://admin.datafirefly.com/pricing?lang=pl&plan=starter)

Najczęściej wybierany

### Growth

Dla sprzedawców i małych agencji prowadzących do pięciu sklepów.

**€119** / miesiąc (Miesięcznie) · **€99** / miesiąc (Rocznie 2 miesiące gratis)

Fakturowane 1 190 € rocznie: zobowiązanie na 12 miesięcy, bez zwrotu proporcjonalnego.

**5** witryn w cenie

Do **2M** zdarzeń / miesiąc

Jedna zbiorcza faktura

[Wybieram Growth](https://admin.datafirefly.com/pricing?lang=pl&plan=growth)

### Scale

Dla agencji i portfeli obsługujących do dwudziestu sklepów przy większym wolumenie.

**€349** / miesiąc (Miesięcznie) · **€290** / miesiąc (Rocznie 2 miesiące gratis)

Fakturowane 3 490 € rocznie: zobowiązanie na 12 miesięcy, bez zwrotu proporcjonalnego.

**20** witryn w cenie

Do **10 mln** zdarzeń / miesiąc

Jedna zbiorcza faktura

[Wybieram Scale](https://admin.datafirefly.com/pricing?lang=pl&plan=scale)

Wtyczka Shopware jest w każdym planie. Zobacz [pełny cennik na stronie głównej](https://server-side.datafirefly.com/pl/#pricing).

Zaufanie i RODO

## Zbudowane pod europejskie standardy prywatności

**Hostowane w UE (Niemcy)**

Twoje dane są przetwarzane w Unii Europejskiej.

**Ingest uwierzytelniany HMAC**

Każde żądanie zakupu jest podpisywane osobno dla sklepu (HMAC-SHA256).

**Zgodne ze zgodą użytkownika**

Przy opcji „Wymagaj zgody” zakup zostaje wysłany tylko wtedy, gdy ustawiony plik cookie zgody jest obecny, co sprawdzamy po stronie serwera.

**Dane dostępowe nigdy nie ujawniane**

Tokeny miejsc docelowych zostają po stronie dyspozytora, nigdy w przeglądarce.

**Jeden klucz połączenia**

Klucz dfss\_… zawiera wszystko: w sklepie nigdy nie ląduje żaden token miejsca docelowego.

**Cel dostępności 99,5%**

Mierzony i śledzony na bieżąco na naszej [publicznej stronie statusu](https://serverside.datafirefly.com/status), zgodnie z naszym SLA.

FAQ

## Najczęstsze pytania: wtyczka Shopware

### Czym jest wtyczka śledzenia po stronie serwera dla Shopware?

Moduł **DatafireflyServerSide** wtyczka (wersja 1.0.0, zgodna z Shopware 6.5 i 6.6) wysyła konwersję zakupu z serwera na serwer, prosto do interfejsu API konwersji każdej platformy (Meta CAPI, GA4, TikTok, Pinterest, Microsoft Advertising). Zdarzenie zakupu uruchamia się w chwili złożenia zamówienia i jest podpisywane HMAC dla Twojego sklepu. Dane dostępowe miejsc docelowych nigdy nie przechodzą przez przeglądarkę.

### Czy wtyczka może zepsuć proces zakupu w moim sklepie Shopware?

Nie. Wtyczka jest odporna na błędy z założenia: krótkie limity czasu HTTP i pełna obsługa wyjątków sprawiają, że usterka śledzenia nie przerwie ani zamówienia, ani procesu zakupu. Nieudane dostarczenie trafia do logów (z przedrostkiem `[DataFirefly SS]` w logach Shopware), ale zamówienie zawsze kończy się normalnie.

### Czy muszę wklejać identyfikatory pikseli do Shopware?

Nie. Wklejasz tylko klucz połączenia (`dfss_…`), skopiowany z ekranu „Podłącz swój sklep” w koncie DataFirefly (/app). Dyspozytor wie, do których miejsc docelowych rozesłać zdarzenie. Nigdy nie wklejasz do sklepu identyfikatora piksela ani tokenu dostępu.

### Czy wtyczka respektuje zgodę wymaganą przez RODO?

Tak, przez opcję **Wymagaj zgody** (domyślnie wyłączoną). Po jej włączeniu zakup zostaje wysłany tylko wtedy, gdy wskazany przez Ciebie plik cookie zgody jest obecny: nazwa i wartość są konfigurowalne, a sprawdzenie odbywa się po stronie serwera. Shopware 6 nie udostępnia jednego pliku cookie zgody marketingowej czytelnego po stronie serwera, więc wtyczka dopasowuje się do rozwiązania zgód w Twoim sklepie. Dyspozytor jest hostowany w UE (Niemcy), a dane osobowe są maskowane.

### Czy muszę hostować kontener server-side GTM?

Nie. DataFirefly wysyła zdarzenia bezpośrednio do interfejsu API konwersji każdej platformy: nie ma kontenera server-side GTM do hostowania ani utrzymywania. Konfiguracja ogranicza się do wtyczki Shopware i jednego klucza połączenia.

Pracujesz na innej platformie? Poznaj [Moduł śledzenia po stronie serwera dla PrestaShop](https://server-side.datafirefly.com/pl/prestashop-server-side-tracking.html) albo [Wtyczka śledzenia po stronie serwera dla WooCommerce](https://server-side.datafirefly.com/pl/woocommerce-server-side-tracking.html).

## Przenieś śledzenie swojego sklepu Shopware na stronę serwera

Wysyłaj konwersję zakupu po stronie serwera do Meta CAPI, GA4, TikTok, Pinterest i Microsoft Advertising: z podpisem HMAC, bez ryzyka dla procesu zakupu, z hostingiem w UE i poszanowaniem zgód.

[Załóż konto](https://admin.datafirefly.com/pricing?lang=pl) [Napisz do nas](https://server-side.datafirefly.com/pl/contact.html)
