Zrozumienie synchronizacji danych Shopify z Brevo

Tajo przenosi dane z Shopify do Brevo na dwa sposoby. Aplikacja Shopify Tajo przetwarza webhooki Shopify na bieżąco, w miarę ich napływu. Reguły synchronizacji są zatwierdzane przez ludzi, jednokierunkowe, uruchamiane w partiach i logowane od początku do końca. Ten artykuł wyjaśnia oba mechanizmy, czego nie obejmują i które nieliczne rzeczy aplikacja Shopify Tajo zapisuje z powrotem do Shopify.

Szybka kontrola Ten artykuł zakłada, że masz już połączone Shopify i Brevo oraz opublikowaną co najmniej jedną regułę synchronizacji. Jeśli nie, zacznij od łączenia Tajo z Shopify.

Na bieżąco: aplikacja Shopify Tajo

Aplikacja Shopify Tajo subskrybuje webhooki Shopify i przetwarza każdy z nich, gdy tylko nadejdzie. Zmiany klientów i produktów najpierw czekają około czterech sekund. W ten sposób do Brevo trafiają klienci, zamówienia, checkouty, produkty, kolekcje i stany magazynowe, a także zdarzenia takie jak order_paid i cart_abandoned. Przewodnik po integracji z Shopify wymienia każdy temat i to, co zapisuje w Brevo.

Kształt reguły synchronizacji

Reguła synchronizacji to przejrzana, zatwierdzona definicja tego, co dokładnie się przenosi i w jaki sposób. Agent buduje ją na podstawie Twojego opisu, a człowiek ją zatwierdza. Reguła ma cztery części, które możesz obejrzeć na jej stronie w Connections > Syncs and mappings:

Część	Co robi
Mapowanie pól	Każde pole źródłowe, pole Brevo, do którego zapisuje, i ewentualne transformacje po drodze
Wyrażenie filtrujące	Obliczane dla każdego rekordu; rekordy, które nie pasują, są pomijane
Kursor	Śledzi, dokąd doszła synchronizacja, dzięki czemu każdy przebieg zaczyna tam, gdzie skończył się poprzedni
Historia przebiegów	Każdy przebieg z liczbą rekordów odczytanych, zapisanych i nieudanych oraz czasem trwania i statusem

Reguła synchronizacji przenosi dane w jednym kierunku: ze źródła do Brevo. Nigdy nie zapisuje niczego w Shopify. Aplikacja Shopify Tajo zapisuje jednak z powrotem do Shopify kilka rzeczy, takich jak wypisy ze zgód i tagi poziomu lojalności. Wyjaśnienie uprawnień Shopify wymienia każdy zapis i moment, w którym następuje.

Kiedy działa reguła synchronizacji

Reguły synchronizacji działają w partiach. Reguły synchronizacji kontaktów działają domyślnie co 15 minut. Aktywna, opublikowana reguła Shopify orders → Brevo orders również działa co 15 minut, ale tylko z filtrem zgody kupującego na marketing (opt-in) z szablonu. Reguła z edytowanym filtrem działa tylko wtedy, gdy uruchomisz ją samodzielnie. Pierwsze zaplanowane uruchomienie reguły zamówień zaczyna się kilka minut przed tym momentem i nie wysyła starszych zamówień. Każde kolejne uruchomienie wysyła zamówienia zaktualizowane od poprzedniego. Wcześniejsze zamówienia trafiają do Brevo tylko wtedy, gdy uruchomisz regułę samodzielnie. Strona aktywnej reguły ma przycisk Test run (1 batch), a agent Sync Operator uruchamia aktywne reguły, gdy go o to poprosisz. Właśnie dzięki przebiegom w partiach każdy zapis można przejrzeć, zbudżetować i przypisać do konkretnego przebiegu.

Każdy przebieg odczytuje rekordy nowe i zmienione od pozycji kursora, stosuje filtr, mapuje pola i zapisuje do Brevo. Zapis przebiegu pokazuje dokładnie, ile rekordów odczytano, zapisano i ile się nie powiodło.

Gwarancje nadzoru

Zgoda działa w trybie fail closed

Reguły, która zapisuje dane osobowe w Brevo, nie można opublikować bez filtra zgód i wykluczeń (suppression). W czasie przebiegu zapis kontaktu do odbiorców marketingowych bez możliwej do udowodnienia zgody zostaje odrzucony. Gdy zgody nie da się ustalić, Tajo odmawia zapisu, zamiast zgadywać. Tryb awarii to zawsze „zbyt ostrożnie”, nigdy „wysłano za dużo”.

Przebiegi są idempotentne

Każdy zapis niesie klucz wyprowadzony z rekordu źródłowego. Klucz jest skrótem (hashem), więc nie zawiera danych osobowych. Ponowne uruchomienie synchronizacji na tych samych rekordach, po awarii, po pauzie lub ręcznie, nie tworzy zduplikowanych zapisów.

Wszystko jest audytowane

Publikacja reguły, unieważnione zatwierdzenia i automatyczne wstrzymania są rejestrowane w Activity. Każda decyzja o zatwierdzeniu zawiera pisemne uzasadnienie. Każdy przebieg jest zapisywany w historii przebiegów reguły. Zatwierdzenie, które autoryzowało publikację, jest związane ze skrótem dokładnie tej reguły, którą objął podgląd. Edycja reguły przywraca ją do stanu szkicu i unieważnia zatwierdzenie, więc działa zawsze to, co zostało autoryzowane.

Awarie wstrzymują regułę

