Как устроена синхронизация данных Shopify с Brevo

Tajo переносит данные Shopify в Brevo двумя способами. Приложение Tajo для Shopify обрабатывает вебхуки Shopify по мере их поступления. Правила синхронизации одобрены человеком, работают в одном направлении, выполняются пакетами и журналируются от начала до конца. В этой статье объясняется и то и другое, что в них не входит и те немногие вещи, которые приложение Tajo для Shopify записывает обратно в Shopify.

Быстрая проверка Статья предполагает, что вы уже подключили Shopify и Brevo и опубликовали хотя бы одно правило синхронизации. Если нет, начните со статьи подключение Tajo к Shopify.

По мере событий: приложение Tajo для Shopify

Приложение Tajo для Shopify подписывается на вебхуки Shopify и обрабатывает каждый из них по мере поступления. Изменения клиентов и товаров сначала ждут около четырёх секунд. Так в Brevo попадают клиенты, заказы, оформления заказов, товары, коллекции и остатки, а также события, например order_paid и cart_abandoned. В руководстве по интеграции с Shopify перечислены все темы и то, что каждая из них записывает в Brevo.

Из чего состоит правило синхронизации

Правило синхронизации представляет собой проверенное и одобренное определение того, что именно переносится и как. Агент строит его по вашему описанию, а человек одобряет. У правила четыре части, которые можно посмотреть на его странице в разделе Connections > Syncs and mappings:

Часть	Что она делает
Сопоставление полей	Каждое поле источника, поле Brevo, в которое оно записывается, и преобразование между ними
Выражение фильтра	Вычисляется для каждой записи; записи, которые не подходят под условие, пропускаются
Курсор	Отслеживает, до какого места дошла синхронизация, чтобы каждый запуск продолжал с того места, где остановился предыдущий
История запусков	Каждый запуск с числом прочитанных, записанных и ошибочных записей, а также длительностью и статусом

Правило синхронизации переносит данные в одном направлении: из вашего источника в Brevo. В Shopify оно никогда не записывает. Приложение Tajo для Shopify всё же записывает обратно в Shopify несколько вещей, например отзыв согласия и теги уровня лояльности. В статье о разрешениях Shopify перечислены все записи и условия, при которых они выполняются.

Когда выполняется правило синхронизации

Правила синхронизации выполняются пакетами. Правила синхронизации контактов по умолчанию запускаются каждые 15 минут. Активное опубликованное правило Shopify orders → Brevo orders тоже запускается каждые 15 минут, но только с фильтром согласия покупателя на маркетинг из шаблона. Правило с отредактированным фильтром выполняется, только когда вы сами его запускаете. Первый запуск правила для заказов по расписанию начинается за несколько минут до этого момента и не отправляет более ранние заказы. Каждый следующий запуск отправляет заказы, обновлённые после предыдущего. Прошлые заказы попадают в Brevo, только когда вы запускаете правило сами. На странице активного правила есть кнопка Test run (1 batch), а агент Sync Operator запускает активные правила, когда вы его об этом просите. Именно пакетные запуски позволяют проверять каждую запись, удерживать её в рамках бюджета и связывать с конкретным запуском.

Каждый запуск читает новые и изменённые записи после курсора, применяет фильтр, сопоставляет поля и записывает данные в Brevo. Запись о запуске показывает, сколько именно записей было прочитано, записано и завершилось ошибкой.

Гарантии контроля

Согласие «отказывает безопасно»

Правило, которое записывает персональные данные в Brevo, нельзя опубликовать без фильтра согласия и блокировки (suppression). Во время запуска контакт, который записывается в маркетинговую аудиторию без подтверждённого согласия, отклоняется. Если согласие невозможно установить, Tajo отказывается от записи, а не действует наугад. Ошибка всегда в сторону «слишком осторожно», никогда «отправили лишнее».

Запуски идемпотентны

Каждая запись несёт ключ, выведенный из исходной записи. Ключ является хешем, поэтому не содержит персональных данных. Повторный запуск синхронизации по тем же записям (после сбоя, паузы или вручную) не создаёт дублей.

Всё фиксируется в аудите

Публикация правила, аннулированные одобрения и автоматические приостановки фиксируются в разделе Activity. Каждое решение об одобрении сопровождается письменным обоснованием. Каждый запуск записывается в историю запусков правила. Одобрение, разрешившее публикацию, привязано к дайджесту именно того правила, которое прошло предварительный просмотр. Редактирование правила возвращает его в черновик и аннулирует одобрение, поэтому выполняется всегда именно то, что было разрешено.

Сбои приостанавливают правило

