Shopify-Datensynchronisation mit Brevo verstehen

Tajo bringt Shopify-Daten auf zwei Wegen nach Brevo. Die Tajo-Shopify-App verarbeitet Shopify-Webhooks, sobald sie eintreffen. Sync-Regeln sind von Menschen freigegeben, laufen in eine Richtung, werden in Batches ausgeführt und von Anfang bis Ende protokolliert. Dieser Artikel erklärt beides, was nicht dazugehört und welche wenigen Dinge die Tajo-Shopify-App zurück nach Shopify schreibt.

Kurzcheck Dieser Artikel setzt voraus, dass du Shopify und Brevo verbunden und mindestens eine Sync-Regel veröffentlicht hast. Falls nicht, starte mit Tajo mit Shopify verbinden.

Sobald Events eintreffen: die Tajo-Shopify-App

Die Tajo-Shopify-App abonniert Shopify-Webhooks und verarbeitet jeden einzelnen, sobald er eintrifft. Bei Kunden- und Produktänderungen wartet sie vorher etwa vier Sekunden. Kund:innen, Bestellungen, Checkouts, Produkte, Kollektionen und Lagerbestände erreichen Brevo auf diesem Weg, zusammen mit Events wie order_paid und cart_abandoned. Der Shopify-Integrationsleitfaden listet jedes Thema auf und was es nach Brevo schreibt.

So ist eine Sync-Regel aufgebaut

Eine Sync-Regel ist eine geprüfte, freigegebene Definition dessen, was genau bewegt wird und wie. Ein Agent baut sie aus deiner Beschreibung, und ein Mensch gibt sie frei. Eine Regel hat vier Teile, die du auf ihrer Seite unter Connections > Syncs and mappings einsehen kannst:

Teil	Was er tut
Feldzuordnung	Jedes Quellfeld, das Brevo-Feld, in das es schreibt, und jede Transformation dazwischen
Filterausdruck	Wird pro Datensatz ausgewertet; Datensätze, die nicht passen, werden übersprungen
Cursor	Hält fest, wie weit die Synchronisierung fortgeschritten ist, damit jeder Lauf dort weitermacht, wo der letzte aufgehört hat
Laufverlauf	Jeder Lauf mit gelesenen, geschriebenen und fehlgeschlagenen Datensätzen sowie Dauer und Status

Eine Sync-Regel bewegt Daten in eine Richtung: von deiner Quelle nach Brevo. Sie schreibt nie nach Shopify. Die Tajo-Shopify-App schreibt jedoch einige Dinge zurück nach Shopify, zum Beispiel Opt-outs bei der Einwilligung und Treuestufen-Tags. Shopify-Berechtigungen erklärt listet jeden Schreibvorgang und den Zeitpunkt auf.

Wann eine Sync-Regel läuft

Sync-Regeln laufen in Batches. Kontakt-Sync-Regeln laufen standardmäßig alle 15 Minuten. Eine aktive, veröffentlichte Regel Shopify orders → Brevo orders läuft ebenfalls alle 15 Minuten, aber nur mit dem Opt-in-Filter des Templates für die Marketing-Einwilligung der Käufer:innen. Eine Regel mit bearbeitetem Filter läuft nur, wenn du sie startest. Der erste geplante Lauf einer Bestellregel beginnt einige Minuten vor diesem Moment und sendet keine älteren Bestellungen. Jeder weitere Lauf sendet die Bestellungen, die seit dem vorherigen Lauf aktualisiert wurden. Frühere Bestellungen gelangen nur nach Brevo, wenn du die Regel selbst ausführst. Die Seite einer aktiven Regel hat eine Schaltfläche Test run (1 batch), und der Agent Sync Operator führt aktive Regeln aus, wenn du ihn darum bittest. Batch-Läufe machen jeden Schreibvorgang prüfbar, budgetierbar und einem konkreten Lauf zuordenbar.

Jeder Lauf liest die seit dem Cursor neuen und geänderten Datensätze, wendet den Filter an, ordnet die Felder zu und schreibt nach Brevo. Der Lauf-Eintrag zeigt exakt, wie viele Datensätze gelesen, geschrieben und fehlgeschlagen sind.

Die Governance-Garantien

Einwilligung ist fail-closed

Eine Regel, die personenbezogene Daten nach Brevo schreibt, kann ohne den Einwilligungs- und Sperrfilter nicht veröffentlicht werden. Zur Laufzeit wird ein Kontakt, der ohne nachweisbare Einwilligung in eine Marketing-Zielgruppe geschrieben werden soll, abgelehnt. Lässt sich die Einwilligung nicht belegen, verweigert Tajo den Schreibvorgang, statt zu raten. Der Fehlermodus ist immer „zu vorsichtig“, nie „zu viel gesendet“.

Läufe sind idempotent

Jeder Schreibvorgang trägt einen Schlüssel, der aus dem Quelldatensatz abgeleitet ist. Der Schlüssel ist ein Hash und enthält daher keine personenbezogenen Daten. Eine Synchronisierung über dieselben Datensätze erneut auszuführen, ob nach einem Fehlschlag, einer Pause oder von Hand, erzeugt keine doppelten Schreibvorgänge.

Alles wird auditiert

Die Veröffentlichung einer Regel, ungültig gewordene Freigaben und automatische Pausen werden unter Activity festgehalten. Jede Freigabeentscheidung trägt eine schriftliche Begründung. Jeder Lauf wird im Laufverlauf der Regel festgehalten. Die Freigabe, die eine Veröffentlichung autorisiert hat, ist an einen Digest genau der Regel gebunden, die in der Vorschau geprüft wurde. Wird die Regel bearbeitet, geht sie zurück in den Entwurf und die Freigabe verfällt. So läuft immer genau das, was autorisiert wurde.

