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

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

Дайте ROASaurus API-аккаунт уровня магазина только для чтения и нажмите Create webhook. После этого оплаченные заказы BigCommerce будут уходить в ваши рекламные платформы с сервера по мере поступления.

BigCommerce: коротко
Заказы поступают черезВебхуки (заказ создан, статус обновлён) плюс опрос каждые 5 минут
Настройка вебхукаАвтоматически, кнопкой Create webhook
Учётные данныеStore hash и access token с правом Orders: read-only
Оплаченные заказыAwaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped, Completed
Сниппет страницы благодарностиСкрипт на странице Order confirmation с {{checkout.order.id}}

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

  1. Storefront › Script Manager › Create a Script: расположение Footer, страницы All pages, тип Script, с тегом скрипта ROASaurus.
  2. Создайте второй скрипт для страницы Order confirmation со сниппетом страницы благодарности.
  3. Settings › API › Store-level API accounts › Create API account с правом Orders: read-only. Введите в ROASaurus store hash (часть после /stores/ в вашем пути API) и access token.
  4. Сохраните, затем нажмите Create webhook.

Что делает Create webhook

ROASaurus регистрирует два вебхука BigCommerce: на создание заказа и на обновление статуса заказа. Каждая доставка содержит секретный заголовок, уникальный для вашего магазина, и ROASaurus его проверяет. Вебхук сообщает только, какой заказ изменился, поэтому ROASaurus запрашивает заказ и его товары из API. Кроме того, он каждые 5 минут проверяет изменённые заказы на случай потери доставки.

Какие заказы учитываются

Заказы в статусе, означающем, что оплата прошла: Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped и Completed. Заказы в статусе Pending или отклонённые не отправляются. ROASaurus читает сумму с налогом, платёжные email, телефон, имя и адрес, id клиента, IP-адрес и каждый товар с ценой с налогом.

Связь заказов с рекламными кликами

Сниппет страницы подтверждения заказа отправляет покупку ROASaurus с {{checkout.order.id}}, что связывает заказ с посетителем. Без него ROASaurus пробует email, который посетитель ранее оставил на вашем сайте, например во всплывающем окне, затем IP-адрес заказа, но только если с этого IP был замечен ровно один посетитель в окне от 3 часов до заказа до 15 минут после него.

Ограничения

  • Заказы BigCommerce не дают ROASaurus user agent, поэтому на общих IP (офисы, мобильные сети) запасной вариант по IP часто не может принять решение. Сниппет этого избегает.
  • Коннектор создан по официальной документации API платформы. После сохранения учётных данных нажмите Test connection, затем оформите тестовый заказ и проверьте Event log.

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

FAQ

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

Какой доступ к API нужен ROASaurus?

API-аккаунт уровня магазина с правом Orders только для чтения. ROASaurus использует его, чтобы читать заказы и создавать два вебхука заказов.

Что, если вебхук не сработает?

ROASaurus также опрашивает BigCommerce каждые 5 минут с перекрытием в 30 минут. Заказы, которые у него уже есть, игнорируются, поэтому ничего не отправляется дважды.

Какие статусы BigCommerce считаются оплаченными?

Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped и Completed. Остальные статусы не учитываются, пока заказ не перейдёт в один из этих.

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

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

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