Если пять запусков подряд завершаются ошибкой, автоматический предохранитель приостанавливает правило и выводит последнюю ошибку на его странице. Устраните причину, затем опубликуйте правило повторно, чтобы возобновить работу. Частично неудачный запуск сообщает число ошибочных записей, чтобы вы точно видели, что не дошло до цели.

Как учитываются отписки

Когда контакт отписывается по ссылке в подвале письма Brevo, отказ фиксируется у контакта, и Brevo исключает его из дальнейших кампаний.
При пакетной синхронизации клиентов приложение Tajo для Shopify сравнивает время согласия в Shopify со временем отписки в Brevo и сохраняет более позднее.
Изменение согласия, которое приходит из Shopify через вебхук, записывается в Brevo так, как его сообщает Shopify.
Если контакт был подписан в Shopify, приложение Tajo для Shopify помечает его как отписанного и там. Событие Brevo переводит клиента только из подписанных в отписанные. Приложение никогда никого не подписывает, поэтому подписка в Brevo ничего не меняет в Shopify.

Какие данные доступны

Приложение Tajo для Shopify отправляет контакты, заказы, события заказов и корзин, каталог товаров и остатки. Что отправляет правило синхронизации, зависит от его сопоставления полей. Для клиентов Shopify шаблон сопоставляет поля идентификации, общую сумму покупок, число заказов, теги и согласие на рассылку с атрибутами контактов Brevo, которые можно использовать в сегментах и кампаниях. Точное сопоставление для вашего рабочего пространства не спрятано в описании: откройте правило синхронизации и прочитайте таблицу сопоставления полей. Эта таблица и есть авторитетный ответ на вопрос «что синхронизируется».

Чего Tajo не делает сегодня

Точность в границах важнее длинного списка возможностей:

Нет двусторонних правил синхронизации. Правило синхронизации записывает данные только в Brevo. Собственные записи приложения Shopify в Shopify (отзыв согласия, метаполя Brevo о вовлечённости и лояльности, теги уровня лояльности) перечислены в статье о разрешениях Shopify.
Нет правил синхронизации в реальном времени. Правила синхронизации выполняются пакетами. По мере поступления событий работает только синхронизация через вебхуки в приложении Tajo для Shopify.
Нет кнопки «снова в наличии». Приложение поддерживает остатки товаров в Brevo в актуальном состоянии и отправляет событие back_in_stock покупателям, которые попросили их уведомить. Запрос должен приходить с вашей витрины: приложение не добавляет кнопку «Notify me» в вашу тему.

Если одна из этих границ мешает вашему сценарию, сообщите команде: приоритеты раннего доступа формируются именно такой обратной связью.

Где смотреть свои данные

В Tajo: откройте правило синхронизации в разделе Connections > Syncs and mappings, чтобы увидеть историю запусков, позицию курсора и счётчики по каждому запуску. Activity фиксирует публикации и автоматические приостановки.
В Brevo: откройте Contacts (Контакты) и просмотрите атрибуты любого контакта, чтобы убедиться, что сопоставленные поля заполняются. Стройте на этих атрибутах сегменты для таргетинга.

Устранение неполадок

Контакты не появляются в Brevo: проверьте последний запуск правила на ошибки и его статус (приостановленное правило не работает). См. контакты не появляются в Brevo.
Запуски постоянно завершаются ошибкой: автоматический предохранитель приостановит правило и покажет последнюю ошибку. См. данные не синхронизируются.
Дубли контактов: записи идемпотентны для каждой исходной записи, но уже существующие дубли в Brevo остаются. См. дубли контактов.

Частые вопросы

Можно ли сделать синхронизацию быстрее? На странице активного правила есть кнопка Test run (1 batch). Для изменений по мере их появления синхронизация через вебхуки в приложении Tajo для Shopify уже охватывает клиентов, заказы, оформления заказов, товары и остатки.

Что происходит, если запуск падает на середине? Запуск сообщает число ошибочных записей, курсор продвигается только по обработанному, и следующий запуск безопасно проходит этот участок заново: ключи идемпотентности предотвращают дубли.

Можно ли изменить, что синхронизируется? Да. Попросите агента изменить сопоставление полей или фильтр правила. Изменение возвращает правило в черновик, и оно должно снова пройти предварительный просмотр и одобрение, прежде чем снова запустится.

Почему моё правило приостановилось само? Несколько неудачных запусков подряд приводят к срабатыванию предохранителя. На странице правила видно число сбоев и последнюю ошибку; устраните проблему и опубликуйте правило повторно.

Получить помощь

Свяжитесь с командой.