Datenquellen & Merge-Tags

Merge-Tags lassen Sie jede E-Mail mit echten Daten personalisieren. Schreiben Sie {{field}} an beliebiger Stelle in einen Text-Block — Hi {{first_name}}, dein {{plan}} wird bald verlängert — und jeder Empfänger sieht seine eigenen Werte. Ein Projekt kann mehrere Datenquellen gleichzeitig verbinden: Jede erhält einen kurzen Alias, und Felder aus einer Nicht-Zielgruppen-Quelle werden als {{alias.field}} geschrieben (zum Beispiel {{products.name}}).

Arten von Datenquellen

Datenquellen werden im Bereich Data Sources Ihres Dashboards verwaltet (Kontaktlisten befinden sich unter Contacts). Es gibt zwei Arten:

Gehostete Tabellen

Eine in MailInApp gespeicherte Tabelle. Definieren Sie Spalten, fügen Sie im Dashboard Zeilen hinzu, und jede Spalte wird zu einem Merge-Feld. Am besten geeignet, wenn Ihre Daten heute in einer Tabellenkalkulation liegen. Kontaktlisten sind gehostete Tabellen mit einer garantierten email-Spalte.

API-Verbindungen

Verweisen Sie MailInApp auf Ihren eigenen HTTP-Endpunkt, der JSON zurückgibt. Zeilen werden serverseitig abgerufen — von unseren Servern, niemals aus dem Posteingang des Empfängers oder den Browsern Ihrer Besucher.

Drei Möglichkeiten, die Verbindung zu authentifizieren, ausgewählt über das Dropdown Authentication bei der Konfiguration:

• Statische Header — fügen Sie Request-Header (zum Beispiel einen Authorization-Header) mit einem festen Wert hinzu. Die einfachste Option, und die einzige, die sinnvoll war, bevor ein Token ablaufen konnte.
• OAuth2 Client Credentials — eine Token-URL plus eine Client-ID und ein Secret. MailInApp tauscht diese serverseitig gegen ein Access Token, cacht es und erneuert es automatisch, bevor es abläuft — das gängige Muster für die meisten Enterprise-Integrationen mit API-Schlüssel und Secret.
• OAuth2 JWT Bearer — eine Token-URL, Issuer, Subject, Audience und ein privater RSA-Schlüssel (PEM). MailInApp signiert eine frische JWT-Assertion und tauscht sie gegen ein Access Token — ohne interaktiven Login und ohne Refresh Token, um das Sie sich kümmern müssten. So authentifizieren sich Salesforces Server-zu-Server-Integrationen (siehe den Salesforce-Integrationsleitfaden), und es funktioniert genauso für ein Google-Dienstkonto oder jeden anderen IdP, der diesen Ablauf unterstützt.

Unabhängig vom gewählten Modus wird das resultierende Bearer-Token automatisch als Authorization-Header eingefügt — jeder zusätzliche Header, den Sie hinzufügen, wird trotzdem mitgesendet und zusammengeführt (ein Header, der dort buchstäblich Authorization heißt, wird ignoriert, da das geprägte Token immer gewinnt). Alle Zugangsdaten-Felder — Header-Werte, Client-Secret, privater Schlüssel — folgen derselben Regel:

• ausschließlich serverseitig gespeichert,
• niemals an den Browser gesendet,
• in jeder API-Antwort maskiert, nachdem Sie sie gespeichert haben.

Beim Bearbeiten einer Verbindung, deren Secret maskiert angezeigt wird, muss vor einem Klick auf Test these settings der echte Wert erneut eingegeben werden; Test saved connection führt die Prüfung stattdessen genau mit dem gespeicherten Zugangsdatensatz aus, ohne ihn jemals an Ihren Browser zurückzusenden.

Quellen verbinden: das Data-Panel

Das Data-Panel des Studios ist der Ort, an dem ein Projekt festlegt, welche Quellen es verwendet. + Add data source… verbindet eine (bis zu 10 pro Projekt); jede Verbindung besteht aus drei Teilen:

