Integrace e-shopu

Server-side tracking pro BigCommerce

Předejte ROASaurus účet API na úrovni obchodu jen pro čtení a stiskněte Create webhook. Zaplacené objednávky z BigCommerce pak odcházejí ze serveru na vaše reklamní platformy průběžně, jakmile dorazí.

BigCommerce ve zkratce
Objednávky přicházejí přesWebhooky (vytvoření objednávky, změna stavu) a dotazování každých 5 minut
Nastavení webhookuAutomaticky tlačítkem Create webhook
Přihlašovací údajeStore hash a přístupový token s oprávněním Orders: read-only
Zaplacené objednávkyAwaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped, Completed
Snippet na poděkovací stránceSkript na stránce Order confirmation s použitím {{checkout.order.id}}

Jak se BigCommerce připojuje

  1. Storefront › Script Manager › Create a Script: umístění Footer, stránky All pages, typ Script, se značkou skriptu ROASaurus.
  2. Vytvořte druhý skript pro stránku Order confirmation se snippetem na poděkovací stránce.
  3. Settings › API › Store-level API accounts › Create API account s oprávněním Orders: read-only. Zadejte v ROASaurus store hash (část za /stores/ ve vaší cestě API) a přístupový token.
  4. Uložte a poté stiskněte Create webhook.

Co dělá Create webhook

ROASaurus zaregistruje dva webhooky BigCommerce, pro vytvoření objednávky a pro změnu stavu objednávky. Každé doručení nese tajnou hlavičku jedinečnou pro váš obchod, kterou ROASaurus kontroluje. Webhook říká jen to, která objednávka se změnila, takže ROASaurus stáhne objednávku a její produkty z API. Změněné objednávky navíc kontroluje každých 5 minut pro případ, že by se doručení ztratilo.

Které objednávky se počítají

Objednávky ve stavu, který znamená, že platba proběhla: Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped a Completed. Čekající nebo zamítnuté objednávky se neodesílají. ROASaurus čte celkovou částku včetně daně, fakturační e-mail, telefon, jméno a adresu, ID zákazníka, IP adresu a každý produkt s jeho cenou včetně daně.

Propojení objednávek s kliknutími na reklamy

Snippet na potvrzovací stránce objednávky odešle nákup do ROASaurus s {{checkout.order.id}}, čímž objednávku propojí s návštěvníkem. Bez něj ROASaurus zkusí e-mail, který návštěvník dříve zadal na vašem webu, například v popupu, a poté IP adresu objednávky, ale jen když na dané IP adrese byl od 3 hodin před objednávkou do 15 minut po ní vidět právě jeden návštěvník.

Omezení

  • Objednávky z BigCommerce neposkytují ROASaurus žádný user agent, takže na sdílených IP adresách (kanceláře, mobilní sítě) se párování podle IP adresy často nedokáže rozhodnout. Snippet tomu předchází.
  • Konektor je vytvořený podle oficiální dokumentace API dané platformy. Po uložení přihlašovacích údajů stiskněte Test connection, poté vytvořte testovací objednávku a zkontrolujte Event log.

Související

Časté dotazy

Otázky a odpovědi

Jaký přístup k API ROASaurus potřebuje?

Účet API na úrovni obchodu s oprávněním Orders nastaveným jen pro čtení. ROASaurus ho používá ke čtení objednávek a k vytvoření svých dvou webhooků objednávek.

Co když webhook selže?

ROASaurus se navíc každých 5 minut dotazuje BigCommerce s 30minutovým překryvem. Objednávky, které už má, ignoruje, takže se nic neodešle dvakrát.

Které stavy BigCommerce se považují za zaplacené?

Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped a Completed. Ostatní stavy se vynechávají, dokud objednávka nepřejde do jednoho z těchto.

Každý prodej dohledaný k reklamě, která ho přinesla

Server-side tracking, zisk a celoživotní hodnota zákazníka v jedné aplikaci. 14denní zkušební verze zdarma, bez platební karty.

Začněte svou zkušební verzi zdarma →