Интеграция CityAds и магазина vsesoki.ru

Задача

Магазин vsesoki.ru работает с партнерской сетью CityAds. Нужно было настроить корректную передачу конверсий по схеме Postback Last Paid Click.

Требования:

Отправлять postback только при оплате заказа
Собирать метки из трекинговой ссылки (click_id, wm_id, offer_id)
Отменять конверсию при возврате или отмене заказа
Помечать заказы в InSales как пришедшие с CPA
Установить TPM-коды для трекинга переходов
Протестировать с командой CityAds

Что такое Postback Last Paid Click

Это схема, при которой конверсия засчитывается только после оплаты заказа. Не после оформления, а именно после получения денег.

Если человек оформил заказ, но не оплатил — конверсия не отправляется. Если оплатил, а потом вернул товар — конверсия отменяется.

Решение

1. Сбор меток из ссылки

Когда покупатель переходит по партнерской ссылке, в URL есть параметры: click_id, wm_id, offer_id, utm_source и другие.

Эти параметры нужно сохранить до момента оформления заказа. Используем localStorage — данные хранятся в браузере покупателя и не теряются при переходе между страницами.

2. Отправка postback при оплате

Когда заказ переходит в статус "Оплачен", система формирует postback URL и отправляет GET-запрос в CityAds.

https://cityads.com/postback?
  click_id=12345
  &order_id=67890
  &campaign_secret=abc123
  &order_total=5000
  &status=approved

3. Отмена конверсии

Если заказ возвращают или отменяют, отправляем postback со статусом отмены. CityAds получает уведомление и аннулирует конверсию.

Это важно для честной работы с партнеркой. Вебмастер получает деньги только за реально завершенные покупки.

4. TPM-коды

TPM (Third Party Measurement) — трекинговые пиксели CityAds. Устанавливаются на страницах сайта для отслеживания переходов и действий.

Установили TPM-коды:

На всех страницах сайта — базовый трекинг
На странице оформления заказа — начало оформления
На странице подтверждения — завершение покупки

5. Метки в заказах InSales

InSales не всегда корректно сохраняет utm-параметры в заказах. Иногда они теряются или перезаписываются.

Решили через InSales API: при создании заказа добавляем в дополнительное поле метку "cityads" + click_id и offer_id. Теперь в карточке заказа всегда видно, что он пришел с CPA.

Параметры postback

click_id — ID клика в CityAds
order_id — номер заказа в InSales
campaign_secret — секретный ключ кампании
order_total — сумма заказа
status — статус (approved/cancelled)
customer_type — тип клиента (new/existing)
commission — комиссия (опционально)

6. Тестирование

Координировали тестирование с сотрудниками CityAds через Telegram. Они давали тестовые ссылки, мы проверяли корректность передачи данных.

Что проверяли:

Переход по тестовой ссылке
Сохранение меток в localStorage
Оформление тестового заказа
Отправка postback при оплате
Получение postback на стороне CityAds
Отмена заказа и отправка отменяющего postback

CityAds подтвердил корректность работы. Все параметры передаются правильно, конверсии засчитываются.

Технические детали

Работа с localStorage

При переходе по партнерской ссылке JavaScript сохраняет параметры в localStorage. Данные доступны на всех страницах сайта и не удаляются при закрытии вкладки.

Webhook на оплату

InSales отправляет webhook при смене статуса заказа. Ловим событие "статус изменен на Оплачен" и запускаем отправку postback.

Защита от дублей

Система проверяет, не отправлялся ли уже postback для этого заказа. Если отправлялся — повторно не отправляем, чтобы избежать дублирования конверсий.

Результат

Интеграция работает корректно. Postback отправляется только при оплате, отмены обрабатываются, метки сохраняются в заказах.

Магазин теперь может точно отследить, сколько продаж пришло с CityAds. В админке InSales видно, какой заказ с какого клика и от какого вебмастера.

Вебмастера получают корректную статистику. Конверсии засчитываются только по оплаченным заказам, возвраты автоматически отменяют конверсию.