Интеграция с интернет-магазином

Серверный трекинг для CCV Shop

Подключите API keys CCV Shop и нажмите Create webhook. После этого CCV сообщает ROASaurus о каждом оплаченном заказе, а ROASaurus отправляет его в ваши рекламные платформы с сервера.

CCV Shop: коротко
Заказы поступают черезВебхук (заказ оплачен) плюс опрос каждые 5 минут
Настройка вебхукаАвтоматически, кнопкой Create webhook
Учётные данныеPublic key и secret key из API gegevens
Подпись запросовHMAC-SHA512 для каждого вызова API
Сниппет страницы благодарностиСтраница успешного заказа с Vertoshop.getOrder().getId()

Как подключается CCV Shop

  1. Добавьте скрипт ROASaurus на все страницы: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML или блок кода приложения в заголовке.
  2. Добавьте сниппет страницы благодарности на страницу успешного заказа.
  3. Mijn webshop › Instellingen › Algemeen › API gegevens: скопируйте public key и secret key. Если API gegevens нет, сначала установите приложение API.
  4. Введите оба ключа в ROASaurus, сохраните и нажмите Create webhook.

Что делает Create webhook

ROASaurus регистрирует в CCV вебхук для события order paid. После этого CCV сразу сообщает о каждом оплаченном заказе. Если CCV возвращает секрет вебхука, ROASaurus проверяет подпись HMAC-SHA512 каждой доставки; кроме того, каждая доставка должна содержать токен, уникальный для вашего магазина. Затем ROASaurus запрашивает из API полный заказ и его строки.

Каждый вызов API, который делает ROASaurus, подписывается так, как требует CCV: хешем HMAC-SHA512 от вашего public key, метода, адреса, тела запроса и временной метки.

Проверка раз в 5 минут

ROASaurus также каждые 5 минут запрашивает у CCV оплаченные заказы. CCV фильтрует только по дате создания, поэтому заказ, помеченный оплаченным через несколько дней после оформления, подхватывает вебхук, а не проверка.

Что ROASaurus читает из каждого заказа

Полный номер заказа, сумму, валюту, email клиента, номер мобильного или обычного телефона, имя, платёжные город, индекс и страну, id клиента и каждую строку заказа с номером товара, количеством и ценой.

Ограничения

  • В заказах CCV нет IP-адреса покупателя, поэтому запасной вариант по IP недоступен. Добавьте сниппет страницы благодарности.
  • Не отключайте вебхук: от него зависят поздние оплаты.
  • Коннектор создан по официальной документации API платформы. После сохранения учётных данных нажмите Test connection, затем оформите тестовый заказ и проверьте Event log.

Читайте также

FAQ

Ответы на вопросы

Где найти API keys CCV Shop?

В Mijn webshop › Instellingen › Algemeen › API gegevens. Если этого меню нет, сначала установите приложение API от CCV.

Что делает сниппет страницы успешного заказа?

Он считывает id заказа через Vertoshop.getOrder().getId() и отправляет с ним покупку ROASaurus, что связывает заказ с посетителем и его рекламным кликом.

Отправляются ли заказы, оплаченные позже?

Да, через вебхук оплаты заказа. Проверка раз в 5 минут смотрит только недавно созданные заказы, поэтому не отключайте вебхук.

Каждая продажа прослежена до рекламы, которая её принесла

Серверный трекинг, прибыль и пожизненная ценность клиента в одном приложении. 14 дней бесплатно, без банковской карты.

Начать бесплатный пробный период →