Ako funguje synchronizácia dát zo Shopify do Brevo

Tajo presúva dáta zo Shopify do Brevo dvoma spôsobmi. Aplikácia Tajo pre Shopify spracúva webhooky Shopify hneď, ako prídu. Synchronizačné pravidlá sú schválené človekom, jednosmerné, bežia v dávkach a zaznamenávajú sa od začiatku do konca. Tento článok vysvetľuje oboje, čo nezahŕňajú a tých niekoľko vecí, ktoré aplikácia Tajo pre Shopify zapisuje späť do Shopify.

Rýchla kontrola Tento článok predpokladá, že máte pripojené Shopify a Brevo a publikované aspoň jedno synchronizačné pravidlo. Ak nie, začnite článkom pripojenie Tajo k Shopify.

Keď sa udalosti dejú: aplikácia Tajo pre Shopify

Aplikácia Tajo pre Shopify odoberá webhooky Shopify a každý spracuje hneď, ako príde. Zmeny zákazníkov a produktov najprv čakajú približne štyri sekundy. Takto sa do Brevo dostávajú zákazníci, objednávky, objednávky v pokladni (checkouts), produkty, kolekcie a skladové zásoby spolu s udalosťami ako order_paid a cart_abandoned. Príručka integrácie so Shopify uvádza každú tému a čo zapisuje do Brevo.

Podoba synchronizačného pravidla

Synchronizačné pravidlo je skontrolovaná, schválená definícia toho, čo presne sa presúva a ako. Zostaví ho agent podľa Vášho opisu a schváli ho človek. Pravidlo má štyri časti, ktoré si môžete prezrieť na jeho stránke v sekcii Connections > Syncs and mappings:

Časť	Čo robí
Mapovanie polí	Každé zdrojové pole, pole Brevo, do ktorého zapisuje, a prípadná transformácia medzi nimi
Filtrovací výraz	Vyhodnocuje sa pre každý záznam; záznamy, ktoré mu nevyhovujú, sa preskočia
Kurzor	Sleduje, kam synchronizácia pokročila, takže každý beh nadväzuje tam, kde predchádzajúci skončil
História behov	Každý beh s počtom prečítaných, zapísaných a neúspešných záznamov, trvaním a stavom

Synchronizačné pravidlo presúva dáta jedným smerom: z Vášho zdroja do Brevo. Nikdy nezapisuje do Shopify. Aplikácia Tajo pre Shopify však niekoľko vecí späť do Shopify zapisuje, napríklad odhlásenia zo súhlasu a značky vernostnej úrovne. Vysvetlenie povolení Shopify uvádza každý zápis a kedy k nemu dôjde.

Kedy sa synchronizačné pravidlo spúšťa

Synchronizačné pravidlá bežia v dávkach. Pravidlá synchronizácie kontaktov sa predvolene spúšťajú každých 15 minút. Aktívne publikované pravidlo Shopify orders → Brevo orders sa tiež spúšťa každých 15 minút, ale len s filtrom súhlasu kupujúceho s marketingom zo šablóny. Pravidlo s upraveným filtrom beží len vtedy, keď ho sami spustíte. Prvý plánovaný beh pravidla pre objednávky začína niekoľko minút pred týmto okamihom a neodosiela staršie objednávky. Každý ďalší beh odošle objednávky aktualizované od predchádzajúceho behu. Minulé objednávky sa do Brevo dostanú len vtedy, keď pravidlo spustíte sami. Stránka aktívneho pravidla má tlačidlo Test run (1 batch) a agent Sync Operator spúšťa aktívne pravidlá, keď ho o to požiadate. Práve dávkové behy umožňujú, aby bol každý zápis skontrolovateľný, rozpočtovaný a priraditeľný ku konkrétnemu behu.

Každý beh prečíta nové a zmenené záznamy od kurzora, aplikuje filter, namapuje polia a zapíše do Brevo. Záznam o behu presne ukazuje, koľko záznamov bolo prečítaných, zapísaných a neúspešných.

Záruky riadenia

Súhlas zlyháva bezpečne (fail closed)

Pravidlo, ktoré zapisuje osobné údaje do Brevo, sa nedá publikovať bez filtra súhlasu a potlačenia. Počas behu sa zápis kontaktu do marketingového publika bez preukázateľného súhlasu odmietne. Keď sa súhlas nedá preukázať, Tajo zápis odmietne, namiesto toho, aby hádalo. Režim zlyhania je vždy „príliš opatrné“, nikdy „poslané priveľa“.

Behy sú idempotentné

Každý zápis nesie kľúč odvodený zo zdrojového záznamu. Kľúč je hash, takže neobsahuje žiadne osobné údaje. Opätovné spustenie synchronizácie nad tými istými záznamami, či už po zlyhaní, po pozastavení alebo ručne, nevytvára duplicitné zápisy.

Všetko sa audituje

Publikovanie pravidla, zneplatnené schválenia a automatické pozastavenia sa zaznamenávajú v sekcii Activity. Každé schvaľovacie rozhodnutie nesie písomné zdôvodnenie. Každý beh sa zaznamenáva v histórii behov pravidla. Schválenie, ktoré autorizovalo publikovanie, je viazané na digest presne toho pravidla, ktoré prešlo náhľadom. Úprava pravidla ho vráti do konceptu a schválenie zneplatní, takže beží vždy to, čo bolo autorizované.

Zlyhania pozastavia pravidlo

