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

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

ROASaurus каждые 5 минут читает оплаченные заказы из Squarespace Commerce API и отправляет их в ваши рекламные платформы с сервера. Сниппет страницы статуса заказа связывает каждый заказ с рекламным кликом.

Squarespace: коротко
Заказы поступают черезОпрос Commerce API каждые 5 минут
Учётные данныеDeveloper API key с правом Orders: read
ТарифДля API keys нужен тариф Commerce Advanced
Оплаченные заказыСтатус оплаты PAID
Сниппет страницы благодарностиCode Injection на Order Status Page с {orderId} и {orderGrandTotal}

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

  1. Settings › Advanced › Code Injection › Header: вставьте тег скрипта ROASaurus.
  2. На той же странице в разделе Order Status Page (и Order Confirmation Page для цифровых товаров) вставьте сниппет страницы благодарности.
  3. Settings › Advanced › Developer API Keys › Generate Key с правом Orders: read, затем введите ключ в ROASaurus.

Почему опрос, а не вебхуки

Squarespace отправляет вебхуки только OAuth-приложениям, но не интеграциям, которые продавец настраивает с помощью API key. Поэтому ROASaurus каждые 5 минут запрашивает заказы, изменённые с момента последнего запуска, с перекрытием в 30 минут. Отправляются заказы со статусом оплаты PAID; дубликаты игнорируются.

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

Сниппет использует собственные переменные Squarespace — {orderId}, {orderGrandTotal} и {customerEmailAddress}, — чтобы отправить покупку ROASaurus с тем же id заказа. Он обёрнут в {.if firstPageView}, поэтому покупатель, который перезагрузит страницу статуса заказа, не отправит покупку дважды. Без сниппета ROASaurus использует email, который посетитель ранее оставил на вашем сайте, например во всплывающем окне.

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

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

Ограничения

  • Для API keys нужен тариф Commerce Advanced.
  • Заказы поступают с задержкой до 5 минут после оплаты. «Fetch orders now» синхронизирует их по требованию.
  • В заказах Squarespace нет IP-адреса покупателя, поэтому запасной вариант по IP недоступен. Добавьте сниппет.
  • Коннектор создан по официальной документации API платформы. После сохранения учётных данных нажмите Test connection, затем оформите тестовый заказ и проверьте Event log.

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

FAQ

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

Какой тариф Squarespace мне нужен?

Для developer API keys к заказам нужен тариф Commerce Advanced. Скрипт отслеживания и сниппет работают через Code Injection.

Почему Squarespace не может отправлять заказы мгновенно?

Squarespace отправляет вебхуки только OAuth-приложениям, но не по API keys продавцов. Поэтому ROASaurus каждые 5 минут опрашивает Commerce API.

Будет ли перезагрузка страницы заказа засчитана дважды?

Нет. Сниппет срабатывает только при первом просмотре страницы статуса заказа, а вторую покупку с тем же id заказа ROASaurus игнорирует.

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

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

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