Server-side tracking dla Squarespace Commerce
ROASaurus co 5 minut odczytuje opłacone zamówienia z Squarespace Commerce API i wysyła je z serwera do twoich platform reklamowych. Fragment kodu na stronie statusu zamówienia łączy każde zamówienie z kliknięciem w reklamę.
| Squarespace w skrócie | |
|---|---|
| Zamówienia docierają przez | Odpytywanie Commerce API co 5 minut |
| Dane dostępowe | Klucz Developer API z uprawnieniem Orders: read |
| Plan | Klucze API wymagają planu Commerce Advanced |
| Opłacone zamówienia | Status płatności PAID |
| Fragment kodu na stronie z podziękowaniem | Code Injection w Order Status Page, z użyciem {orderId} i {orderGrandTotal} |
Jak łączy się Squarespace
- Settings › Advanced › Code Injection › Header: wklej znacznik skryptu ROASaurus.
- Na tej samej stronie, w sekcji Order Status Page (oraz Order Confirmation Page dla produktów cyfrowych), wklej fragment kodu na stronę z podziękowaniem.
- Settings › Advanced › Developer API Keys › Generate Key z uprawnieniem Orders: read, a potem wpisz go w ROASaurus.
Dlaczego odpytywanie, a nie webhooki
Squarespace wysyła webhooki tylko do aplikacji OAuth, a nie do integracji, które sprzedawca konfiguruje za pomocą klucza API. Dlatego ROASaurus co 5 minut pobiera zamówienia zmodyfikowane od ostatniego uruchomienia, z 30-minutowym nakładaniem się przedziałów. Wysyłane są zamówienia ze statusem płatności PAID; duplikaty są ignorowane.
Łączenie zamówień z kliknięciami w reklamy
Fragment kodu używa własnych zmiennych Squarespace, {orderId}, {orderGrandTotal} i {customerEmailAddress}, aby uruchomić zakup ROASaurus z tym samym id zamówienia. Jest opakowany w {.if firstPageView}, więc kupujący, który odświeży stronę statusu zamówienia, nie uruchomi go dwa razy. Bez tego fragmentu ROASaurus wraca do e-maila, który odwiedzający podał wcześniej na twojej stronie, na przykład w popupie.
Co ROASaurus odczytuje z każdego zamówienia
Numer zamówienia, sumę końcową i walutę, e-mail i id klienta, imię i nazwisko, telefon i adres rozliczeniowy oraz produkt, wariant, ilość, zapłaconą cenę i SKU każdej pozycji.
Ograniczenia
- Klucze API wymagają planu Commerce Advanced.
- Zamówienia docierają do 5 minut po płatności. „Fetch orders now” synchronizuje na żądanie.
- Zamówienia Squarespace nie zawierają adresu IP kupującego, więc dopasowanie po IP nie jest dostępne. Dodaj fragment kodu.
- 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
Jakiego planu Squarespace potrzebuję?
Klucze Developer API do zamówień wymagają planu Commerce Advanced. Skrypt trackingowy i fragment kodu działają przez Code Injection.
Dlaczego Squarespace nie może wysyłać zamówień natychmiast?
Squarespace wysyła webhooki tylko do aplikacji OAuth, a nie do kluczy API sprzedawców. ROASaurus zamiast tego co 5 minut odpytuje Commerce API.
Czy odświeżenie strony zamówienia policzy się dwa razy?
Nie. Fragment kodu uruchamia się tylko przy pierwszym wyświetleniu strony statusu zamówienia, a ROASaurus ignoruje drugi zakup z tym samym id zamówienia.
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 →