Integrare cu magazine online

Tracking server-side pentru Squarespace Commerce

ROASaurus citește comenzile plătite din Squarespace Commerce API la fiecare 5 minute și le trimite către platformele tale de publicitate de pe server. Un snippet pe pagina de stare a comenzii leagă fiecare comandă de click-ul pe reclamă.

Squarespace pe scurt
Comenzile ajung prinInterogare Commerce API la fiecare 5 minute
CredențialeCheie API de dezvoltator cu Orders: read
PlanCheile API necesită planul Commerce Advanced
Comenzi plătiteStarea plății PAID
Snippet de pe pagina de mulțumireCode injection pe Order Status Page, cu {orderId} și {orderGrandTotal}

Cum se conectează Squarespace

  1. Settings › Advanced › Code Injection › Header: lipește tag-ul de script ROASaurus.
  2. Pe aceeași pagină, la Order Status Page (și Order Confirmation Page pentru produsele digitale), lipește snippet-ul de pe pagina de mulțumire.
  3. Settings › Advanced › Developer API Keys › Generate Key cu Orders: read, apoi introdu-o în ROASaurus.

De ce interogare și nu webhook-uri

Squarespace trimite webhook-uri doar către aplicațiile OAuth, nu și către integrările pe care un comerciant le configurează cu o cheie API. De aceea ROASaurus preia comenzile modificate de la ultima rulare, la fiecare 5 minute, cu o suprapunere de 30 de minute. Sunt trimise comenzile cu starea plății PAID; duplicatele sunt ignorate.

Asocierea comenzilor cu click-urile pe reclame

Snippet-ul folosește variabilele proprii ale Squarespace, {orderId}, {orderGrandTotal} și {customerEmailAddress}, ca să declanșeze achiziția ROASaurus cu același id de comandă. Este învelit în {.if firstPageView}, așa că un cumpărător care reîncarcă pagina de stare a comenzii nu îl declanșează de două ori. Fără snippet, ROASaurus folosește ca alternativă un email pe care vizitatorul l-a lăsat mai devreme pe site-ul tău, de exemplu într-un popup.

Ce citește ROASaurus din fiecare comandă

Numărul comenzii, totalul general și moneda, emailul și id-ul clientului, numele, telefonul și adresa de facturare și, pentru fiecare linie de comandă, produsul, varianta, cantitatea, prețul plătit și SKU-ul.

Limite

  • Cheile API necesită planul Commerce Advanced.
  • Comenzile ajung până la 5 minute după plată. „Fetch orders now” sincronizează la cerere.
  • Comenzile Squarespace nu includ adresa IP a cumpărătorului, așa că varianta de rezervă prin IP nu este disponibilă. Adaugă snippet-ul.
  • Conectorul este construit pe baza documentației API oficiale a platformei. Apasă Test connection după ce salvezi credențialele, apoi plasează o comandă de test și verifică Event log.

Articole conexe

Întrebări frecvente

Întrebări, cu răspunsuri

De ce plan Squarespace am nevoie?

Cheile API de dezvoltator pentru comenzi necesită planul Commerce Advanced. Scriptul de tracking și snippet-ul funcționează prin Code Injection.

De ce nu poate Squarespace să trimită comenzile instant?

Squarespace trimite webhook-uri doar către aplicațiile OAuth, nu și către cheile API ale comercianților. În schimb, ROASaurus interoghează Commerce API la fiecare 5 minute.

Se numără de două ori dacă pagina comenzii este reîncărcată?

Nu. Snippet-ul rulează doar la prima vizualizare a paginii de stare a comenzii, iar ROASaurus ignoră a doua achiziție cu același id de comandă.

Fiecare vânzare, urmărită până la reclama care a adus-o

Tracking server-side, profit și lifetime value într-o singură aplicație. Probă gratuită de 14 zile, fără card bancar.

Începe proba gratuită →