Ak päť behov po sebe zlyhá, poistka (circuit breaker) pravidlo automaticky pozastaví a na stránke pravidla zobrazí poslednú chybu. Odstráňte príčinu a potom pravidlo znova publikujte, aby pokračovalo. Čiastočne neúspešný beh hlási počet neúspešných záznamov, takže presne vidíte, čo sa nezapísalo.

Ako sa rešpektujú odhlásenia z odberu

Keď sa kontakt odhlási cez odkaz v pätičke e-mailu Brevo, toto odhlásenie sa zaznamená pri kontakte a Brevo ho vylúči z ďalších kampaní.
Pri dávkovej synchronizácii zákazníkov aplikácia Tajo pre Shopify porovná čas súhlasu v Shopify s časom odhlásenia v Brevo a ponechá neskorší z nich.
Zmena súhlasu, ktorá príde zo Shopify ako webhook, sa zapíše do Brevo tak, ako ju Shopify nahlási.
Ak bol kontakt prihlásený na odber v Shopify, aplikácia Tajo pre Shopify ho tam označí tiež ako odhláseného. Udalosť v Brevo zákazníka vždy iba presunie z prihláseného na odhláseného. Nikdy nikoho neprihlási na odber, takže prihlásenie v Brevo Shopify nezmení.

Aké dáta sú dostupné

Aplikácia Tajo pre Shopify posiela kontakty, objednávky, udalosti objednávok a košíka, katalóg produktov a skladové zásoby. Čo posiela synchronizačné pravidlo, závisí od jeho mapovania polí. Pre zákazníkov Shopify šablóna mapuje identifikačné polia, celkové výdavky, počet objednávok, štítky a súhlas (opt-in) do atribútov kontaktov Brevo, ktoré môžete použiť v segmentoch a kampaniach. Presné mapovanie pre Váš pracovný priestor nie je skryté v žiadnom popise: otvorte synchronizačné pravidlo a prečítajte si tabuľku mapovania polí. Tá tabuľka je záväzná odpoveď na otázku „čo sa synchronizuje“.

Čo Tajo dnes nerobí

Presnosť pri hraniciach je dôležitejšia než dlhý zoznam funkcií:

Žiadne pravidlá obojsmernej synchronizácie. Synchronizačné pravidlo zapisuje iba do Brevo. Vlastné zápisy aplikácie pre Shopify do Shopify (odhlásenia zo súhlasu, metafields zapojenia a vernosti z Brevo, značky vernostnej úrovne) sú uvedené vo Vysvetlení povolení Shopify.
Žiadne synchronizačné pravidlá v reálnom čase. Synchronizačné pravidlá bežia v dávkach. Ako udalosti prichádzajú, funguje len synchronizácia aplikácie Tajo pre Shopify cez webhooky.
Žiadne tlačidlo „opäť na sklade“. Aplikácia udržiava skladové zásoby produktov v Brevo aktuálne a posiela udalosť back_in_stock nakupujúcim, ktorí požiadali o upozornenie. Žiadosť musí prísť z Vášho obchodu: aplikácia nepridáva do Vašej témy tlačidlo „Upozorniť ma“.

Ak Vám niektorá z týchto hraníc blokuje konkrétny scenár, povedzte to tímu: priority skorého prístupu formuje presne takáto spätná väzba.

Kde vidíte svoje dáta

V Tajo: otvorte synchronizačné pravidlo v sekcii Connections > Syncs and mappings pre históriu behov, pozíciu kurzora a počty za jednotlivé behy. Activity zaznamenáva publikovania a automatické pozastavenia.
V Brevo: otvorte Kontakty a prezrite si atribúty ľubovoľného kontaktu, aby ste overili, že sa namapované polia napĺňajú. Na týchto atribútoch stavajte segmenty na cielenie.

Riešenie problémov

Kontakty sa nezobrazujú v Brevo: skontrolujte posledný beh pravidla, či neobsahuje zlyhania, a jeho stav (pozastavené pravidlo nebeží). Pozrite si chýbajúce kontakty v Brevo.
Behy opakovane zlyhávajú: poistka (circuit breaker) pravidlo pozastaví a zobrazí poslednú chybu. Pozrite si dáta sa nesynchronizujú.
Duplicitné kontakty: zápisy sú idempotentné pre každý zdrojový záznam, ale duplicity, ktoré už v Brevo existovali, zostávajú. Pozrite si duplicitné kontakty.

Časté otázky

Môžem synchronizáciu zrýchliť? Stránka aktívneho pravidla má tlačidlo Test run (1 batch). Pre zmeny hneď, ako nastanú, už synchronizácia aplikácie Tajo pre Shopify cez webhooky pokrýva zákazníkov, objednávky, objednávky v pokladni, produkty a skladové zásoby.

Čo sa stane, ak beh zlyhá v polovici? Beh nahlási počet neúspešných záznamov, kurzor sa posunie len cez to, čo bolo spracované, a nasledujúci beh bezpečne prejde zvyšok znova: idempotentné kľúče bránia duplicitám.

Môžem zmeniť, čo sa synchronizuje? Áno. Požiadajte agenta, aby zmenil mapovanie polí alebo filter pravidla. Úprava vráti pravidlo do konceptu a pred ďalším behom musí znova prejsť náhľadom a schválením.

Prečo sa moje pravidlo samo pozastavilo? Opakované zlyhania behov po sebe aktivujú poistku (circuit breaker). Stránka pravidla ukazuje počet zlyhaní a poslednú chybu; odstráňte problém a pravidlo znova publikujte.

Súvisiace články

Získajte pomoc

Kontaktujte tím.