Server-side tracking dla CCV Shop
Połącz klucze API CCV Shop i naciśnij Create webhook. CCV zgłasza wtedy każde opłacone zamówienie do ROASaurus, który wysyła je z serwera do twoich platform reklamowych.
| CCV Shop w skrócie | |
|---|---|
| Zamówienia docierają przez | Webhook (order paid) plus odpytywanie co 5 minut |
| Konfiguracja webhooka | Automatyczna, przyciskiem Create webhook |
| Dane dostępowe | Public key i secret key z API gegevens |
| Podpisywanie żądań | HMAC-SHA512 przy każdym wywołaniu API |
| Fragment kodu na stronie z podziękowaniem | Strona sukcesu zamówienia, z użyciem Vertoshop.getOrder().getId() |
Jak łączy się CCV Shop
- Dodaj skrypt ROASaurus do wszystkich stron: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML albo blok kodu aplikacji w nagłówku.
- Dodaj fragment kodu na stronie z podziękowaniem do strony sukcesu zamówienia.
- Mijn webshop › Instellingen › Algemeen › API gegevens: skopiuj public key i secret key. Jeśli nie widzisz API gegevens, najpierw zainstaluj aplikację API.
- Wpisz oba klucze w ROASaurus, zapisz, a potem naciśnij Create webhook.
Co robi Create webhook
ROASaurus rejestruje w CCV webhook dla zdarzenia order paid. CCV zgłasza wtedy każde opłacone zamówienie od razu. Gdy CCV zwraca webhook secret, ROASaurus sprawdza podpis HMAC-SHA512 każdej dostawy; każda dostawa musi też zawierać token unikalny dla twojego sklepu. Następnie ROASaurus pobiera z API pełne zamówienie i jego wiersze zamówienia.
Każde wywołanie API wykonywane przez ROASaurus jest podpisywane tak, jak wymaga CCV: hashem HMAC-SHA512 z twojego public key, metody, adresu, treści żądania i znacznika czasu.
Sprawdzanie co 5 minut
ROASaurus co 5 minut pyta też CCV o opłacone zamówienia. CCV filtruje tylko po dacie utworzenia, więc zamówienie oznaczone jako opłacone kilka dni po złożeniu jest wychwytywane przez webhook, a nie przez to sprawdzanie.
Co ROASaurus odczytuje z każdego zamówienia
Pełny numer zamówienia, sumę, walutę, e-mail klienta, numer telefonu komórkowego lub stacjonarnego, imię i nazwisko, miasto, kod pocztowy i kraj rozliczeniowy, id klienta oraz każdy wiersz zamówienia z numerem produktu, ilością i ceną.
Ograniczenia
- Zamówienia CCV nie zawierają adresu IP kupującego, więc dopasowanie po IP nie jest dostępne. Dodaj fragment kodu na stronie z podziękowaniem.
- Zostaw webhook aktywny: późne płatności od niego zależą.
- Konektor powstał na podstawie oficjalnej dokumentacji API platformy. Po zapisaniu danych dostępowych naciśnij Test connection, a potem złóż zamówienie testowe i sprawdź Event log.
Powiązane
Pytania i odpowiedzi
Gdzie znajdę klucze API CCV Shop?
W Mijn webshop › Instellingen › Algemeen › API gegevens. Jeśli brakuje tego menu, najpierw zainstaluj aplikację API od CCV.
Co robi fragment kodu na stronie sukcesu zamówienia?
Odczytuje id zamówienia przez Vertoshop.getOrder().getId() i uruchamia z nim zakup ROASaurus, co łączy zamówienie z odwiedzającym i jego kliknięciem w reklamę.
Czy zamówienia opłacone później też są wysyłane?
Tak, przez webhook order paid. Sprawdzanie co 5 minut obejmuje tylko niedawno utworzone zamówienia, więc zostaw webhook aktywny.
Każda sprzedaż przypisana do reklamy, która ją przyniosła
Server-side tracking, zysk i wartość życiowa klienta w jednej aplikacji. 14-dniowy darmowy okres próbny, bez karty kredytowej.
Zacznij darmowy okres próbny →