Brevo Kontakt-Sync
LIKE MAGIC kann deine Gastprofile als Kontakte in dein eigenes Brevo-Konto pushen. Jeder Kontakt trägt die Kontaktdaten des Gastes, seine Kommunikationspräferenzen und eine Reihe von Aufenthalts- und Umsatzattributen. So baust du Segmente und Kampagnen in Brevo auf echtem Aufenthaltsverhalten auf statt auf einer exportierten Liste.
Der Sync läuft in eine Richtung: LIKE MAGIC schreibt nach Brevo. Änderungen, die du direkt in Brevo an einem Kontakt machst, werden nie ins Gastprofil zurückgelesen, und ein späterer Push aus LIKE MAGIC überschreibt die Attribute, die er mitsendet.
Dieser Referenzartikel richtet sich an die Person, die das Marketing in Brevo verantwortet. Er beschreibt genau, wann ein Kontakt gepusht wird und was jeder Push enthält.
1. Was die Integration macht
Sobald bei einem Gast in LIKE MAGIC etwas Relevantes passiert, baut die Plattform das aktuelle Profil des Gastes und sendet es als Kontakt an Brevo. Existiert der Kontakt noch nicht, wird er angelegt, sonst aktualisiert.
Gesendet wird immer das aktuelle, vollständige Bild des Gastes, nicht nur der geänderte Teil. Ein Gast, der mit seinem vierten Aufenthalt auscheckt, kommt im selben Push mit neu berechneten Durchschnittswerten, Übernachtungen und Umsatzsummen in Brevo an.
ℹ️ Dies ist eine eingebaute Integration speziell für Brevo. Willst du ein anderes CRM befüllen, ist das eine eigene Anbindung über Webhooks & Events und den Event & Data Hub.
2. Bevor du startest
🧩 Die Integration wird pro Account von LIKE MAGIC aktiviert. Beantrage die Aktivierung über eine Support Anfrage.
Was du mitbringst:
- Ein Brevo-Konto, mit einem Tarif, der dein erwartetes Kontaktvolumen abdeckt.
- Einen Brevo API Key, den du in deinem Brevo-Konto erstellst und mit der Aktivierungsanfrage übergibst. LIKE MAGIC schreibt damit Kontakte in dein Konto. Behandle ihn wie ein Zugangsdatum und übermittle ihn so, wie es deine Support Anfrage vorgibt, nicht in einer offenen Nachricht.
- Die in Brevo angelegten benutzerdefinierten Attribute. Brevo speichert ein Attribut nur, wenn es im Konto bereits existiert, mit passendem Namen und kompatiblem Typ. Lege die Attribute aus Abschnitt 4 vor dem ersten Push an, sonst kommen die Kontakte ohne diese Werte an.
💡 Frage zusammen mit der Aktivierung einen einmaligen Initial Load an. Er geht deine bestehenden Gastprofile durch und legt sie in Brevo an. So startest du mit deiner vollen Kontaktbasis statt nur mit den Gästen, die als Nächste reisen.
3. Wann ein Kontakt gepusht wird
Ein Push passiert bei diesen Ereignissen, und nur bei diesen:
| Ereignis | Bedeutung |
|---|---|
| Profil erstellt | Ein neues Gastprofil entsteht. |
| Profil aktualisiert | Gastdaten ändern sich, zum Beispiel über den Pre-Check-in, den Gastzugang oder eine Bearbeitung durch Mitarbeiter. |
| Reservierung eingecheckt | Der Gast reist an. |
| Reservierung ausgecheckt | Der Gast reist ab. Aufenthaltssummen und Durchschnittswerte werden vor dem Push neu berechnet. |
| Reservierung No-Show | Die Reservierung wird als No-Show markiert. |
| Reservierung storniert | Die Reservierung wird storniert. |
⚠️ Eine neue Buchung allein pusht den Kontakt nicht. Beim Anlegen einer Reservierung passiert kein Push. Ein Erstgast, der heute bucht, erreicht Brevo, wenn sein Profil erstellt oder aktualisiert wird, spätestens beim Check-in, nicht im Moment der Buchung.
4. Was gepusht wird
Jeder Push sendet die folgenden Attribute. Ein Attribut, für das das Gastprofil keinen Wert hat, wird weggelassen statt leer gesendet. Ein bereits in Brevo vorhandener Wert bleibt dadurch bestehen.
a) Identität und Kontaktdaten
| Brevo-Attribut | Inhalt |
|---|---|
EXT_ID | Die Kennung des Gastes in LIKE MAGIC. Über Aufenthalte hinweg stabil und der verlässliche Schlüssel, wenn du Brevo-Daten zurück auf LIKE MAGIC beziehst. |
email | E-Mail-Adresse. Zugleich der Schlüssel, über den Brevo zuordnet, siehe Abschnitt 5. |
FIRSTNAME, VORNAME | Vorname, in beide Attribute geschrieben. |
LASTNAME, NACHNAME | Nachname, in beide Attribute geschrieben. |
GENDER | Geschlecht gemäss Profil. |
BIRTHDATE | Geburtsdatum. |
NATIONALITY | Nationalität als Ländercode. |
LANGUAGE | Bevorzugte Sprache als Sprachcode. Damit wählst du die Sprache einer Kampagne. |
ADDRESS_1, ADDRESS_2 | Strassenadresse, erste und zweite Zeile. |
POSTAL_CODE, CITY, COUNTRY | Postleitzahl, Ort und Ländercode. |
SMS, WHATSAPP | Mobilnummer, in beide Attribute geschrieben. |
ℹ️ Die Mobilnummer wird nur gesendet, wenn sie zu genau einem Gastprofil gehört. Brevo verlangt, dass eine Telefonnummer über alle Kontakte hinweg eindeutig ist. Eine Nummer, die auf mehreren Profilen liegt (eine Familienbuchung unter einer Nummer), wird deshalb weggelassen und der Kontakt ohne sie geschrieben.
b) Einwilligung und Konto
| Brevo-Attribut | Inhalt |
|---|---|
OPT_IN | Ob der Gast der Marketingkommunikation zugestimmt hat. |
DOUBLE_OPT-IN | Yes oder No, ob der Gast diese Zustimmung über den Bestätigungsschritt bestätigt hat. |
HAS_ACCOUNT | Ob der Gast einen Gast Benutzer Account hat. |
COMMUNICATION_CHANNEL | Der Kanal, über den der Gast bevorzugt kontaktiert wird. |
c) Aufenthaltsverhalten
| Brevo-Attribut | Inhalt |
|---|---|
FIRST_RESERVATION_CREATED | Datum der ersten Reservierung des Gastes. |
LAST_RESERVATION_DEPARTURE | Abreisedatum des jüngsten Aufenthalts. |
AMOUNT_RESERVATIONS_CHECKEDOUT | Anzahl der Reservierungen, die der Gast tatsächlich abgeschlossen hat. |
ROOM_NIGHTS | Gesamtzahl der Übernachtungen über alle Aufenthalte. |
AVERAGE_LENGTH_OF_STAY | Durchschnittliche Nächte pro Aufenthalt. |
AVERAGE_AMOUNT_OF_GUESTS_PER_STAY | Durchschnittliche Anzahl Gäste pro Aufenthalt. |
AVERAGE_RESERVATION_LEAD_TIME | Durchschnittliche Tage zwischen Buchung und Anreise. |
MOST_USED_PROPERTY, LAST_PROPERTY | Die am häufigsten gebuchte Property und die zuletzt gebuchte. |
MOST_USED_CHANNEL, LAST_CHANNEL | Der am häufigsten genutzte Buchungskanal und der zuletzt genutzte. Damit trennst du Direktbucher von OTA-Gästen. |
MOST_USED_CHECKIN_METHOD, LAST_CHECKIN_METHOD | Wie der Gast üblicherweise eincheckt und wie beim letzten Mal. |
MOST_USED_CHECKOUT_METHOD, LAST_CHECKOUT_METHOD | Wie der Gast üblicherweise auscheckt und wie beim letzten Mal. |
d) Wert und Umsatz
Alle Beträge beziehen sich auf abgeschlossene Aufenthalte und enthalten sämtliche Leistungen auf dem Folio (Übernachtung, Leistungen und Steuern).
| Brevo-Attribut | Inhalt |
|---|---|
SUM_RESERVATIONS_PRICE | Gesamtumsatz des Gastes über alle abgeschlossenen Aufenthalte. |
AVERAGE_SPEND_PER_STAY | Durchschnittlicher Umsatz pro abgeschlossenem Aufenthalt. |
AVERAGE_DAILY_RATE | Durchschnittlicher Preis pro Nacht, Gesamtumsatz geteilt durch Übernachtungen. |
AVERAGE_CANCELLATION_RATE | Anteil der Reservierungen des Gastes, die storniert wurden. |
AVERAGE_NOSHOW_RATE | Anteil der Reservierungen des Gastes, die als No-Show endeten. |
5. Wie Kontakte zugeordnet werden
Brevo identifiziert einen Kontakt über die E-Mail-Adresse. Jeder Push legt entweder einen Kontakt unter dieser Adresse an oder aktualisiert den bestehenden. Ein wiederkehrender Gast erzeugt also keinen zweiten Kontakt.
Zwei Konsequenzen, die du einplanen solltest:
- Ein Gastprofil ohne E-Mail-Adresse bietet Brevo nichts zum Zuordnen und wird nicht zum Kontakt.
- Ein Gast, der unter zwei verschiedenen E-Mail-Adressen bucht, wird zu zwei Kontakten.
EXT_IDzeigt dir weiterhin, dass es dieselbe Person in LIKE MAGIC ist. Segmentiere oder bereinige also überEXT_ID, wo das eine Rolle spielt.
6. Marketing-Einwilligung
⚠️ Der Push selbst filtert nicht nach Einwilligung. Ein Gastprofil wird an Brevo gesendet, unabhängig davon, ob der Gast zugestimmt hat. Der Stand der Einwilligung reist in den Attributen OPT_IN und DOUBLE_OPT-IN mit. Wer tatsächlich eine Marketingnachricht erhalten darf, entscheidest du auf deiner Seite in Brevo.
Bevor du eine Kampagne versendest, baue deine Liste aus einem Brevo-Segment, das auf OPT_IN filtert (und auf DOUBLE_OPT-IN, wo dein Markt eine bestätigte Einwilligung verlangt). Ein Versand an die gesamte Kontaktliste erreicht Gäste, die nie zugestimmt haben.
💡 Richte diese Segmente einmal direkt nach der Aktivierung ein und nutze sie als Basis für jede Kampagne, statt pro Versand zu filtern.
7. Fehlerbehebung
| Was du siehst | Was du prüfst |
|---|---|
| Ein Gast fehlt in Brevo komplett | Das Profil hat keine E-Mail-Adresse (Abschnitt 5), oder bei diesem Gast ist noch nichts passiert, was einen Push auslöst (Abschnitt 3). Die Einwilligung ist nicht der Grund, Kontakte werden unabhängig vom Opt-in gepusht. |
| Gäste von vor der Aktivierung fehlen | Der Initial Load wurde nicht ausgeführt. Fordere ihn über eine Support Anfrage an. |
| Ein Attribut bleibt auf jedem Kontakt leer | Das benutzerdefinierte Attribut existiert in Brevo noch nicht, oder Name oder Typ passen nicht. Lege es wie in Abschnitt 2 beschrieben an und löse einen neuen Push aus, indem sich die Gastdaten ändern. |
SMS und WHATSAPP sind leer, obwohl das Profil eine Nummer hat | Die Nummer wird auf mehr als einem Gastprofil verwendet und deshalb weggelassen. |
| Der Kontakt hat sich nach einer neuen Buchung nicht aktualisiert | Das Anlegen einer Reservierung löst keinen Push aus. Der Kontakt aktualisiert sich beim Check-in, Check-out, bei einer Stornierung, einem No-Show oder der nächsten Profiländerung. |
| Aufenthaltssummen wirken einen Aufenthalt hinterher | Die Summen werden beim Check-out neu berechnet. Ein noch nicht ausgecheckter Aufenthalt zählt nicht mit. |
| Adressen mit einer bestimmten Domain kommen nie an | E-Mail-Domains, die dein Account als ungültig behandelt, typischerweise OTA-Aliasadressen, werden übersprungen statt gepusht. |
8. Fazit
Sobald Brevo angebunden ist, hält sich deine Kontaktbasis selbst aktuell: Jede Anreise, jede Abreise und jede Profiländerung frischt die Attribute des Gastes auf, und deine Segmente ziehen ohne Export mit. Zwei Dinge solltest du vorab richtig aufsetzen: die benutzerdefinierten Attribute in Brevo, damit die Daten irgendwo landen, und deine Einwilligungs-Segmente, damit Kampagnen nur Gäste erreichen, die zugestimmt haben.
Weiterführend:
- Event & Data Hub: das Event-Rückgrat, auf dem diese Integration läuft.
- Webhooks & Events: dein eigenes System auf dieselben Ereignisse abonnieren, um ein anderes CRM zu befüllen.
- Gastkonto & Loyalty: wie Gäste über Aufenthalte hinweg identifizierbar werden, was die Aufenthaltsattribute erst aussagekräftig macht.