A Tajo felügyelt szinkronizálási szabályokon keresztül mozgat adatokat a forrásrendszeredből a Brevóba: ember által jóváhagyott, egyirányú, ütemezetten futó és az elejétől a végéig naplózott módon. Ez a cikk elmagyarázza, mit jelent ez a gyakorlatban, és mit nem tartalmaz.
Gyors ellenőrzés Ez a cikk feltételezi, hogy már összekötötted a Shopify-t és a Brevót, és közzétettél legalább egy szinkronizálási szabályt. Ha még nem, kezdd a Tajo csatlakoztatása a Shopify-hoz cikkel.
Hogyan épül fel egy szinkronizálás
A Tajóban minden szinkronizálás egy szinkronizálási szabály: átnézett, jóváhagyott definíciója annak, hogy pontosan mi mozog és hogyan. Egy szabálynak négy része van, amelyeket a szabály oldalán, a Csatlakozók > Szinkronizálások alatt vizsgálhatsz meg:
| Rész | Mit csinál |
|---|---|
| Mezőleképezés | Minden forrásmező, a Brevo mező, ahová ír, és a köztes átalakítás |
| Szűrőkifejezés | Rekordonként értékelődik ki; a nem illeszkedő rekordok kimaradnak |
| Kurzor | Nyomon követi, meddig jutott a szinkronizálás, így minden futás ott folytatja, ahol az előző megállt |
| Futtatási előzmények | Minden futás a beolvasott, kiírt és sikertelen rekordok számával, valamint az időtartammal és állapottal |
Az adatok egy irányban áramlanak: a forrásodból a Brevóba. A Tajo nem ír vissza adatot a Shopify-ba.
Mikor szinkronizálódnak az adatok
A szinkronizálási futások ütemezett kötegekben történnek, vagy igény szerint, amikor a szabály oldaláról futást indítasz. A Tajo nem valós idejű adatcsatorna: egy Shopify-beli változás a következő futáskor ér el a Brevóba, nem másodperceken belül. Ez szándékos: a kötegelt futások teszik minden írást átnézhetővé, költségkeretben tarthatóvá és az auditnaplóban egy konkrét futáshoz köthetővé.
Minden futás beolvassa a kurzor óta új és módosult rekordokat, alkalmazza a szűrőt, leképezi a mezőket, és ír a Brevóba. A futás bejegyzése pontosan megmutatja, hány rekord lett beolvasva, kiírva, és hány volt sikertelen.
A felügyeleti garanciák
A hozzájárulás hiánya blokkol (fail-closed)
Szinkronizálási szabály nem tehető közzé hozzájárulási szabályzat nélkül, futáskor pedig a bizonyítható hozzájárulás nélküli rekord nem kerül kiírásra. Ha a hozzájárulás nem állapítható meg, a Tajo megtagadja az írást, nem találgat. A hibamód mindig a „túl óvatos”, sosem a „túl sokat küldött”.
A futások idempotensek
Minden írás a forrásrekordból származtatott eredetkulcsot (provenance key) visel, amely úgy készül, hogy ne tartalmazzon személyes adatot, így egy szinkronizálás újrafuttatása, akár hiba vagy szünet után, akár kézzel, nem hoz létre duplikált írásokat. Egy szabályt mindig biztonságos újra futtatni.
Minden auditált
Egy szabály közzététele, minden jóváhagyási döntés (az írásos indoklásával együtt) és minden futás rögzül az auditnaplóban. A közzétételt engedélyező jóváhagyás pontosan ahhoz a szabályverzióhoz kötődik, amelyet átnéztek; a szabály szerkesztése érvényteleníti a jóváhagyást, így az auditnapló mindig azt tükrözi, amit ténylegesen engedélyeztek.
A hibák szüneteltetik a szabályt
Ha több egymást követő futás sikertelen, egy megszakító (circuit breaker) automatikusan szünetelteti a szabályt, és a szabály oldalán megjeleníti az utolsó hibát. Javítsd ki az okot, majd tedd közzé újra a folytatáshoz. A részben sikertelen futás jelenti a sikertelen darabszámát, így pontosan látod, mi nem érkezett meg.
Hogyan érvényesülnek a leiratkozások
A Tajo az e-mail-hozzájárulás kérdésében a Brevót tekinti az igazság forrásának:
- Amikor egy kontakt egy Brevo e-mail láblécében található linken leiratkozik, ez a leiratkozás a kontakthoz rögzül, és a Brevo kizárja őt a további kampányokból.
- A Brevóban tiltólistára tett kontaktok kizárva maradnak: a későbbi küldések nem élesztik újra őket.
- A Tajo nem tolja vissza a leiratkozási állapotot a Shopify-ba. Ha a Shopify-ban is gyűjtesz e-mail-hozzájárulást, kezeld ott, külön; ne feltételezd, hogy a két rendszer tükrözi egymást.
Milyen adatok érhetők el
Az, hogy mi szinkronizálódik, a forrásodhoz elérhető sablonoktól függ. A Shopify esetében a tipikus forma a vásárlói rekord: azonosító mezők és rendelésekből származtatott attribútumok, például az összes költés és a rendelésszám, Brevo kontaktattribútumokba leképezve, amelyeket szegmensekben és kampányokban használhatsz. A munkaterületedre vonatkozó pontos leképezés nincs elrejtve egy leírásban: nyisd meg a szinkronizálási szabályt, és olvasd el a mezőleképezési táblázatot. Az a táblázat a mérvadó válasz arra a kérdésre, hogy „mi szinkronizálódik”.
Amit a Tajo ma nem csinál
A határok pontos kijelölése többet ér, mint egy hosszú funkciólista:
- Nincs kétirányú szinkronizálás. Semmi nem íródik vissza a Shopify-ba: sem leiratkozások, sem címkék, sem elköteleződési pontszámok.
- Nincs valós idejű szinkronizálás. A futások ütemezett vagy kézzel indított kötegek, nem perc alatti streamelés.
- Nincs készletkövetés. A termékek raktárkészletét a rendszer nem figyeli, és nincsenek „újra készleten” triggerek.
Ha ezek közül valamelyik határ blokkol nálad egy felhasználási esetet, jelezd a csapatnak: a korai hozzáférés prioritásait pontosan az ilyen visszajelzések alakítják.
Hol látod az adataidat
- A Tajóban: nyisd meg a szinkronizálási szabályt a Csatlakozók > Szinkronizálások alatt a futtatási előzményekért, a kurzor pozíciójáért és a futásonkénti darabszámokért. Az auditnapló rögzíti a közzétételeket és a jóváhagyásokat.
- A Brevóban: nyisd meg a Kontaktok oldalt, és nézd meg bármely kontakt attribútumait, hogy a leképezett mezők töltődnek-e. Építs szegmenseket ezekre az attribútumokra a célzáshoz.
Hibaelhárítás
- Nem jelennek meg kontaktok a Brevóban: nézd meg a szabály legutóbbi futásában a hibákat és a szabály állapotát (a szüneteltetett szabály nem fut). Lásd: hiányzó kontaktok a Brevóban.
- Sorozatosan sikertelen futások: a megszakító szünetelteti a szabályt, és megmutatja az utolsó hibát. Lásd: nem szinkronizálódnak az adatok.
- Duplikált kontaktok: az írások forrásrekordonként idempotensek, de a Brevóban már korábban meglévő duplikátumok megmaradnak. Lásd: duplikált kontaktok.
Gyakori kérdések
Gyorsíthatom a szinkronizálást? A szinkronizálási szabály oldaláról bármikor indíthatsz igény szerinti futást. Valós idejű mód nincs.
Mi történik, ha egy futás félúton meghibásodik? A futás jelenti a sikertelen darabszámát, a kurzor csak a feldolgozott részen halad tovább, és a következő futás biztonságosan újra lefedi a területet; az idempotenciakulcsok megakadályozzák a duplikátumokat.
Módosíthatom, hogy mi szinkronizálódik? Igen: szerkeszd a szabály mezőleképezését vagy szűrőjét. A szerkesztés új verziót hoz létre, amelynek újra át kell mennie a közzétételi jóváhagyáson, mielőtt életbe lép.
Miért szüneteltette magát a szabályom? Az egymást követő futáshibák kioldják a megszakítót. A szabály oldala mutatja a hibák számát és az utolsó hibát; javítsd ki a problémát, és tedd közzé újra.
Kapcsolódó cikkek
- Tajo csatlakoztatása a Shopify-hoz
- Szegmentálási alapok
- Hibaelhárítás: nem szinkronizálódnak az adatok
- Hibaelhárítás: hiányzó kontaktok a Brevóban
Segítségkérés
- Élő chat: elérhető a Tajo irányítópultján (jobb alsó sarok)
- E-mail támogatás: [email protected]
- Dokumentáció: docs.tajo.io