Dokumentationsmenü

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}}).

Video auf Englisch

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.

Aus einem Google Sheet. Tabelle importieren → Google-Sheets-Link liest einen Tab eines Sheets, das für „Jeder mit dem Link kann ansehen“ freigegeben ist (die #gid im Link wählt den Tab). MailInApp merkt sich den Link: Nachdem Sie das Sheet geändert haben, ersetzt Jetzt synchronisieren an der Tabelle ihre Spalten und Zeilen durch die des Sheets. Eine Synchronisierung, die das Sheet nicht lesen kann, ändert nichts. Diagramme und Merge-Tags lesen die Tabelle, wenn eine E-Mail gerendert wird, also synchronisieren Sie vor dem Senden.

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.

Geben Sie unter Datenpfad an, wo das Array der Datensätze in der Antwort liegt (records, data.items, properties.periods); lassen Sie ihn leer, wenn die Antwort selbst das Array ist. Jeder Datensatz wird zu einer Zeile, jeder seiner Werte zu einem Feld. Ein verschachteltes Objekt wird zu Feldern mit Punkt: {"address": {"city": "Lyon"}} ergibt das Feld address.city, geschrieben {{alias.address.city}} (bis zu drei Ebenen; Arrays innerhalb eines Datensatzes werden übersprungen). Diese Einstellungen testen zeigt die ersten Zeilen so, wie Ihre Merge-Tags sie sehen.

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.

In einer Wiederholung können die Anzeigebedingungen eines Blocks auch die Felder der Zeile prüfen: Sie stehen in der Feldauswahl ganz oben, unter Jede Zeile von orders. Ein Hinweis mit StageName ist gleich Negotiation erscheint dann nur in den Zeilen dieser Phase.

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.