Tajo flytter Shopify-data inn i Brevo på to måter. Tajos Shopify-app behandler Shopify-webhooks etter hvert som de kommer inn. Synkroniseringsregler er menneskegodkjente, enveis, kjøres i batcher og logges fra ende til annen. Denne artikkelen forklarer begge, hva de ikke omfatter, og de få tingene Tajos Shopify-app skriver tilbake til Shopify.
Rask sjekk Denne artikkelen forutsetter at du har koblet til Shopify og Brevo, og publisert minst én synkroniseringsregel. Hvis ikke, start med å koble Tajo til Shopify.
Etter hvert som hendelser skjer: Tajos Shopify-app
Tajos Shopify-app abonnerer på Shopify-webhooks og behandler hver av dem når den kommer inn. Endringer i kunder og produkter venter først omtrent fire sekunder. Kunder, ordrer, checkouts, produkter, kolleksjoner og lagernivåer når Brevo på denne måten, sammen med hendelser som order_paid og cart_abandoned. Guiden til Shopify-integrasjonen viser hvert emne og hva det skriver til Brevo.
Formen på en synkroniseringsregel
En synkroniseringsregel er en gjennomgått, godkjent definisjon av nøyaktig hva som flyttes, og hvordan. En agent bygger den ut fra beskrivelsen din, og en person godkjenner den. En regel har fire deler du kan inspisere på siden sin under Connections > Syncs and mappings:
| Del | Hva den gjør |
|---|---|
| Feltmapping | Hvert kildefelt, Brevo-feltet det skriver til, og eventuell transformasjon imellom |
| Filteruttrykk | Evaluert per post; poster som ikke matcher, hoppes over |
| Cursor | Sporer hvor langt synkroniseringen har kommet, slik at hver kjøring fortsetter der den forrige stoppet |
| Kjørehistorikk | Hver kjøring, med antall leste, skrevne og feilede poster, pluss varighet og status |
En synkroniseringsregel flytter data i én retning: fra kilden din inn i Brevo. Den skriver aldri til Shopify. Tajos Shopify-app skriver derimot noen få ting tilbake til Shopify, for eksempel avmeldinger av samtykke og lojalitetsnivå-tagger. Shopify-tillatelser forklart viser hver skriving og når den skjer.
Når en synkroniseringsregel kjører
Synkroniseringsregler kjører i batcher. Regler for kontaktsynkronisering kjører hvert 15. minutt som standard. En aktiv, publisert regel Shopify orders → Brevo orders kjører også hvert 15. minutt, men bare med malens opt-in-filter for markedsføring til kjøperen. En regel med redigert filter kjører bare når du starter den selv. Den første planlagte kjøringen av en ordreregel starter noen minutter før det øyeblikket og sender ingen eldre ordrer. Hver senere kjøring sender ordrene som er oppdatert siden forrige kjøring. Tidligere ordrer kommer til Brevo bare når du kjører regelen selv. Siden til en aktiv regel har knappen Test run (1 batch), og agenten Sync Operator kjører aktive regler når du ber den om det. Batchkjøringer er det som gjør hver skriving gjennomgåelig, budsjettert og sporbar til en bestemt kjøring.
Hver kjøring leser nye og endrede poster siden cursoren, bruker filteret, mapper feltene og skriver til Brevo. Kjøreposten viser nøyaktig hvor mange poster som ble lest, skrevet og feilet.
Styringsgarantiene
Samtykke feiler lukket
En regel som skriver personopplysninger til Brevo, kan ikke publiseres uten samtykke- og sperrefilteret. Ved kjøring avvises en kontakt som skrives til en markedsføringsmålgruppe uten dokumenterbart samtykke. Når samtykke ikke kan fastslås, sier Tajo nei til skrivingen fremfor å gjette. Feilmodusen er alltid «for forsiktig», aldri «oversendt».
Kjøringer er idempotente
Hver skriving har en nøkkel utledet fra kildeposten. Nøkkelen er en hash, så den inneholder ingen personopplysninger. Å kjøre en synkronisering på nytt over de samme postene, etter en feil, en pause eller manuelt, skaper ikke dupliserte skrivinger.
Alt blir revidert
Publisering av en regel, ugyldiggjorte godkjenninger og automatiske pauser registreres under Activity. Hver godkjenningsbeslutning har en skriftlig begrunnelse. Hver kjøring registreres i regelens kjørehistorikk. Godkjenningen som autoriserte en publisering, er bundet til en digest av nøyaktig den regelen som ble forhåndsvist. Hvis du redigerer regelen, går den tilbake til utkast og godkjenningen blir ugyldig, så det som kjører, er alltid det som ble autorisert.
Feil setter regelen på pause
Hvis fem kjøringer på rad feiler, setter en circuit breaker automatisk regelen på pause og viser den siste feilen på regelens side. Fiks årsaken, og republiser deretter for å gjenoppta. En delvis feilet kjøring rapporterer antallet feilede poster, slik at du nøyaktig kan se hva som ikke kom med.
Slik respekteres avmeldinger
- Når en kontakt melder seg av via en avmeldingslenke i en Brevo-e-post, registreres det reservasjonen mot kontakten, og Brevo utelukker vedkommende fra videre kampanjer.
- I batchsynkroniseringen av kunder sammenligner Tajos Shopify-app tidspunktet for samtykket i Shopify med tidspunktet for avmeldingen i Brevo, og beholder det seneste.
- En samtykkeendring som kommer fra Shopify som en webhook, skrives til Brevo slik Shopify rapporterer den.
- Hvis kontakten var påmeldt i Shopify, markerer Tajos Shopify-app vedkommende som avmeldt der også. En Brevo-hendelse flytter bare en kunde fra påmeldt til avmeldt. Den melder aldri noen på, så en påmelding i Brevo endrer ingenting i Shopify.
Hvilke data er tilgjengelige
Tajos Shopify-app sender kontakter, ordrer, ordre- og handlekurvhendelser, produktkatalogen og lagerbeholdning. Hva en synkroniseringsregel sender, avhenger av feltmappingen. For Shopify-kunder mapper malen identitetsfelter, totalt forbruk, antall bestillinger, tagger og opt-in inn i Brevo-kontaktattributter du kan bruke i segmenter og kampanjer. Den nøyaktige mappingen for workspacet ditt er ikke gjemt bort i en beskrivelse: åpne synkroniseringsregelen, og les feltmapping-tabellen. Den tabellen er det autoritative svaret på «hva synkroniseres».
Hva Tajo ikke gjør i dag
Å være presis om grensene betyr mer enn en lang funksjonsliste:
- Ingen synkroniseringsregler i to retninger. En synkroniseringsregel skriver bare inn i Brevo. Shopify-appens egne skrivinger til Shopify (avmeldinger av samtykke, metafelt for Brevo-engasjement og lojalitet, lojalitetsnivå-tagger) står i Shopify-tillatelser forklart.
- Ingen synkroniseringsregler i sanntid. Synkroniseringsregler kjører i batcher. Bare webhook-synkroniseringen i Tajos Shopify-app fungerer etter hvert som hendelser kommer inn.
- Ingen knapp for tilbake på lager. Appen holder produktbeholdningen oppdatert i Brevo og sender en
back_in_stock-hendelse til kunder som har bedt om å bli varslet. Forespørselen må komme fra nettbutikken din: appen legger ikke til en «Varsle meg»-knapp i temaet ditt.
Hvis en av disse grensene blokkerer et bruksscenario for deg, si ifra til teamet, prioriteringene i early access formes nettopp av slik tilbakemelding.
Hvor du kan se dataene dine
- I Tajo: åpne synkroniseringsregelen under Connections > Syncs and mappings for kjørehistorikk, cursorposisjon og antall per kjøring. Activity registrerer publiseringer og automatiske pauser.
- I Brevo: åpne Contacts, og inspiser en vilkårlig kontakts attributter for å bekrefte at mappede felter fylles ut. Bygg segmenter på de attributtene for målretting.
Feilsøking
- Kontakter dukker ikke opp i Brevo: sjekk regelens siste kjøring for feil, og statusen (en pauset regel kjører ikke). Se manglende kontakter i Brevo.
- Kjøringer feiler gjentatte ganger: circuit breakeren setter regelen på pause og viser den siste feilen. Se data synkroniseres ikke.
- Dupliserte kontakter: skrivinger er idempotente per kildepost, men eksisterende duplikater i Brevo blir værende. Se dupliserte kontakter.
Vanlige spørsmål
Kan jeg gjøre synkroniseringen raskere? Siden til en aktiv regel har knappen Test run (1 batch). For endringer etter hvert som de skjer, dekker webhook-synkroniseringen i Tajos Shopify-app allerede kunder, ordrer, checkouts, produkter og lagerbeholdning.
Hva skjer hvis en kjøring feiler halvveis? Kjøringen rapporterer antallet feilede poster, cursoren beveger seg bare fremover over det som ble behandlet, og neste kjøring dekker trygt resten på nytt; idempotensnøkler forhindrer duplikater.
Kan jeg endre hva som synkroniseres? Ja. Be agenten endre regelens feltmapping eller filter. Redigeringen setter regelen tilbake til utkast, og den må gjennom forhåndsvisning og godkjenning igjen før den kjører på nytt.
Hvorfor satte regelen min seg selv på pause? Feil i flere kjøringer på rad utløser circuit breakeren. Regelens side viser antall feil og den siste feilen; fiks problemet, og republiser.
Relaterte artikler
- Koble Tajo til Shopify
- Segmentering: det grunnleggende
- Feilsøking: data synkroniseres ikke
- Feilsøking: manglende kontakter i Brevo