Înțelege sincronizarea datelor Shopify cu Brevo

Tajo mută datele din Shopify în Brevo pe două căi. Aplicația Tajo Shopify procesează webhook-urile Shopify pe măsură ce sosesc. Regulile de sincronizare sunt aprobate de un om, unidirecționale, rulate în loturi și înregistrate de la un capăt la altul. Acest articol le explică pe amândouă, ce nu includ și puținele lucruri pe care aplicația Tajo Shopify le scrie înapoi în Shopify.

Verificare rapidă Acest articol presupune că ai conectat Shopify și Brevo și ai publicat cel puțin o regulă de sincronizare. Dacă nu, începe cu connecting Tajo to Shopify.

Pe măsură ce au loc evenimentele: aplicația Tajo Shopify

Aplicația Tajo Shopify se abonează la webhook-urile Shopify și îl procesează pe fiecare pe măsură ce sosește. Modificările de clienți și produse așteaptă mai întâi aproximativ patru secunde. Clienții, comenzile, checkout-urile, produsele, colecțiile și nivelurile de stoc ajung în Brevo pe această cale, împreună cu evenimente precum order_paid și cart_abandoned. Ghidul de integrare Shopify enumeră fiecare topic și ce scrie în Brevo.

Forma unei reguli de sincronizare

O regulă de sincronizare este o definiție verificată și aprobată a ceea ce se mută exact și cum. Un agent o construiește din descrierea ta, iar o persoană o aprobă. O regulă are patru părți pe care le poți inspecta pe pagina ei, sub Connections > Syncs and mappings:

Parte	Ce face
Maparea câmpurilor	Fiecare câmp sursă, câmpul Brevo în care scrie și orice transformare intermediară
Expresia de filtrare	Evaluată pentru fiecare înregistrare; înregistrările care nu se potrivesc sunt omise
Cursor	Urmărește cât de departe a progresat sincronizarea, astfel încât fiecare rulare continuă de unde s-a oprit ultima
Run history (istoricul rulărilor)	Fiecare rulare, cu înregistrările citite, scrise și eșuate, plus durata și starea

O regulă de sincronizare mută datele într-o singură direcție: din sursa ta către Brevo. Nu scrie niciodată în Shopify. Aplicația Tajo Shopify scrie totuși câteva lucruri înapoi în Shopify, precum dezabonări de la consimțământ și etichete de nivel de loialitate. Shopify permissions explained listează fiecare scriere și când are loc.

Când rulează o regulă de sincronizare

Regulile de sincronizare rulează în loturi. Regulile de sincronizare a contactelor rulează implicit la fiecare 15 minute. O regulă Shopify orders → Brevo orders activă și publicată rulează și ea la fiecare 15 minute, dar doar cu filtrul de opt-in la marketing al cumpărătorului din șablon. O regulă al cărei filtru a fost editat rulează doar când o pornești tu. Prima rulare programată a unei reguli de comenzi pornește cu câteva minute înainte de acel moment și nu trimite comenzi mai vechi. Fiecare rulare ulterioară trimite comenzile actualizate de la rularea anterioară. Comenzile trecute ajung în Brevo doar când rulezi tu regula. Pagina unei reguli active are un buton Test run (1 batch), iar agentul Sync Operator rulează regulile active când i-o ceri. Rulările în loturi sunt cele care fac fiecare scriere verificabilă, încadrată în buget și atribuibilă unei rulări specifice.

Fiecare rulare citește înregistrările noi și modificate de la cursor încoace, aplică filtrul, mapează câmpurile și scrie în Brevo. Înregistrarea rulării arată exact câte înregistrări au fost citite, scrise și eșuate.

Garanțiile de guvernanță

Consimțământul eșuează închis

O regulă care scrie date personale în Brevo nu poate fi publicată fără filtrul de consimțământ și suprimare. La momentul rulării, un contact scris într-un public de marketing fără consimțământ demonstrabil este refuzat. Când consimțământul nu poate fi stabilit, Tajo refuză scrierea, în loc să ghicească. Modul de eșec este întotdeauna „prea precaut”, niciodată „trimis în exces”.

Rulările sunt idempotente

Fiecare scriere poartă o cheie derivată din înregistrarea sursă. Cheia este un hash, deci nu conține date personale. Rularea repetată a unei sincronizări peste aceleași înregistrări, după un eșec, o pauză sau manual, nu creează scrieri duplicate.

Totul este auditat

Publicarea unei reguli, aprobările invalidate și pauzele automate sunt înregistrate în Activity. Fiecare decizie de aprobare are o justificare scrisă. Fiecare rulare este înregistrată în istoricul de rulări al regulii. Aprobarea care a autorizat o publicare este legată de un digest al regulii exacte care a fost previzualizată. Editarea regulii o readuce la stadiul de ciornă și invalidează aprobarea, astfel încât ce rulează este întotdeauna ce a fost autorizat.

Eșecurile pun regula pe pauză

