Integrace e-shopu

Server-side tracking pro CCV Shop

Připojte své klíče API CCV Shop a stiskněte Create webhook. CCV pak oznámí každou zaplacenou objednávku ROASaurus, který ji odešle ze serveru na vaše reklamní platformy.

CCV Shop ve zkratce
Objednávky přicházejí přesWebhook (objednávka zaplacena) a dotazování každých 5 minut
Nastavení webhookuAutomaticky tlačítkem Create webhook
Přihlašovací údajePublic key a secret key z API gegevens
Podepisování požadavkůHMAC-SHA512 u každého volání API
Snippet na poděkovací stránceStránka po dokončení objednávky s použitím Vertoshop.getOrder().getId()

Jak se CCV Shop připojuje

  1. Přidejte skript ROASaurus na všechny stránky: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, nebo blok kódu z aplikace v hlavičce.
  2. Na stránku po dokončení objednávky přidejte snippet na poděkovací stránce.
  3. Mijn webshop › Instellingen › Algemeen › API gegevens: zkopírujte public key a secret key. Pokud API gegevens nevidíte, nejprve nainstalujte aplikaci API.
  4. Zadejte oba klíče v ROASaurus, uložte je a poté stiskněte Create webhook.

Co dělá Create webhook

ROASaurus zaregistruje v CCV webhook pro událost order paid. CCV pak každou zaplacenou objednávku oznámí okamžitě. Když CCV vrátí webhook secret, ROASaurus u každého doručení kontroluje podpis HMAC-SHA512; každé doručení musí navíc nést token jedinečný pro váš obchod. ROASaurus poté z API stáhne celou objednávku a její řádky.

Každé volání API, které ROASaurus provede, je podepsané tak, jak CCV vyžaduje: hashem HMAC-SHA512 z vašeho public key, metody, adresy, těla požadavku a časového razítka.

Kontrola po 5 minutách

ROASaurus se také každých 5 minut ptá CCV na zaplacené objednávky. CCV filtruje jen podle data vytvoření, takže objednávku, která je označena jako zaplacená až dny po vytvoření, zachytí webhook, ne kontrola.

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

Celé číslo objednávky, celkovou částku, měnu, e-mail zákazníka, číslo mobilu nebo telefonu, jméno, fakturační město, PSČ a zemi, ID zákazníka a každý řádek objednávky s číslem produktu, množstvím a cenou.

Omezení

  • Objednávky z CCV neobsahují IP adresu nakupujícího, takže párování podle IP adresy není k dispozici. Přidejte snippet na poděkovací stránce.
  • Nechte webhook aktivní: spoléhají na něj opožděné platby.
  • 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

Kde najdu své klíče API CCV Shop?

V Mijn webshop › Instellingen › Algemeen › API gegevens. Pokud tato nabídka chybí, nejprve nainstalujte aplikaci API od CCV.

Co dělá snippet na stránce po dokončení objednávky?

Přečte ID objednávky pomocí Vertoshop.getOrder().getId() a odešle s ním nákup do ROASaurus, čímž objednávku propojí s návštěvníkem a jeho kliknutím na reklamu.

Odesílají se i objednávky zaplacené později?

Ano, přes webhook order paid. Kontrola po 5 minutách se dívá jen na nedávno vytvořené objednávky, proto nechte webhook aktivní.

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 →