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

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

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

Из чего состоит синхронизация

Каждая синхронизация в Tajo представляет собой правило синхронизации: проверенное и одобренное определение того, что именно переносится и как. У правила четыре части, которые можно посмотреть на его странице в разделе Connectors > Syncs:

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

Данные движутся в одном направлении: из вашего источника в Brevo. Tajo не записывает данные обратно в Shopify.

Когда данные синхронизируются

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

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

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

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

Правило синхронизации нельзя опубликовать без политики согласия, а во время запуска запись без подтверждённого согласия не записывается. Если согласие невозможно установить, Tajo отказывается от записи, а не действует наугад. Ошибка всегда в сторону «слишком осторожно», никогда «отправили лишнее».

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

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

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

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

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

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

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

Tajo считает Brevo источником истины для согласия на email-рассылки:

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

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

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

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

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

Нет двунаправленной синхронизации. Ничего не записывается обратно в Shopify: ни отписки, ни теги, ни оценки вовлечённости.
Нет синхронизации в реальном времени. Запуски выполняются пакетами по расписанию или вручную, а не потоковой передачей с задержкой меньше минуты.
Нет отслеживания остатков. Уровни запасов товаров не отслеживаются, и триггеров «снова в наличии» нет.

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

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

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

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

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

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

Можно ли сделать синхронизацию быстрее? Вы можете в любой момент запустить синхронизацию по запросу со страницы правила. Режима реального времени нет.

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

Можно ли изменить, что синхронизируется? Да: отредактируйте сопоставление полей или фильтр правила. Изменение создаёт новую версию, которая должна снова пройти одобрение публикации, прежде чем вступит в силу.

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

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

Онлайн-чат: доступен в панели Tajo (справа внизу)
Поддержка по email: [email protected]
Документация: docs.tajo.io