Pochopení synchronizace dat Shopify s Brevo

Tajo přesouvá data ze Shopify do Brevo dvěma způsoby. Aplikace Tajo pro Shopify zpracovává webhooky Shopify hned, jak dorazí. Pravidla synchronizace jsou schválená člověkem, jednosměrná, běží v dávkách a zaznamenávají se od začátku do konce. Tento článek vysvětluje obojí, co naopak nezahrnují a těch několik věcí, které aplikace Tajo pro Shopify zapisuje zpět do Shopify.

Rychlá kontrola Tento článek předpokládá, že jste už připojili Shopify a Brevo a publikovali alespoň jedno pravidlo synchronizace. Pokud ne, začněte u připojení Tajo k Shopify.

Když se události dějí: aplikace Tajo pro Shopify

Aplikace Tajo pro Shopify odebírá webhooky Shopify a každý zpracuje hned, jak dorazí. Změny zákazníků a produktů nejprve počkají asi čtyři sekundy. Takto se do Brevo dostávají zákazníci, objednávky, pokladny (checkouts), produkty, kolekce a úrovně skladových zásob, spolu s událostmi jako order_paid a cart_abandoned. Průvodce integrací Shopify uvádí každé téma a co zapisuje do Brevo.

Podoba pravidla synchronizace

Pravidlo synchronizace je zkontrolovaná a schválená definice toho, co přesně se přesouvá a jak. Sestaví ho agent podle Vašeho popisu a schválí ho člověk. Pravidlo má čtyři části, které si můžete prohlédnout na jeho stránce v Connections > Syncs and mappings:

Část	Co dělá
Mapování polí	Každé zdrojové pole, pole Brevo, do kterého zapisuje, a jakákoliv transformace mezi tím
Filtrovací výraz	Vyhodnocuje se pro každý záznam; záznamy, které neodpovídají, se přeskočí
Kurzor	Sleduje, kam synchronizace postoupila, takže každý běh navazuje tam, kde skončil ten poslední
Historie běhů	Každý běh s počtem přečtených, zapsaných a neúspěšných záznamů, dobou trvání a stavem

Pravidlo synchronizace přesouvá data jedním směrem: z Vašeho zdroje do Brevo. Nikdy nezapisuje do Shopify. Aplikace Tajo pro Shopify však několik věcí zpět do Shopify zapisuje, například odhlášení ze souhlasu a štítky věrnostní úrovně. Vysvětlení oprávnění Shopify uvádí každý zápis a kdy k němu dojde.

Kdy pravidlo synchronizace běží

Pravidla synchronizace běží v dávkách. Pravidla synchronizace kontaktů běží ve výchozím nastavení každých 15 minut. Aktivní, publikované pravidlo Shopify orders → Brevo orders také běží každých 15 minut, ale jen s filtrem marketingového souhlasu kupujícího ze šablony. Pravidlo s upraveným filtrem běží jen tehdy, když ho spustíte sami. První plánovaný běh pravidla pro objednávky začíná několik minut před tímto okamžikem a neodešle žádné starší objednávky. Každý další běh odešle objednávky aktualizované od předchozího běhu. Starší objednávky se do Brevo dostanou jen tehdy, když pravidlo spustíte sami. Stránka aktivního pravidla má tlačítko Test run (1 batch) a agent Sync Operator spustí aktivní pravidla, když ho o to požádáte. Dávkové běhy jsou to, co dělá každý zápis kontrolovatelným, rozpočtovaným a přiřaditelným ke konkrétnímu běhu.

Každý běh čte nové a změněné záznamy od místa kurzoru, aplikuje filtr, namapuje pole a zapíše do Brevo. Záznam běhu ukazuje přesně, kolik záznamů bylo přečteno, zapsáno a kolik jich selhalo.

Záruky řízení

Souhlas selhává uzavřeně

Pravidlo, které zapisuje osobní údaje do Brevo, nelze publikovat bez filtru souhlasu a potlačení. Za běhu je kontakt zapisovaný do marketingového publika bez prokazatelného souhlasu odmítnut. Když souhlas nelze prokázat, Tajo zápis odmítne, místo aby hádalo. Způsob selhání je vždy „příliš opatrný“, nikdy „odesláno příliš mnoho“.

Běhy jsou idempotentní

Každý zápis nese klíč odvozený ze zdrojového záznamu. Klíč je hash, takže neobsahuje žádné osobní údaje. Opakované spuštění synchronizace nad stejnými záznamy, ať už po selhání, po pozastavení nebo ručně, nevytváří duplicitní zápisy.

Vše se auditovuje

Publikace pravidla, zneplatněná schválení a automatická pozastavení se zaznamenávají v Activity. Každé rozhodnutí o schválení nese písemné zdůvodnění. Každý běh se zaznamenává v historii běhů pravidla. Schválení, které publikaci autorizovalo, je vázáno na otisk přesně toho pravidla, které prošlo náhledem. Úprava pravidla ho vrátí do konceptu a schválení zneplatní, takže běží vždy to, co bylo autorizováno.

Selhání pozastaví pravidlo