• Alias — das kurze Kürzel, das ihre Merge-Tags verwenden: Kleinbuchstaben, Ziffern und Unterstriche, beginnend mit einem Buchstaben (z. B. contacts, products, open_invoices). Das Umbenennen eines Alias aktualisiert automatisch jeden Repeat-Block, der daran gebunden ist.
• Source — die gehostete Tabelle, Kontaktliste oder API-Verbindung dahinter.
• Role — wie die E-Mail sie nutzt:
  • Audience — die Kontaktliste, an die die E-Mail gesendet wird. Höchstens eine pro Projekt, und sie muss eine Kontaktliste sein. Ihre Felder sind die nackten Tags — {{first_name}}, {{email}} — die zum Sendezeitpunkt pro Empfänger aus dessen eigener Zeile aufgelöst werden. Die Zielgruppe steuert außerdem die „Als"-Vorschau-Auswahl und die Zuordnung von Antworten pro Empfänger.
  • Merge fields — Felder, die unter dem Alias lesbar sind: {{alias.field}}, aufgelöst aus der ersten Zeile der Quelle, wenn die E-Mail gerendert wird. Verwenden Sie dies für gemeinsame Inhalte — das vorgestellte Produkt, die Statistiken dieser Woche — statt für Daten pro Empfänger.
  • Repeat rows — Zeilen, die Repeat-Blöcke speisen, die an den Alias gebunden sind. Trägt außerhalb des Repeats keine Merge-Felder bei. Dieselbe collection-Rolle speist auch KPI-, Balken-, Linien- und Kreisdiagramm-Blöcke — siehe Diagramme an echte Daten binden.

Jede verbundene Quelle listet ihre Felder als anklickbare Chips auf — klicken Sie eines an, um den exakten Merge-Tag zu kopieren, und fügen Sie ihn in eine beliebige Texteigenschaft ein. Editoren für Anzeigebedingungen gruppieren ihr Feld-Dropdown auf dieselbe Weise: Empfänger-(Audience-)Felder plus eine Gruppe pro Merge-Quelle.

Integrierte Tags

Eine Handvoll Tags wird von der Plattform selbst bereitgestellt statt von einer Datenquelle — das Variables-Panel in der linken Leiste des Studios listet sie neben allen von Ihnen definierten Variablen auf; klicken Sie eines an, um seinen Tag zu kopieren.

• {{recipient_email}} — die Adresse, an die die E-Mail gesendet wird.
• {{today}} / {{now}} — das Datum (bzw. Datum & Uhrzeit), zu dem die E-Mail geöffnet wird.
• {{unsubscribe_url}} — ein Ein-Klick-Abmeldelink pro Empfänger. Die Footer-Vorlage enthält ihn bereits — siehe Versand an Ihre Kontakte.

Ein einmaliger Store-Rabattcode pro Empfänger ist kein Merge-Tag — legen Sie stattdessen den Block E-Commerce-Rabatt (nur für mit Shopify/WooCommerce verbundene Zielgruppen) in die E-Mail, und er prägt und zeigt automatisch seinen eigenen Code an. Siehe Rabattangebot.

Integrierte Tags werden nur bei echten Sendungen aufgelöst (manuell, geplant oder ein Testversand im „Backfill"-Stil) — die Studio-Vorschau und die Arbeitsfläche zeigen sie leer oder als Platzhalter an, genau wie jedes Feld ohne Beispielwert.

Wiederkehrende Inhalte

Der Repeat-Block rendert seine untergeordneten Elemente einmal pro Zeile der Quelle, an die Sie ihn binden — ein Produktraster, eine Zusammenfassung von Artikeln, eine Liste offener Rechnungen. Wählen Sie die Quelle über den Alias im Inspektor; innerhalb des Repeats werden Tags gegen die eigene Zeile jeder Wiederholung aufgelöst.

Vorschau mit echten Daten

Die Vorschau-Daten-Auswahl des Studios rendert die Arbeitsfläche mit einer beliebigen Zeile der Zielgruppenliste, sodass Sie prüfen können, dass {{first_name}} tatsächlich Amina sagt und nicht {{first_name}}, bevor Sie senden. Auch Feldern aus anderen Quellen können Vorschauwerte zugewiesen werden.

Gut zu wissen

• Felder, die für einen Empfänger fehlen, werden als leere Zeichenketten gerendert — gestalten Sie so, dass ein leerer Wert immer noch natürlich wirkt.
• Gehostete Seiten (Live-Ansicht, gehostete Formulare) lösen Merge-Tags pro Empfänger zum Render-Zeitpunkt auf, sodass die Personalisierung erhalten bleibt, selbst wenn ein Empfänger den Posteingang verlässt.
• Projekte, die vor der Unterstützung mehrerer Quellen erstellt wurden, funktionieren unverändert weiter: Ihre einzelne verbundene Quelle erscheint automatisch im Data-Panel, und nackte {{field}}-Tags lösen sich stets gegen die Zielgruppe auf.