Server-side tracking dla sklepów Ecwid
ROASaurus odczytuje opłacone zamówienia Ecwid przez token aplikacji niestandardowej i wysyła je z serwera do twoich platform reklamowych. Poproś wsparcie Ecwid o webhooki, a zamówienia będą docierać natychmiast.
| Ecwid w skrócie | |
|---|---|
| Zamówienia docierają przez | Odpytywanie API co 5 minut; webhooki, gdy wsparcie Ecwid je włączy |
| Dane dostępowe | Store ID, secret token aplikacji niestandardowej oraz jej client secret dla webhooków |
| Weryfikacja webhooka | Podpis HMAC z użyciem client secret |
| Opłacone zamówienia | Status płatności PAID |
| Fragment kodu na stronie z podziękowaniem | Ecwid.OnOrderPlaced, po skrypcie trackingowym |
Jak łączy się Ecwid
- Dodaj skrypt ROASaurus do witryny, w której osadzony jest twój sklep Ecwid, albo do własnego kodu Instant Site.
- Dodaj po nim fragment kodu na stronie z podziękowaniem. Nasłuchuje on zdarzenia
OnOrderPlacedz Ecwid i uruchamia zakup ROASaurus z numerem zamówienia, sumą i e-mailem. - Na my.ecwid.com/#develop-apps utwórz aplikację niestandardową z dostępem do odczytu zamówień. Wpisz w ROASaurus swój store ID (widoczny w adresie URL panelu admina i w Account › Summary) oraz token aplikacji
secret_….
Następnie ROASaurus co 5 minut pobiera zamówienia zaktualizowane od ostatniego uruchomienia i wysyła te ze statusem płatności PAID.
Natychmiastowe zamówienia z webhookami
Adresy URL webhooków dla aplikacji niestandardowych ustawia w Ecwid zespół wsparcia API. Poproś o ustawienie adresu webhooka twojej aplikacji na ten z karty Connection w ROASaurus, ze zdarzeniami order.created i order.updated. Wklej w ROASaurus client secret aplikacji: każdy webhook jest sprawdzany względem swojego podpisu HMAC, a zamówienie jest potem pobierane z API.
Co ROASaurus odczytuje z każdego zamówienia
Sumę, walutę, e-mail, imię i nazwisko, telefon i adres rozliczeniowy, id klienta oraz pozycje z ich kombinacją, ilością, ceną i SKU. Zamówienia Ecwid zawierają adres IP i user agent kupującego, więc ROASaurus może też dopasować po tym samym IP i przeglądarce, ale tylko gdy pasuje dokładnie jeden odwiedzający.
Ograniczenia
- Webhooki wymagają prośby do wsparcia Ecwid. Do tego czasu zamówienia docierają do 5 minut.
- Ecwid podaje imię i nazwisko w jednym polu, które ROASaurus dzieli na imię i nazwisko.
- 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
Pytania i odpowiedzi
Dlaczego muszę kontaktować się z Ecwid w sprawie webhooków?
Ecwid konfiguruje adres URL webhooka aplikacji niestandardowej przez swoje wsparcie API. Odpytywanie co 5 minut działa bez nich.
Do czego służy client secret?
Potwierdza, że webhook naprawdę pochodzi z Ecwid. ROASaurus sprawdza za jego pomocą podpis HMAC każdego webhooka, zanim pobierze zamówienie.
Czy działa z Ecwid osadzonym w innej witrynie?
Tak. Dodaj skrypt ROASaurus i fragment kodu na stronie z podziękowaniem do witryny, w której osadzony jest twój sklep Ecwid.
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 →