Capire la sincronizzazione dei dati Shopify con Brevo

Tajo sposta i dati dal tuo sistema di origine verso Brevo tramite regole di sincronizzazione controllate: approvate da una persona, in una sola direzione, eseguite secondo una pianificazione e registrate dall’inizio alla fine. Questo articolo spiega cosa significa in pratica e cosa non include.

Verifica rapida Questo articolo presuppone che tu abbia già collegato Shopify e Brevo e pubblicato almeno una regola di sincronizzazione. In caso contrario, inizia da collegare Tajo a Shopify.

La forma di una sincronizzazione

Ogni sincronizzazione in Tajo è una regola di sincronizzazione: una definizione rivista e approvata di cosa esattamente si sposta e come. Una regola ha quattro parti che puoi ispezionare nella sua pagina, sotto Connettori > Sincronizzazioni:

Parte	Cosa fa
Mappatura dei campi	Ogni campo di origine, il campo Brevo su cui scrive e qualsiasi trasformazione intermedia
Espressione di filtro	Valutata per ogni record; i record che non corrispondono vengono ignorati
Cursore	Traccia fino a dove è arrivata la sincronizzazione, così ogni esecuzione riparte da dove si era fermata l’ultima
Cronologia delle esecuzioni	Ogni esecuzione, con i record letti, scritti e falliti, più durata e stato

I dati fluiscono in una sola direzione: dalla tua fonte verso Brevo. Tajo non scrive dati indietro verso Shopify.

Quando i dati si sincronizzano

Le esecuzioni di sincronizzazione avvengono in batch pianificati, oppure su richiesta quando avvii un’esecuzione dalla pagina della regola. Tajo non è una pipeline in tempo reale: una modifica su Shopify raggiunge Brevo alla prossima esecuzione, non entro pochi secondi. È una scelta deliberata: le esecuzioni a batch sono ciò che rende ogni scrittura verificabile, soggetta a budget e attribuibile a un’esecuzione specifica nell’audit trail.

Ogni esecuzione legge i record nuovi e modificati a partire dal cursore, applica il filtro, mappa i campi e scrive su Brevo. Il resoconto dell’esecuzione mostra esattamente quanti record sono stati letti, scritti e falliti.

Le garanzie di governance

Il consenso fallisce in modo chiuso

Una regola di sincronizzazione non può essere pubblicata senza una policy sul consenso e, in fase di esecuzione, un record senza consenso dimostrabile non viene scritto. Quando il consenso non può essere stabilito, Tajo rifiuta la scrittura invece di tirare a indovinare. La modalità di fallimento è sempre “troppo prudente”, mai “inviato troppo”.

Le esecuzioni sono idempotenti

Ogni scrittura porta con sé una chiave di provenienza derivata dal record di origine (costruita per essere sicura rispetto ai dati personali), quindi rieseguire una sincronizzazione, dopo un fallimento, una pausa o manualmente, non crea scritture duplicate. È sempre sicuro eseguire di nuovo una regola.

Tutto viene sottoposto ad audit

La pubblicazione di una regola, ogni decisione di approvazione (con la sua motivazione scritta) e ogni esecuzione vengono registrate nell’audit trail. L’approvazione che ha autorizzato una pubblicazione è vincolata alla versione esatta della regola che è stata rivista; modificare la regola invalida l’approvazione, così l’audit trail riflette sempre ciò che è stato realmente autorizzato.

I fallimenti mettono in pausa la regola

Se più esecuzioni consecutive falliscono, un circuit breaker mette in pausa la regola automaticamente e mostra l’ultimo errore nella pagina della regola. Risolvi la causa, poi ripubblica per riprendere. Un’esecuzione parzialmente fallita riporta il proprio conteggio di errori, così puoi vedere esattamente cosa non è arrivato a destinazione.

Come vengono rispettate le disiscrizioni

Tajo tratta Brevo come fonte di verità per il consenso email:

Quando un contatto si disiscrive tramite il link nel footer di un’email Brevo, quell’opt-out viene registrato sul contatto e Brevo lo esclude dalle campagne successive.
I contatti inseriti in blacklist su Brevo restano esclusi: gli invii successivi non li fanno riapparire.
Tajo non riporta lo stato di disiscrizione su Shopify. Se raccogli il consenso email anche su Shopify, gestiscilo lì separatamente; non dare per scontato che i due sistemi si rispecchino a vicenda.

Quali dati sono disponibili

Cosa si sincronizza dipende dai modelli disponibili per la tua fonte. Per Shopify, la forma tipica sono i record cliente: campi identificativi e attributi derivati dagli ordini come la spesa totale e il numero di ordini, mappati sugli attributi contatto di Brevo che puoi usare nei segmenti e nelle campagne. La mappatura esatta per il tuo workspace non è nascosta in una descrizione: apri la regola di sincronizzazione e leggi la tabella di mappatura dei campi. Quella tabella è la risposta autorevole a “cosa si sincronizza”.

Cosa Tajo non fa oggi

Essere precisi sui confini conta più di un lungo elenco di funzionalità:

Nessuna sincronizzazione bidirezionale. Niente viene scritto indietro verso Shopify: né disiscrizioni, né tag, né punteggi di coinvolgimento.
Nessuna sincronizzazione in tempo reale. Le esecuzioni sono batch pianificati o attivati manualmente, non streaming sub-minuto.
Nessun monitoraggio dell’inventario. I livelli di scorta dei prodotti non vengono monitorati e non ci sono trigger di ritorno in stock.

Se uno di questi confini blocca un tuo caso d’uso, dillo al team: le priorità dell’accesso anticipato vengono definite proprio da questo tipo di feedback.

Dove vedere i tuoi dati

In Tajo: apri la regola di sincronizzazione sotto Connettori > Sincronizzazioni per la cronologia delle esecuzioni, la posizione del cursore e i conteggi per esecuzione. L’audit trail registra pubblicazioni e approvazioni.
In Brevo: apri Contatti e ispeziona gli attributi di qualsiasi contatto per confermare che i campi mappati si stiano popolando. Costruisci segmenti su quegli attributi per il targeting.

Risoluzione dei problemi

Contatti che non appaiono in Brevo: controlla l’ultima esecuzione della regola per eventuali fallimenti e il suo stato (una regola in pausa non è in esecuzione). Consulta Contatti mancanti in Brevo.
Esecuzioni che falliscono ripetutamente: il circuit breaker metterà in pausa la regola e mostrerà l’ultimo errore. Consulta I dati non si sincronizzano.
Contatti duplicati: le scritture sono idempotenti per record di origine, ma i duplicati preesistenti in Brevo restano. Consulta Contatti duplicati.

Domande frequenti

Posso rendere la sincronizzazione più veloce? Puoi avviare un’esecuzione su richiesta in qualsiasi momento dalla pagina della regola di sincronizzazione. Non esiste una modalità in tempo reale.

Cosa succede se un’esecuzione fallisce a metà? L’esecuzione riporta il proprio conteggio di errori, il cursore avanza solo su ciò che è stato elaborato e l’esecuzione successiva ricopre in sicurezza il terreno mancante: le chiavi di idempotenza impediscono i duplicati.

Posso cambiare cosa si sincronizza? Sì: modifica la mappatura dei campi o il filtro della regola. La modifica produce una nuova versione che deve passare di nuovo dall’approvazione alla pubblicazione prima di entrare in vigore.

Perché la mia regola si è messa in pausa da sola? I fallimenti consecutivi delle esecuzioni fanno scattare il circuit breaker. La pagina della regola mostra il conteggio dei fallimenti e l’ultimo errore; risolvi il problema e ripubblica.

Ottieni aiuto

Chat dal vivo: disponibile nella dashboard Tajo (in basso a destra)
Supporto via email: [email protected]
Documentazione: docs.tajo.io