Förstå Shopify-datasynkronisering med Brevo

Tajo flyttar Shopify-data in i Brevo på två sätt. Tajos Shopify-app bearbetar Shopify-webhooks när de kommer in. Synkregler är godkända av människor, enkelriktade, körs i batchar och loggas från början till slut. Den här artikeln förklarar båda, vad de inte omfattar och de få saker som Tajos Shopify-app skriver tillbaka till Shopify.

Snabbkoll Artikeln utgår från att du har anslutit Shopify och Brevo och publicerat minst en synkregel. Om inte, börja med connecting Tajo to Shopify.

När händelserna sker: Tajos Shopify-app

Tajos Shopify-app prenumererar på Shopify-webhooks och bearbetar var och en när den kommer in. Ändringar av kunder och produkter väntar först omkring fyra sekunder. Kunder, ordrar, checkouter, produkter, kollektioner och lagernivåer når Brevo på det här sättet, tillsammans med händelser som order_paid och cart_abandoned. Integrationsguiden för Shopify listar varje ämne och vad det skriver till Brevo.

Så är en synkregel uppbyggd

En synkregel är en granskad, godkänd definition av exakt vad som flyttas och hur. En agent bygger den utifrån din beskrivning, och en människa godkänner den. En regel har fyra delar som du kan inspektera på dess sida under Connections > Syncs and mappings:

Del	Vad den gör
Fältmappning	Varje källfält, vilket Brevo-fält det skriver till och eventuell transformation däremellan
Filteruttryck	Utvärderas per post; poster som inte matchar hoppas över
Cursor	Håller koll på hur långt synkroniseringen har kommit, så att varje körning fortsätter där den förra slutade
Körhistorik	Varje körning, med antal poster lästa, skrivna och misslyckade, plus tidsåtgång och status

En synkregel flyttar data i en riktning: från din källa in i Brevo. Den skriver aldrig till Shopify. Tajos Shopify-app skriver dock några få saker tillbaka till Shopify, till exempel avregistreringar av samtycke och lojalitetsnivåtaggar. Shopify permissions explained listar varje skrivning och när den sker.

När en synkregel körs

Synkregler körs i batchar. Synkregler för kontakter körs som standard var 15:e minut. En aktiv, publicerad regel av typen Shopify orders → Brevo orders körs också var 15:e minut, men bara med mallens filter för köparens marknadsföringssamtycke. En regel vars filter har redigerats körs bara när du startar den. En orderregels första schemalagda körning börjar några minuter före det ögonblicket och skickar inga äldre ordrar. Varje senare körning skickar ordrarna som uppdaterats sedan den förra. Tidigare ordrar når Brevo bara när du själv kör regeln. Sidan för en aktiv regel har knappen Test run (1 batch), och agenten Sync Operator kör aktiva regler när du ber den om det. Det är batchkörningarna som gör varje skrivning granskningsbar, budgeterad och spårbar till en specifik körning.

Varje körning läser nya och ändrade poster sedan cursorn, tillämpar filtret, mappar fälten och skriver till Brevo. Körningsposten visar exakt hur många poster som lästes, skrevs och misslyckades.

Styrningsgarantierna

Samtycke nekar vid tvekan (fails closed)

En regel som skriver persondata till Brevo kan inte publiceras utan filtret för samtycke och spärrar (suppression). Vid körning nekas en kontakt som skulle skrivas till en marknadsföringsmålgrupp utan bevisbart samtycke. När samtycke inte kan fastställas avstår Tajo från skrivningen hellre än att gissa. Felläget är alltid “för försiktig”, aldrig “skickade för mycket”.

Körningar är idempotenta

Varje skrivning bär en nyckel som härleds ur källposten. Nyckeln är en hash, så den innehåller inga persondata. En omkörning av en synkronisering över samma poster, efter ett fel, en paus eller manuellt, skapar inga dubblettskrivningar.

Allt loggas

Publiceringen av en regel, ogiltigförklarade godkännanden och automatiska pauser registreras under Activity. Varje godkännandebeslut har en skriftlig motivering. Varje körning registreras i regelns körhistorik. Godkännandet som auktoriserade en publicering är bundet till en digest av exakt den regel som förhandsgranskades. Om regeln redigeras går den tillbaka till utkast och godkännandet blir ogiltigt, så det som körs är alltid det som auktoriserades.

Fel pausar regeln