Jeśli pięć kolejnych przebiegów się nie powiedzie, bezpiecznik (circuit breaker) automatycznie wstrzymuje regułę i pokazuje ostatni błąd na jej stronie. Usuń przyczynę, a następnie opublikuj ponownie, aby wznowić. Częściowo nieudany przebieg raportuje liczbę nieudanych rekordów, więc dokładnie widzisz, co nie dotarło.

Jak respektowane są wypisy z subskrypcji

Gdy kontakt wypisze się przez link w stopce e-maila Brevo, ta rezygnacja jest zapisywana przy kontakcie, a Brevo wyklucza go z dalszych kampanii.
W zbiorczej synchronizacji klientów aplikacja Shopify Tajo porównuje czas zgody w Shopify z czasem wypisania w Brevo i zachowuje późniejsze z nich.
Zmiana zgody, która przychodzi z Shopify jako webhook, jest zapisywana w Brevo tak, jak raportuje ją Shopify.
Jeśli kontakt był zapisany w Shopify, aplikacja Shopify Tajo oznacza go tam również jako wypisanego. Zdarzenie Brevo zmienia klienta wyłącznie z zapisanego na wypisanego. Nigdy nikogo nie zapisuje, więc zapis w Brevo nie zmienia niczego w Shopify.

Jakie dane są dostępne

Aplikacja Shopify Tajo wysyła kontakty, zamówienia, zdarzenia zamówień i koszyków, katalog produktów oraz stany magazynowe. To, co wysyła reguła synchronizacji, zależy od jej mapowania pól. Dla klientów Shopify szablon mapuje pola tożsamości, łączne wydatki, liczbę zamówień, tagi i zgodę (opt-in) na atrybuty kontaktów Brevo, których możesz używać w segmentach i kampaniach. Dokładne mapowanie dla Twojego workspace’u nie jest ukryte w opisie: otwórz regułę synchronizacji i przeczytaj tabelę mapowania pól. Ta tabela jest wiążącą odpowiedzią na pytanie „co się synchronizuje”.

Czego Tajo dziś nie robi

Precyzja co do granic znaczy więcej niż długa lista funkcji:

Brak reguł synchronizacji dwukierunkowej. Reguła synchronizacji zapisuje tylko do Brevo. Własne zapisy aplikacji Shopify w Shopify (wypisy ze zgód, metapola zaangażowania i lojalności Brevo, tagi poziomu lojalności) są wymienione w wyjaśnieniu uprawnień Shopify.
Brak reguł synchronizacji w czasie rzeczywistym. Reguły synchronizacji działają w partiach. Tylko synchronizacja webhooków przez aplikację Shopify Tajo działa na bieżąco, w miarę napływu zdarzeń.
Brak przycisku powiadomienia o dostępności. Aplikacja utrzymuje aktualne stany magazynowe produktów w Brevo i wysyła zdarzenie back_in_stock do kupujących, którzy poprosili o powiadomienie. Prośba musi pochodzić z Twojego sklepu: aplikacja nie dodaje przycisku „Powiadom mnie” do Twojego motywu.

Jeśli któraś z tych granic blokuje Twój przypadek użycia, powiedz o tym zespołowi; priorytety wczesnego dostępu kształtuje dokładnie taki feedback.

Gdzie zobaczyć swoje dane

W Tajo: otwórz regułę synchronizacji w Connections > Syncs and mappings, aby zobaczyć historię przebiegów, pozycję kursora i liczniki poszczególnych przebiegów. Activity rejestruje publikacje i automatyczne wstrzymania.
W Brevo: otwórz Kontakty i sprawdź atrybuty dowolnego kontaktu, aby potwierdzić, że zmapowane pola się wypełniają. Buduj na tych atrybutach segmenty do targetowania.

Rozwiązywanie problemów

Kontakty nie pojawiają się w Brevo: sprawdź ostatni przebieg reguły pod kątem błędów oraz jej status (wstrzymana reguła nie działa). Zobacz brakujące kontakty w Brevo.
Przebiegi wielokrotnie się nie udają: bezpiecznik wstrzyma regułę i pokaże ostatni błąd. Zobacz dane się nie synchronizują.
Zduplikowane kontakty: zapisy są idempotentne względem rekordu źródłowego, ale wcześniejsze duplikaty w Brevo pozostają. Zobacz zduplikowane kontakty.

Częste pytania

Czy mogę przyspieszyć synchronizację? Strona aktywnej reguły ma przycisk Test run (1 batch). Jeśli chodzi o zmiany na bieżąco, synchronizacja webhooków przez aplikację Shopify Tajo już obejmuje klientów, zamówienia, checkouty, produkty i stany magazynowe.

Co się stanie, jeśli przebieg zawiedzie w połowie? Przebieg raportuje liczbę nieudanych rekordów, kursor przesuwa się tylko po tym, co przetworzono, a następny przebieg bezpiecznie pokrywa ten obszar ponownie; klucze idempotencji zapobiegają duplikatom.

Czy mogę zmienić, co się synchronizuje? Tak. Poproś agenta o zmianę mapowania pól lub filtra reguły. Edycja przywraca regułę do stanu szkicu, a reguła musi ponownie przejść przez podgląd i zatwierdzenie, zanim znów zostanie uruchomiona.

Dlaczego moja reguła sama się wstrzymała? Kolejne nieudane przebiegi uruchamiają bezpiecznik. Strona reguły pokazuje liczbę awarii i ostatni błąd; usuń problem i opublikuj ponownie.

Powiązane artykuły

Uzyskaj pomoc

Skontaktuj się z zespołem.