Dacă cinci rulări consecutive eșuează, un întrerupător de siguranță (circuit breaker) pune automat regula pe pauză și afișează ultima eroare pe pagina regulii. Rezolvă cauza, apoi republică pentru a relua. O rulare parțial eșuată își raportează numărul de eșecuri, ca să vezi exact ce nu a ajuns la destinație.

Cum sunt respectate dezabonările

Când un contact se dezabonează printr-un link din subsolul unui e-mail Brevo, acel refuz este înregistrat pentru contactul respectiv, iar Brevo îl exclude din campaniile ulterioare.
În sincronizarea în loturi a clienților, aplicația Tajo Shopify compară momentul consimțământului din Shopify cu momentul dezabonării din Brevo și îl păstrează pe cel mai recent.
O modificare de consimțământ care sosește din Shopify ca webhook este scrisă în Brevo așa cum o raportează Shopify.
Dacă contactul era abonat în Shopify, aplicația Tajo Shopify îl marchează dezabonat și în Shopify. Un eveniment Brevo mută un client doar de la abonat la dezabonat. Nu abonează niciodată pe nimeni, deci un abonat nou în Brevo nu schimbă nimic în Shopify.

Ce date sunt disponibile

Aplicația Tajo Shopify trimite contacte, comenzi, evenimente de comenzi și de coș, catalogul de produse și stocul. Ce trimite o regulă de sincronizare depinde de maparea ei de câmpuri. Pentru clienții Shopify, șablonul mapează câmpurile de identitate, totalul cheltuit, numărul de comenzi, etichetele și opt-in-ul în atribute de contact Brevo pe care le poți folosi în segmente și campanii. Maparea exactă pentru spațiul tău de lucru nu este ascunsă într-o descriere: deschide regula de sincronizare și citește tabelul de mapare a câmpurilor. Acel tabel este răspunsul autoritar la întrebarea „ce se sincronizează”.

Ce nu face Tajo astăzi

Precizia privind limitele contează mai mult decât o listă lungă de funcționalități:

Fără reguli de sincronizare bidirecționale. O regulă de sincronizare scrie doar în Brevo. Scrierile proprii ale aplicației Shopify în Shopify (dezabonări de la consimțământ, metafield-uri Brevo de implicare și loialitate, etichete de nivel de loialitate) sunt listate în Shopify permissions explained.
Nu există reguli de sincronizare în timp real. Regulile de sincronizare rulează în loturi. Doar sincronizarea prin webhook-uri a aplicației Tajo Shopify funcționează pe măsură ce sosesc evenimentele.
Nu există un buton „din nou în stoc”. Aplicația menține stocul produselor la zi în Brevo și trimite un eveniment back_in_stock cumpărătorilor care au cerut să fie anunțați. Cererea trebuie să vină din magazinul tău online: aplicația nu adaugă un buton „Notify me” în tema ta.

Dacă una dintre aceste limite îți blochează un caz de utilizare, spune-i echipei: prioritățile din accesul timpuriu sunt modelate exact de acest tip de feedback.

Unde îți vezi datele

În Tajo: deschide regula de sincronizare sub Connections > Syncs and mappings pentru istoricul rulărilor, poziția cursorului și numărătorile per rulare. Activity înregistrează publicările și pauzele automate.
În Brevo: deschide Contacts și inspectează atributele oricărui contact pentru a confirma că câmpurile mapate se populează. Construiește segmente pe acele atribute pentru targetare.

Depanare

Contactele nu apar în Brevo: verifică ultima rulare a regulii pentru eșecuri și starea ei (o regulă pe pauză nu rulează). Vezi contacts missing in Brevo.
Rulările eșuează în mod repetat: întrerupătorul de siguranță va pune regula pe pauză și va afișa ultima eroare. Vezi data not syncing.
Contacte duplicate: scrierile sunt idempotente per înregistrare sursă, dar duplicatele preexistente din Brevo rămân. Vezi duplicate contacts.

Întrebări frecvente

Pot face sincronizarea mai rapidă? Pagina unei reguli active are un buton Test run (1 batch). Pentru modificări pe măsură ce au loc, sincronizarea prin webhook-uri a aplicației Tajo Shopify acoperă deja clienții, comenzile, checkout-urile, produsele și stocul.

Ce se întâmplă dacă o rulare eșuează la jumătate? Rularea își raportează numărul de eșecuri, cursorul avansează doar peste ce a fost procesat, iar următoarea rulare acoperă din nou terenul în siguranță; cheile de idempotență previn duplicatele.

Pot schimba ce se sincronizează? Da. Cere-i agentului să schimbe maparea câmpurilor sau filtrul regulii. Editarea readuce regula la stadiul de ciornă, iar ea trebuie să treacă din nou prin previzualizare și aprobare înainte să ruleze iar.

De ce s-a pus regula mea singură pe pauză? Eșecurile consecutive ale rulărilor declanșează întrerupătorul de siguranță. Pagina regulii arată numărul de eșecuri și ultima eroare; rezolvă problema și republică.

Articole conexe

Obține ajutor

Contactează echipa.