Fehlschläge pausieren die Regel

Schlagen fünf Läufe in Folge fehl, pausiert ein Circuit Breaker die Regel automatisch und zeigt den letzten Fehler auf der Seite der Regel an. Behebe die Ursache und veröffentliche neu, um fortzufahren. Ein teilweise fehlgeschlagener Lauf meldet seine Fehlanzahl, damit du genau siehst, was nicht angekommen ist.

So werden Abmeldungen respektiert

Meldet sich ein Kontakt über den Abmeldelink im Fußbereich einer Brevo-E-Mail ab, wird dieses Opt-out am Kontakt vermerkt, und Brevo schließt ihn von weiteren Kampagnen aus.
In der Batch-Kundensynchronisierung vergleicht die Tajo-Shopify-App den Zeitpunkt der Shopify-Einwilligung mit dem Zeitpunkt der Brevo-Abmeldung und behält den späteren.
Eine Einwilligungsänderung, die als Webhook aus Shopify eintrifft, wird so nach Brevo geschrieben, wie Shopify sie meldet.
Wenn der Kontakt in Shopify angemeldet war, markiert die Tajo-Shopify-App ihn dort ebenfalls als abgemeldet. Ein Brevo-Event bewegt einen Kunden immer nur von angemeldet zu abgemeldet. Es meldet nie jemanden an, daher ändert eine Anmeldung in Brevo nichts in Shopify.

Welche Daten verfügbar sind

Die Tajo-Shopify-App sendet Kontakte, Bestellungen, Bestell- und Warenkorb-Events, den Produktkatalog und Lagerbestände. Was eine Sync-Regel sendet, hängt von ihrer Feldzuordnung ab. Für Shopify-Kund:innen ordnet das Template Identitätsfelder, Gesamtausgaben, Bestellanzahl, Tags und das Opt-in Brevo-Kontaktattributen zu, die du in Segmenten und Kampagnen nutzen kannst. Die genaue Zuordnung für deinen Workspace versteckt sich nicht in einer Beschreibung: Öffne die Sync-Regel und lies die Feldzuordnungstabelle. Diese Tabelle ist die verbindliche Antwort auf „Was wird synchronisiert?“.

Was Tajo heute nicht tut

Präzise Grenzen sind wichtiger als eine lange Feature-Liste:

Keine bidirektionalen Sync-Regeln. Eine Sync-Regel schreibt nur nach Brevo. Die eigenen Schreibvorgänge der Shopify-App nach Shopify (Opt-outs bei der Einwilligung, Metafelder für Brevo-Engagement und Treue, Treuestufen-Tags) sind in Shopify-Berechtigungen erklärt aufgelistet.
Keine Echtzeit-Sync-Regeln. Sync-Regeln laufen in Batches. Nur die Webhook-Synchronisierung der Tajo-Shopify-App arbeitet, sobald Events eintreffen.
Keine „Wieder verfügbar“-Schaltfläche. Die App hält den Produktbestand in Brevo aktuell und sendet ein back_in_stock-Event an Kund:innen, die benachrichtigt werden wollten. Die Anfrage muss aus deiner Storefront kommen: Die App fügt deinem Theme keine Schaltfläche „Notify me“ hinzu.

Blockiert eine dieser Grenzen einen Anwendungsfall für dich, sag es dem Team: Die Prioritäten im Early Access entstehen genau aus diesem Feedback.

Wo du deine Daten siehst

In Tajo: Öffne die Sync-Regel unter Connections > Syncs and mappings für Laufverlauf, Cursor-Position und die Zahlen pro Lauf. Activity hält Veröffentlichungen und automatische Pausen fest.
In Brevo: Öffne Kontakte und sieh dir die Attribute eines beliebigen Kontakts an, um zu bestätigen, dass die zugeordneten Felder befüllt werden. Baue auf diesen Attributen Segmente für dein Targeting.

Fehlerbehebung

Kontakte erscheinen nicht in Brevo: Prüfe den letzten Lauf der Regel auf Fehlschläge und ihren Status (eine pausierte Regel läuft nicht). Siehe Kontakte fehlen in Brevo.
Läufe schlagen wiederholt fehl: Der Circuit Breaker pausiert die Regel und zeigt den letzten Fehler. Siehe Daten werden nicht synchronisiert.
Doppelte Kontakte: Schreibvorgänge sind pro Quelldatensatz idempotent, aber bereits vorhandene Duplikate in Brevo bleiben bestehen. Siehe Doppelte Kontakte.

Häufige Fragen

Kann ich die Synchronisierung schneller machen? Die Seite einer aktiven Regel hat eine Schaltfläche Test run (1 batch). Für Änderungen, sobald sie passieren, deckt die Webhook-Synchronisierung der Tajo-Shopify-App bereits Kund:innen, Bestellungen, Checkouts, Produkte und Lagerbestände ab.

Was passiert, wenn ein Lauf auf halbem Weg fehlschlägt? Der Lauf meldet seine Fehlanzahl, der Cursor rückt nur über das Verarbeitete vor, und der nächste Lauf deckt die Lücke sicher erneut ab; Idempotenzschlüssel verhindern Duplikate.

Kann ich ändern, was synchronisiert wird? Ja. Bitte den Agenten, die Feldzuordnung oder den Filter der Regel zu ändern. Die Änderung setzt die Regel zurück in den Entwurf, und sie muss erneut durch Vorschau und Freigabe, bevor sie wieder läuft.

Warum hat sich meine Regel selbst pausiert? Mehrere fehlgeschlagene Läufe in Folge lösen den Circuit Breaker aus. Die Seite der Regel zeigt die Fehleranzahl und den letzten Fehler; behebe das Problem und veröffentliche neu.

Hilfe erhalten

Kontaktiere das Team.