Разбиране на синхронизацията на Shopify данни с Brevo

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

Бърза проверка Тази статия предполага, че сте свързали Shopify и Brevo и сте публикували поне едно правило за синхронизация. Ако не сте, започнете със свързване на Tajo с Shopify.

Докато се случват събитията: приложението на Tajo за Shopify

Приложението на Tajo за Shopify се абонира за webhooks на 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, не може да бъде публикувано без филтъра за съгласие и блокиране. По време на изпълнение контакт, записван в маркетингова аудитория без доказуемо съгласие, се отказва. Когато съгласието не може да бъде установено, Tajo отказва записа, вместо да гадае. Режимът на отказ винаги е „прекалено предпазливо”, никога „изпратено прекомерно”.

Изпълненията са идемпотентни

Всеки запис носи ключ, извлечен от записа в източника. Ключът е хеш, така че не съдържа лични данни. Повторното изпълнение на синхронизация върху същите записи, след неуспех, пауза или ръчно, не създава дублирани записи.

Всичко се одитира

Публикуването на правило, обезсилените одобрения и автоматичните паузи се записват в Activity. Всяко решение за одобрение носи писмена обосновка. Всяко изпълнение се записва в историята на изпълненията на правилото. Одобрението, което е разрешило дадена публикация, е обвързано с отпечатък на точното правило, което е минало през прегледа. Редактирането на правилото го връща в чернова и обезсилва одобрението, така че това, което се изпълнява, винаги е това, което е било разрешено.

Неуспехите поставят правилото на пауза

Ако пет последователни изпълнения се провалят, автоматичен прекъсвач (circuit breaker) поставя правилото на пауза и показва последната грешка на страницата на правилото. Отстранете причината и публикувайте отново, за да продължите. Частично неуспешно изпълнение отчита броя на неуспешните си записи, за да видите точно какво не е пристигнало.

Как се зачитат отписванията

Когато контакт се отпише чрез линк в долния колонтитул на имейл от Brevo, това отписване се записва към контакта и Brevo го изключва от следващи кампании.
При партидната синхронизация на клиенти приложението на Tajo за Shopify сравнява момента на съгласието в Shopify с момента на отписването в Brevo и запазва по-късното.
Промяна в съгласието, която пристига от Shopify като webhook, се записва в Brevo така, както я отчита Shopify.
Ако контактът е бил абониран в Shopify, приложението на Tajo за Shopify го маркира като отписан и там. Събитие в Brevo премества клиента само от абониран към отписан. Никога не абонира никого, така че абониране в Brevo не променя нищо в Shopify.

Какви данни са налични

Приложението на Tajo за Shopify изпраща контакти, поръчки, събития за поръчки и колички, продуктовия каталог и наличностите. Какво изпраща едно правило за синхронизация зависи от неговото съпоставяне на полетата. За клиентите от Shopify шаблонът съпоставя полета за идентичност, обща изразходвана сума, брой поръчки, етикети и съгласието с атрибути на Brevo контакти, които можете да използвате в сегменти и кампании. Точното съпоставяне за Вашето работно пространство не е скрито в описание: отворете правилото за синхронизация и прочетете таблицата със съпоставянето на полетата. Тази таблица е меродавният отговор на въпроса „какво се синхронизира”.

Какво Tajo не прави днес

Точността относно границите е по-важна от дълъг списък с функции:

Няма правила за двупосочна синхронизация. Правилото за синхронизация записва само в Brevo. Собствените записи на приложението за Shopify в Shopify (оттегляния на съгласие, метаполета на Brevo за ангажираност и лоялност, етикети за ниво на лоялност) са изброени в обяснение на разрешенията на Shopify.
Няма правила за синхронизация в реално време. Правилата за синхронизация се изпълняват на партиди. Само синхронизацията чрез webhooks на приложението на Tajo за Shopify работи в момента на пристигане на събитията.
Няма бутон за връщане в наличност. Приложението поддържа наличността на продуктите в Brevo актуална и изпраща събитие back_in_stock на купувачите, които са поискали известие. Заявката трябва да идва от Вашия онлайн магазин: приложението не добавя бутон „Notify me“ към Вашата тема.

Ако някоя от тези граници блокира Ваш случай на употреба, кажете на екипа: приоритетите в ранния достъп се оформят точно от такава обратна връзка.

Къде да видите данните си

В Tajo: отворете правилото за синхронизация под Connections > Syncs and mappings за история на изпълненията, позиция на курсора и броячи по изпълнение. Activity записва публикациите и автоматичните паузи.
В Brevo: отворете Contacts и инспектирайте атрибутите на който и да е контакт, за да потвърдите, че съпоставените полета се попълват. Изграждайте сегменти върху тези атрибути за таргетиране.

Отстраняване на проблеми

Контактите не се появяват в Brevo: проверете последното изпълнение на правилото за неуспехи и статуса му (правило на пауза не се изпълнява). Вижте липсващи контакти в Brevo.
Изпълненията се провалят многократно: прекъсвачът ще постави правилото на пауза и ще покаже последната грешка. Вижте данните не се синхронизират.
Дублирани контакти: записите са идемпотентни за всеки запис от източника, но вече съществуващите дубликати в Brevo остават. Вижте дублирани контакти.

Често задавани въпроси

Мога ли да направя синхронизацията по-бърза? Страницата на активно правило има бутон Test run (1 batch). За промените в момента на настъпването им синхронизацията чрез webhooks на приложението на Tajo за Shopify вече покрива клиенти, поръчки, плащания, продукти и наличности.

Какво става, ако изпълнение се провали по средата? Изпълнението отчита броя на неуспешните записи, курсорът напредва само върху обработеното, а следващото изпълнение безопасно минава отново през същия участък: ключовете за идемпотентност предотвратяват дубликати.

Мога ли да променя какво се синхронизира? Да. Помолете агента да промени съпоставянето на полетата или филтъра на правилото. Редакцията връща правилото в чернова и то трябва отново да мине през преглед и одобрение, преди да се изпълни пак.

Защо правилото ми се постави само на пауза? Последователните неуспешни изпълнения задействат прекъсвача. Страницата на правилото показва броя на неуспехите и последната грешка; отстранете проблема и публикувайте отново.

Свързани статии

Получете помощ

Свържете се с екипа.