Szerveroldali követés Squarespace Commerce-hez
A ROASaurus 5 percenként olvassa a kifizetett rendeléseket a Squarespace Commerce API-ból, és a szerverről elküldi őket a hirdetési platformjaidnak. Egy rendelésállapot-oldali kódrészlet minden rendelést összeköt a hirdetési kattintással.
| A Squarespace dióhéjban | |
|---|---|
| A rendelések így érkeznek | Commerce API-lekérdezés 5 percenként |
| Hozzáférési adatok | Developer API key Orders: read jogosultsággal |
| Csomag | Az API-kulcsokhoz a Commerce Advanced csomag kell |
| Kifizetett rendelések | A fizetési állapot PAID |
| Köszönőoldali kódrészlet | Order Status Page code injection, a {orderId} és {orderGrandTotal} használatával |
Hogyan csatlakozik a Squarespace
- Settings › Advanced › Code Injection › Header: illeszd be a ROASaurus scripttagjét.
- Ugyanazon az oldalon az Order Status Page alatt (digitális termékeknél az Order Confirmation Page alatt is) illeszd be a köszönőoldali kódrészletet.
- Settings › Advanced › Developer API Keys › Generate Key Orders: read jogosultsággal, majd add meg a ROASaurusban.
Miért lekérdezés és nem webhookok
A Squarespace csak OAuth-appoknak küld webhookokat, a kereskedő által API-kulccsal beállított integrációknak nem. Ezért a ROASaurus 5 percenként, 30 perces átfedéssel lekéri a legutóbbi futása óta módosult rendeléseket. A PAID fizetési állapotú rendeléseket elküldi; a duplikátumokat figyelmen kívül hagyja.
A rendelések összekötése a hirdetési kattintásokkal
A kódrészlet a Squarespace saját változóival ({orderId}, {orderGrandTotal} és {customerEmailAddress}) küldi el a ROASaurus vásárlást ugyanazzal a rendelésazonosítóval. A {.if firstPageView} blokkba van csomagolva, így ha a vásárló újratölti a rendelésállapot-oldalt, nem fut le kétszer. A kódrészlet nélkül a ROASaurus egy olyan e-mail-címre esik vissza, amelyet a látogató korábban megadott az oldaladon, például egy felugró ablakban.
Mit olvas ki a ROASaurus az egyes rendelésekből
A rendelésszám, a végösszeg és a pénznem, a vevő e-mail-címe és azonosítója, a számlázási név, telefonszám és cím, valamint minden tételsor terméke, variánsa, mennyisége, kifizetett ára és SKU-ja.
Korlátok
- Az API-kulcsokhoz a Commerce Advanced csomag kell.
- A rendelések a fizetés után legfeljebb 5 perccel érkeznek meg. A „Fetch orders now” igény szerint szinkronizál.
- A Squarespace-rendelések nem tartalmazzák a vásárló IP-címét, ezért az IP-alapú tartalék nem érhető el. Add hozzá a kódrészletet.
- A csatlakozó a platform hivatalos API-dokumentációja alapján készült. A hitelesítő adatok mentése után nyomd meg a Test connection gombot, majd adj le egy tesztrendelést, és nézd meg az Event logot.
Kapcsolódó
Kérdések, válaszok
Melyik Squarespace-csomag kell nekem?
A rendelésekhez tartozó Developer API-kulcsokhoz a Commerce Advanced csomag kell. A követőscript és a kódrészlet a Code Injection funkción keresztül működik.
Miért nem tud a Squarespace azonnal rendeléseket küldeni?
A Squarespace csak OAuth-appoknak küld webhookokat, a kereskedői API-kulcsoknak nem. A ROASaurus ehelyett 5 percenként lekérdezi a Commerce API-t.
Kétszer számít, ha újratöltöm a rendelésoldalt?
Nem. A kódrészlet csak a rendelésállapot-oldal első megtekintésekor fut le, és a ROASaurus figyelmen kívül hagyja a második vásárlást ugyanazzal a rendelésazonosítóval.
Minden eladás visszavezetve arra a hirdetésre, amelyik hozta
Szerveroldali követés, profit és ügyfél-élettartamérték egyetlen appban. 14 napos ingyenes próbaidőszak, bankkártya nélkül.
Indítsd el az ingyenes próbaidőszakot →