A Tajo kétféleképpen juttatja el a Shopify-adatokat a Brevóba. A Tajo Shopify-alkalmazás a beérkezésükkor feldolgozza a Shopify webhookokat. A szinkronizálási szabályokat ember hagyja jóvá, egyirányúak, kötegekben futnak, és az elejétől a végéig naplózva vannak. Ez a cikk mindkettőt elmagyarázza, azt is, mit nem tartalmaznak, valamint azt a néhány dolgot, amit a Tajo Shopify-alkalmazás visszaír a Shopify-ba.
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.
Az események idején: a Tajo Shopify-alkalmazás
A Tajo Shopify-alkalmazás feliratkozik a Shopify webhookokra, és mindegyiket a beérkezésekor feldolgozza. A vásárlói és termékváltozások előtte körülbelül négy másodpercet várnak. Így jutnak el a Brevóba a vásárlók, a rendelések, a pénztárak (checkouts), a termékek, a kollekciók és a készletszintek, valamint az olyan események, mint az order_paid és a cart_abandoned. A Shopify integrációs útmutató felsorol minden témát, és azt is, hogy mit ír a Brevóba.
Hogyan épül fel egy szinkronizálási szabály
A szinkronizálási szabály átnézett, jóváhagyott definíciója annak, hogy pontosan mi mozog és hogyan. Egy ügynök építi fel a leírásod alapján, és egy ember hagyja jóvá. Egy szabálynak négy része van, amelyeket a szabály oldalán, a Connections > Syncs and mappings 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 |
A szinkronizálási szabály egy irányban mozgatja az adatokat: a forrásodból a Brevóba. Soha nem ír a Shopify-ba. A Tajo Shopify-alkalmazás viszont visszaír néhány dolgot a Shopify-ba, például hozzájárulás-visszavonásokat és hűségszint-címkéket. A Shopify engedélyek magyarázata felsorol minden írást, és megmondja, mikor történik.
Mikor fut egy szinkronizálási szabály
A szinkronizálási szabályok kötegekben futnak. A kontaktszinkronizálási szabályok alapértelmezés szerint 15 percenként futnak. Egy aktív, közzétett Shopify orders → Brevo orders szabály szintén 15 percenként fut, de csak a sablon vásárlói marketing-hozzájárulási szűrőjével. Az a szabály, amelynek a szűrőjét módosították, csak akkor fut, amikor te elindítod. Egy rendelésszabály első ütemezett futása néhány perccel e pillanat előtt indul, és nem küld régebbi rendeléseket. Minden további futás az előző futás óta frissült rendeléseket küldi. Korábbi rendelések csak akkor kerülnek a Brevóba, ha te magad futtatod a szabályt. Egy aktív szabály oldalán van egy Test run (1 batch) gomb, a Sync Operator ügynök pedig akkor futtatja az aktív szabályokat, amikor megkéred rá. A kötegelt futások teszik minden írást átnézhetővé, költségkeretben tarthatóvá és 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)
Személyes adatokat a Brevóba író szabály nem tehető közzé a hozzájárulási és letiltási (suppression) szűrő nélkül. Futáskor a rendszer elutasítja azt a kontaktot, amely bizonyítható hozzájárulás nélkül kerülne marketingközönségbe. 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 kulcsot visel. A kulcs egy hash, így nem tartalmaz személyes adatot. Egy szinkronizálás újrafuttatása ugyanazokon a rekordokon, akár hiba vagy szünet után, akár kézzel, nem hoz létre duplikált írásokat.
Minden auditált
Egy szabály közzététele, az érvénytelenített jóváhagyások és az automatikus szüneteltetések az Activity alatt rögzülnek. Minden jóváhagyási döntéshez írásos indoklás tartozik. Minden futás bekerül a szabály futtatási előzményeibe. A közzétételt engedélyező jóváhagyás annak a pontos szabálynak a kivonatához (digest) kötődik, amelyen az előnézet lefutott. A szabály szerkesztése visszaállítja azt piszkozattá, és érvényteleníti a jóváhagyást, így mindig az fut, amit engedélyeztek.
A hibák szüneteltetik a szabályt
Ha öt 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
- 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 kötegelt vásárlószinkronizálásban a Tajo Shopify-alkalmazás összeveti a Shopify-hozzájárulás időpontját a Brevo-leiratkozás időpontjával, és a későbbit tartja meg.
- A Shopify-ból webhookként érkező hozzájárulás-változás úgy kerül a Brevóba, ahogy a Shopify jelenti.
- Ha a kapcsolat a Shopify-ban fel volt iratkozva, a Tajo Shopify-alkalmazás a Shopify-ban is leiratkozottnak jelöli. Egy Brevo-esemény a vásárlót csak feliratkozottból leiratkozottba helyezi át. Soha nem iratkoztat fel senkit, ezért a Brevóban történő feliratkozás nem változtat a Shopify-on.
Milyen adatok érhetők el
A Tajo Shopify-alkalmazás kontaktokat, rendeléseket, rendelési és kosáreseményeket, a termékkatalógust és a készletet küldi. Hogy egy szinkronizálási szabály mit küld, az a mezőleképezésétől függ. A Shopify-vásárlók esetében a sablon az azonosító mezőket, az összes költést, a rendelésszámot, a címkéket és a feliratkozási hozzájárulást (opt-in) képezi le Brevo kontaktattribútumokba, 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:
- Nincsenek kétirányú szinkronizálási szabályok. A szinkronizálási szabály csak a Brevóba ír. A Shopify-alkalmazás saját írásai a Shopify-ba (hozzájárulás-visszavonások, Brevo elköteleződési és hűség-metafieldek, hűségszint-címkék) a Shopify engedélyek magyarázata oldalon vannak felsorolva.
- Nincsenek valós idejű szinkronizálási szabályok. A szinkronizálási szabályok kötegekben futnak. Csak a Tajo Shopify-alkalmazás webhookalapú szinkronizálása működik az események beérkezésekor.
- Nincs „újra készleten” gomb. Az alkalmazás naprakészen tartja a termékkészletet a Brevóban, és
back_in_stockeseményt küld azoknak a vásárlóknak, akik értesítést kértek. A kérésnek a webáruházadból kell érkeznie: az alkalmazás nem ad „Notify me” gombot a témádhoz.
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 Connections > Syncs and mappings alatt a futtatási előzményekért, a kurzor pozíciójáért és a futásonkénti darabszámokért. Az Activity rögzíti a közzétételeket és az automatikus szüneteltetéseket.
- 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? Egy aktív szabály oldalán van egy Test run (1 batch) gomb. A változások azonnali követésére a Tajo Shopify-alkalmazás webhookalapú szinkronizálása már lefedi a vásárlókat, a rendeléseket, a pénztárakat, a termékeket és a készletet.
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. Kérd meg az ügynököt, hogy módosítsa a szabály mezőleképezését vagy szűrőjét. A szerkesztés visszaállítja a szabályt piszkozattá, és újra át kell mennie az előnézeten és a jóváhagyáson, mielőtt ismét fut.
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