Integracja ze sklepem internetowym

Server-side tracking dla Shopware 6

Dodaj integrację Shopware z dostępem do odczytu zamówień, a ROASaurus będzie synchronizować opłacone zamówienia z Admin API. Webhook Flow Builder sprawia, że docierają w chwili opłacenia.

Shopware w skrócie
Zamówienia docierają przezOdpytywanie Admin API co 5 minut; natychmiast z webhookiem Flow Builder
Dane dostępoweAccess key ID integracji i secret access key
Opłacone zamówieniaTransakcja w stanie paid
Id zamówieniaNumer zamówienia Shopware
Fragment kodu na stronie z podziękowaniemszablon checkout/finish, używający page.order.orderNumber

Jak łączy się Shopware

  1. Dodaj skrypt ROASaurus do swojego motywu (base.html.twig, blok base_script_tracking) albo przez wtyczkę menedżera tagów.
  2. Settings › System › Integrations › Add integration, z dostępem do odczytu zamówień. Wpisz access key ID i secret access key w ROASaurus.
  3. Aby dopasowanie było dokładne, dodaj fragment kodu na stronie z podziękowaniem do storefront/page/checkout/finish/index.html.twig.

ROASaurus wymienia klucze integracji na krótkotrwały token Admin API i co 5 minut wyszukuje zamówienia zaktualizowane od ostatniego uruchomienia. Zamówienie liczy się jako opłacone, gdy jedna z jego transakcji jest w stanie paid. Numer zamówienia jest używany jako id, które wysyła też fragment kodu na stronie z podziękowaniem.

Natychmiastowe zamówienia z Flow Builder

W Shopware Evolve i wyższych utwórz flow z wyzwalaczem State Enter / Order Transaction / State / Paid i akcją Call URL (Webhook), POST na adres URL webhooka ROASaurus. Wywołanie jest tylko sygnałem: ROASaurus nie ufa jego treści, tylko pobiera zamówienia z ostatnich dwóch godzin przez uwierzytelnione API. Zamówienia, które już ma, są ignorowane.

Co ROASaurus odczytuje z każdego zamówienia

Sumę, walutę, datę zamówienia, e-mail i imię klienta, telefon, miasto, kod pocztowy i kraj rozliczeniowy, id klienta oraz pozycje produktów z ich ilością, ceną jednostkową i numerem produktu.

Łączenie zamówień z kliknięciami w reklamy

Fragment kodu na stronie z podziękowaniem uruchamia zakup ROASaurus z numerem zamówienia i sumą, co łączy zamówienie z odwiedzającym. Bez niego ROASaurus używa e-maila, który odwiedzający podał wcześniej na twojej stronie, na przykład w popupie.

Ograniczenia

  • Shopware domyślnie anonimizuje adres IP klienta, więc dopasowanie po IP rzadko pomaga. Dodaj fragment kodu na stronie z podziękowaniem.
  • Webhooki Flow Builder wymagają Shopware Evolve lub wyższego. Bez nich zamówienia docierają do 5 minut.
  • Konektor powstał na podstawie oficjalnej dokumentacji API platformy. Po zapisaniu danych dostępowych naciśnij Test connection, a potem złóż zamówienie testowe i sprawdź Event log.

Powiązane

FAQ

Pytania i odpowiedzi

Czy potrzebuję Flow Builder?

Nie. Bez niego ROASaurus pobiera opłacone zamówienia co 5 minut. Webhook Flow Builder, dostępny w Shopware Evolve i wyższych, sprawia tylko, że docierają od razu.

Czy webhook Flow Builder jest bezpieczny?

ROASaurus traktuje go tylko jako sygnał. Nigdy nie bierze danych zamówienia z wywołania; pobiera ostatnie zamówienia przez Admin API z twoimi kluczami integracji.

Jakiego dostępu potrzebuje integracja?

Dostępu do odczytu zamówień. ROASaurus używa access key ID i sekretu integracji, aby uzyskać krótkotrwały token Admin API.

Każda sprzedaż przypisana do reklamy, która ją przyniosła

Server-side tracking, zysk i wartość życiowa klienta w jednej aplikacji. 14-dniowy darmowy okres próbny, bez karty kredytowej.

Zacznij darmowy okres próbny →