Om fem körningar i rad misslyckas pausar en säkerhetsbrytare (circuit breaker) regeln automatiskt och visar det senaste felet på regelns sida. Åtgärda orsaken och publicera om för att återuppta. En delvis misslyckad körning rapporterar sitt antal misslyckade poster, så att du ser exakt vad som inte landade.

Så respekteras avprenumerationer

När en kontakt avprenumererar via en länk i sidfoten i ett Brevo-mejl registreras det valet på kontakten, och Brevo utesluter den från vidare kampanjer.
I batchsynken av kunder jämför Tajos Shopify-app tidpunkten för samtycket i Shopify med tidpunkten för avprenumerationen i Brevo och behåller den senare.
En samtyckesändring som kommer från Shopify som en webhook skrivs till Brevo så som Shopify rapporterar den.
Om kontakten var prenumerant i Shopify markerar Tajos Shopify-app den som avprenumererad även där. En Brevo-händelse flyttar bara en kund från prenumerant till avprenumererad. Den prenumererar aldrig någon, så en prenumeration i Brevo ändrar ingenting i Shopify.

Vilken data som finns tillgänglig

Tajos Shopify-app skickar kontakter, ordrar, order- och varukorgshändelser, produktkatalogen och lagersaldon. Vad en synkregel skickar beror på dess fältmappning. För Shopify-kunder mappar mallen identitetsfält, total köpsumma, antal ordrar, taggar och samtycket (opt-in) till Brevo-kontaktattribut som du kan använda i segment och kampanjer. Den exakta mappningen för din arbetsyta är inte gömd i en beskrivning: öppna synkregeln och läs fältmappningstabellen. Den tabellen är det auktoritativa svaret på “vad synkroniseras”.

Vad Tajo inte gör i dag

Att vara exakt om gränserna är viktigare än en lång funktionslista:

Inga synkregler i två riktningar. En synkregel skriver bara in i Brevo. Shopify-appens egna skrivningar till Shopify (avregistreringar av samtycke, metafält för Brevo-engagemang och lojalitet, lojalitetsnivåtaggar) listas i Shopify permissions explained.
Inga synkregler i realtid. Synkregler körs i batchar. Bara webhooksynken i Tajos Shopify-app fungerar när händelserna kommer in.
Ingen “tillbaka i lager”-knapp. Appen håller produkternas lagersaldo aktuellt i Brevo och skickar en back_in_stock-händelse till kunder som har bett om att bli meddelade. Begäran måste komma från din butiksfront: appen lägger inte till någon “Notify me”-knapp i ditt tema.

Om någon av de här gränserna blockerar ett användningsfall för dig, berätta det för teamet. Prioriteringarna under tidig åtkomst formas av exakt den här typen av återkoppling.

Var du ser din data

I Tajo: öppna synkregeln under Connections > Syncs and mappings för körhistorik, cursorposition och antal per körning. Activity registrerar publiceringar och automatiska pauser.
I Brevo: öppna Contacts och inspektera attributen på valfri kontakt för att bekräfta att mappade fält fylls i. Bygg segment på de attributen för målgruppsstyrning.

Felsökning

Kontakter dyker inte upp i Brevo: kontrollera regelns senaste körning efter fel och dess status (en pausad regel körs inte). Se contacts missing in Brevo.
Körningar misslyckas gång på gång: säkerhetsbrytaren pausar regeln och visar det senaste felet. Se data not syncing.
Dubblettkontakter: skrivningar är idempotenta per källpost, men dubbletter som redan fanns i Brevo blir kvar. Se duplicate contacts.

Vanliga frågor

Kan jag göra synkroniseringen snabbare? Sidan för en aktiv regel har knappen Test run (1 batch). För ändringar när de sker täcker webhooksynken i Tajos Shopify-app redan kunder, ordrar, checkouter, produkter och lagersaldon.

Vad händer om en körning misslyckas halvvägs? Körningen rapporterar sitt antal misslyckade poster, cursorn flyttas bara fram över det som bearbetades, och nästa körning täcker tryggt samma mark igen; idempotensnycklar förhindrar dubbletter.

Kan jag ändra vad som synkroniseras? Ja. Be agenten ändra regelns fältmappning eller filter. Ändringen för regeln tillbaka till utkast, och den måste gå igenom förhandsgranskning och godkännande igen innan den körs på nytt.

Varför pausade sig min regel själv? Flera misslyckade körningar i rad utlöser säkerhetsbrytaren. Regelns sida visar antalet fel och det senaste felet; åtgärda problemet och publicera om.

Relaterade artiklar

Få hjälp

Kontakta teamet.