Pokud za sebou selže pět běhů, jistič (circuit breaker) pravidlo automaticky pozastaví a na stránce pravidla zobrazí poslední chybu. Opravte příčinu a poté znovu publikujte, aby se pokračovalo. Částečně neúspěšný běh hlásí svůj počet selhání, takže přesně vidíte, co se nedostalo do cíle.

Jak se respektují odhlášení

Když se kontakt odhlásí přes odkaz v patičce e-mailu Brevo, tento odhlašovací záznam se u kontaktu uloží a Brevo jej vyloučí z dalších kampaní.
Při dávkové synchronizaci zákazníků aplikace Tajo pro Shopify porovná čas souhlasu ve Shopify s časem odhlášení v Brevo a ponechá ten pozdější.
Změna souhlasu, která přijde ze Shopify jako webhook, se zapíše do Brevo tak, jak ji Shopify hlásí.
Pokud byl kontakt přihlášen k odběru ve Shopify, aplikace Tajo pro Shopify jej tam označí také jako odhlášeného. Událost v Brevo zákazníka vždy pouze přesune z přihlášeného na odhlášeného. Nikdy nikoho nepřihlásí k odběru, takže přihlášení v Brevo Shopify nezmění.

Jaká data jsou k dispozici

Aplikace Tajo pro Shopify odesílá kontakty, objednávky, události objednávek a košíků, katalog produktů a skladové zásoby. Co odesílá pravidlo synchronizace, závisí na jeho mapování polí. U zákazníků Shopify šablona mapuje identifikační pole, celkovou útratu, počet objednávek, štítky a souhlas (opt-in) na atributy kontaktu Brevo, které můžete použít v segmentech a kampaních. Přesné mapování pro Váš workspace není skryté v popisu: otevřete pravidlo synchronizace a přečtěte si tabulku mapování polí. Tato tabulka je autoritativní odpovědí na otázku „co se synchronizuje“.

Co Tajo dnes nedělá

Přesnost ohledně hranic je důležitější než dlouhý seznam funkcí:

Žádná pravidla obousměrné synchronizace. Pravidlo synchronizace zapisuje pouze do Brevo. Vlastní zápisy aplikace pro Shopify do Shopify (odhlášení ze souhlasu, metafields zapojení a věrnosti z Brevo, štítky věrnostní úrovně) jsou uvedeny ve Vysvětlení oprávnění Shopify.
Žádná pravidla synchronizace v reálném čase. Pravidla synchronizace běží v dávkách. Hned, jak události dorazí, funguje jen synchronizace webhooků v aplikaci Tajo pro Shopify.
Žádné tlačítko pro upozornění na naskladnění. Aplikace udržuje skladové zásoby produktů v Brevo aktuální a posílá událost back_in_stock zákazníkům, kteří požádali o upozornění. Žádost musí přijít z Vašeho obchodu: aplikace nepřidává do Vašeho motivu tlačítko „Notify me“.

Pokud Vám některá z těchto hranic blokuje případ užití, dejte to týmu vědět: priority rané fáze přístupu se řídí přesně takovou zpětnou vazbou.

Kde vidět svá data

V Tajo: otevřete pravidlo synchronizace v Connections > Syncs and mappings pro historii běhů, pozici kurzoru a počty za jednotlivé běhy. Activity zaznamenává publikace a automatická pozastavení.
V Brevo: otevřete Kontakty a prohlédněte si atributy libovolného kontaktu, abyste potvrdili, že se namapovaná pole plní. Na těchto atributech si postavte segmenty pro cílení.

Řešení problémů

Kontakty se v Brevo neobjevují: zkontrolujte poslední běh pravidla, zda neobsahuje selhání, a jeho stav (pozastavené pravidlo neběží). Podívejte se na chybějící kontakty v Brevo.
Běhy opakovaně selhávají: jistič pravidlo pozastaví a zobrazí poslední chybu. Podívejte se na data se nesynchronizují.
Duplicitní kontakty: zápisy jsou idempotentní podle zdrojového záznamu, ale již existující duplicity v Brevo zůstávají. Podívejte se na duplicitní kontakty.

Časté dotazy

Mohu synchronizaci zrychlit? Stránka aktivního pravidla má tlačítko Test run (1 batch). Pro změny v okamžiku, kdy nastanou, už synchronizace webhooků v aplikaci Tajo pro Shopify pokrývá zákazníky, objednávky, pokladny, produkty a skladové zásoby.

Co se stane, když běh selže v půlce? Běh nahlásí svůj počet selhání, kurzor postoupí jen o to, co bylo zpracováno, a další běh bezpečně dožene chybějící úsek: klíče idempotence brání duplicitám.

Mohu změnit, co se synchronizuje? Ano. Požádejte agenta, aby změnil mapování polí nebo filtr pravidla. Úprava vrátí pravidlo do konceptu a než znovu poběží, musí projít náhledem a schválením.

Proč se mé pravidlo samo pozastavilo? Po sobě jdoucí selhání běhů spustí jistič. Stránka pravidla zobrazuje počet selhání a poslední chybu; problém opravte a znovu publikujte.

Související články

Získejte pomoc

Kontaktujte tým.