Integrace e-shopu

Server-side tracking pro obchody na Ecwid

ROASaurus čte zaplacené objednávky z Ecwid pomocí tokenu vlastní aplikace a odesílá je ze serveru na vaše reklamní platformy. Požádejte podporu Ecwid o webhooky a objednávky budou dorážet okamžitě.

Ecwid ve zkratce
Objednávky přicházejí přesDotazování API každých 5 minut; webhooky, jakmile je podpora Ecwid zapne
Přihlašovací údajeStore ID, secret token vlastní aplikace a její client secret pro webhooky
Ověření webhookuPodpis HMAC s client secret
Zaplacené objednávkyStav platby PAID
Snippet na poděkovací stránceEcwid.OnOrderPlaced, za trackovacím skriptem

Jak se Ecwid připojuje

  1. Přidejte skript ROASaurus na web, který váš obchod Ecwid vkládá, nebo do vlastního kódu vašeho Instant Site.
  2. Za něj přidejte snippet na poděkovací stránce. Naslouchá události OnOrderPlaced z Ecwid a odešle nákup do ROASaurus s číslem objednávky, celkovou částkou a e-mailem.
  3. Na my.ecwid.com/#develop-apps vytvořte vlastní aplikaci s přístupem pro čtení k objednávkám. V ROASaurus zadejte své store ID (zobrazuje se v URL administrace a v části Account › Summary) a token aplikace secret_….

ROASaurus poté každých 5 minut stahuje objednávky aktualizované od posledního běhu a odesílá ty se stavem platby PAID.

Okamžité objednávky přes webhooky

Ecwid nastavuje URL webhooků pro vlastní aplikace prostřednictvím svého týmu podpory API. Požádejte ho, aby nastavil URL webhooku vaší aplikace na tu z karty Connection v ROASaurus, s událostmi order.created a order.updated. Client secret aplikace vložte do ROASaurus: každý webhook se ověří podle svého podpisu HMAC a objednávka se poté stáhne z API.

Co ROASaurus čte z každé objednávky

Celkovou částku, měnu, e-mail, fakturační jméno, telefon a adresu, ID zákazníka a položky s jejich kombinací, množstvím, cenou a SKU. Objednávky z Ecwid obsahují IP adresu a user agent nakupujícího, takže ROASaurus může objednávku spárovat i podle stejné IP adresy a prohlížeče, ale jen když odpovídá právě jeden návštěvník.

Omezení

  • Webhooky vyžadují žádost podpoře Ecwid. Do té doby trvá doručení objednávek až 5 minut.
  • Ecwid poskytuje jedno pole pro jméno, které ROASaurus rozdělí na křestní jméno a příjmení.
  • 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

Proč musím kvůli webhookům kontaktovat Ecwid?

Ecwid nastavuje URL webhooku vlastní aplikace prostřednictvím podpory API. Dotazování každých 5 minut funguje i bez nich.

K čemu slouží client secret?

Ověřuje, že webhook skutečně pochází z Ecwid. ROASaurus pomocí něj před stažením objednávky zkontroluje podpis HMAC každého webhooku.

Funguje to, když je Ecwid vložený na jiném webu?

Ano. Přidejte skript ROASaurus a snippet na poděkovací stránce na web, který váš obchod Ecwid vkládá.

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 →