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řes | Dotazování API každých 5 minut; webhooky, jakmile je podpora Ecwid zapne |
| Přihlašovací údaje | Store ID, secret token vlastní aplikace a její client secret pro webhooky |
| Ověření webhooku | Podpis HMAC s client secret |
| Zaplacené objednávky | Stav platby PAID |
| Snippet na poděkovací stránce | Ecwid.OnOrderPlaced, za trackovacím skriptem |
Jak se Ecwid připojuje
- Přidejte skript ROASaurus na web, který váš obchod Ecwid vkládá, nebo do vlastního kódu vašeho Instant Site.
- Za něj přidejte snippet na poděkovací stránce. Naslouchá události
OnOrderPlacedz Ecwid a odešle nákup do ROASaurus s číslem objednávky, celkovou částkou a e-mailem. - 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í
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 →