Capire la sincronizzazione dei dati Shopify con Brevo

Tajo sposta i dati di Shopify in Brevo in due modi. L’app Shopify di Tajo elabora i webhook di Shopify appena arrivano. Le regole di sincronizzazione sono approvate da una persona, vanno in una sola direzione, vengono eseguite in batch e sono registrate dall’inizio alla fine. Questo articolo spiega entrambi, cosa non includono e le poche cose che l’app Shopify di Tajo riscrive su Shopify.

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.

Man mano che accadono gli eventi: l’app Shopify di Tajo

L’app Shopify di Tajo si iscrive ai webhook di Shopify ed elabora ciascuno appena arriva. Le modifiche a clienti e prodotti attendono prima circa quattro secondi. In questo modo arrivano in Brevo clienti, ordini, checkout, prodotti, collezioni e livelli delle scorte, insieme a eventi come order_paid e cart_abandoned. La guida all’integrazione con Shopify elenca ogni topic e cosa scrive in Brevo.

La forma di una regola di sincronizzazione

Una regola di sincronizzazione è una definizione rivista e approvata di cosa esattamente si sposta e come. Un agente la costruisce dalla tua descrizione e una persona la approva. Una regola ha quattro parti che puoi ispezionare nella sua pagina, sotto Connections > Syncs and mappings:

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

Una regola di sincronizzazione sposta i dati in una sola direzione: dalla tua fonte verso Brevo. Non scrive mai su Shopify. L’app Shopify di Tajo però riscrive alcune cose su Shopify, come le disiscrizioni e i tag del livello fedeltà. Permessi Shopify spiegati elenca ogni scrittura e quando avviene.

Quando viene eseguita una regola di sincronizzazione

Le regole di sincronizzazione vengono eseguite in batch. Le regole di sincronizzazione dei contatti vengono eseguite ogni 15 minuti per impostazione predefinita. Anche una regola Shopify orders → Brevo orders attiva e pubblicata viene eseguita ogni 15 minuti, ma solo con il filtro di opt-in al marketing dell’acquirente previsto dal template. Una regola con il filtro modificato viene eseguita solo quando la avvii tu. La prima esecuzione pianificata di una regola degli ordini parte da qualche minuto prima di quel momento e non invia ordini più vecchi. Ogni esecuzione successiva invia gli ordini aggiornati dopo quella precedente. Gli ordini passati arrivano in Brevo solo quando esegui tu la regola. La pagina di una regola attiva ha un pulsante Test run (1 batch), e l’agente Sync Operator esegue le regole attive quando glielo chiedi. Le esecuzioni a batch sono ciò che rende ogni scrittura verificabile, soggetta a budget e attribuibile a un’esecuzione specifica.

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 che scrive dati personali in Brevo non può essere pubblicata senza il filtro di consenso e soppressione. In fase di esecuzione, un contatto scritto in un pubblico di marketing senza consenso dimostrabile viene rifiutato. 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 derivata dal record di origine. La chiave è un hash, quindi non contiene dati personali. Rieseguire una sincronizzazione sugli stessi record, dopo un fallimento, una pausa o manualmente, non crea scritture duplicate.

Tutto viene sottoposto ad audit

La pubblicazione di una regola, le approvazioni invalidate e le pause automatiche vengono registrate in Activity. Ogni decisione di approvazione ha una motivazione scritta. Ogni esecuzione viene registrata nella cronologia delle esecuzioni della regola. L’approvazione che ha autorizzato una pubblicazione è vincolata a un digest della regola esatta di cui è stata fatta l’anteprima. Modificare la regola la riporta in bozza e invalida l’approvazione, così ciò che viene eseguito è sempre ciò che è stato autorizzato.

I fallimenti mettono in pausa la regola

Se cinque 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

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.
Nella sincronizzazione batch dei clienti, l’app Shopify di Tajo confronta l’ora del consenso su Shopify con l’ora della disiscrizione su Brevo e mantiene la più recente.
Una modifica del consenso che arriva da Shopify come webhook viene scritta in Brevo così come Shopify la riporta.
Se il contatto era iscritto su Shopify, l’app Shopify di Tajo lo segna come disiscritto anche lì. Un evento Brevo sposta un cliente sempre e solo da iscritto a disiscritto. Non iscrive mai nessuno, quindi un’iscrizione in Brevo non cambia nulla su Shopify.

Quali dati sono disponibili

L’app Shopify di Tajo invia contatti, ordini, eventi di ordini e carrelli, il catalogo prodotti e le scorte. Cosa invia una regola di sincronizzazione dipende dalla sua mappatura dei campi. Per i clienti Shopify, il modello mappa campi identificativi, spesa totale, numero di ordini, tag e opt-in 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 regola di sincronizzazione bidirezionale. Una regola di sincronizzazione scrive solo in Brevo. Le scritture proprie dell’app Shopify su Shopify (disiscrizioni, metacampi di coinvolgimento e fedeltà Brevo, tag del livello fedeltà) sono elencate in Permessi Shopify spiegati.
Nessuna regola di sincronizzazione in tempo reale. Le regole di sincronizzazione vengono eseguite in batch. Solo la sincronizzazione via webhook dell’app Shopify di Tajo funziona man mano che arrivano gli eventi.
Nessun pulsante per il ritorno in magazzino. L’app mantiene aggiornate in Brevo le scorte dei prodotti e invia un evento back_in_stock agli acquirenti che hanno chiesto di essere avvisati. La richiesta deve arrivare dalla tua vetrina: l’app non aggiunge un pulsante “Avvisami” al tuo tema.

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 Connections > Syncs and mappings per la cronologia delle esecuzioni, la posizione del cursore e i conteggi per esecuzione. Activity registra pubblicazioni e pause automatiche.
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? La pagina di una regola attiva ha un pulsante Test run (1 batch). Per le modifiche man mano che avvengono, la sincronizzazione via webhook dell’app Shopify di Tajo copre già clienti, ordini, checkout, prodotti e scorte.

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ì. Chiedi all’agente di modificare la mappatura dei campi o il filtro della regola. La modifica riporta la regola in bozza, e deve ripassare da anteprima e approvazione prima di essere eseguita di nuovo.

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

Contatta il team.