Zielgruppen & Kontakte

Saubere Listen, direkt eingebaut.

Eingerichtet in:

Speichere deine Kontakte einmal, eindeutig per E-Mail, und gruppiere sie in Zielgruppen, die du aus einem Broadcast ansprichst. Eine typisierte Property-Registry hält deine Daten sauber, und ein Batch-Upsert von 1.000 Zeilen bringt eine Liste schnell rein.

welcome.tsx

200 · 1.2s

import { BirdClient } from "@messagebird/sdk";
import { render } from "@react-email/render";
import { WelcomeEmail } from "./emails/welcome";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const { data, error } = await bird.email.send({
  from:    "Bird <hello@bird.com>",
  to:      ["ada@example.com"],
  subject: "Your invite is ready",
  html:    await render(<WelcomeEmail name="Ada" />),
}).safe();

if (error) throw error;
console.log(data.id);
// → "em_2bX91Yk8h..."

welcome.tsx

200 · 1.2s

import { BirdClient } from "@messagebird/sdk";
import { render } from "@react-email/render";
import { WelcomeEmail } from "./emails/welcome";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const { data, error } = await bird.email.send({
  from:    "Bird <hello@bird.com>",
  to:      ["ada@example.com"],
  subject: "Your invite is ready",
  html:    await render(<WelcomeEmail name="Ada" />),
}).safe();

if (error) throw error;
console.log(data.id);
// → "em_2bX91Yk8h..."

Ein Kontaktdatensatz. Attribute, die nicht abdriften.

Zielgruppen sind Teil der Bird Email API: Ein Kontakt ist eindeutig per E-Mail und wird über deine Zielgruppen hinweg geteilt, eine Zielgruppe ist einfach eine Menge dieser Kontakte, und Attribute leben immer am Kontakt, nicht kopiert auf jede Liste. Die Property-Registry sorgt dafür, dass ein vertipptes Feld beim Schreiben abgelehnt wird, statt erst in einer Kampagne aufzufallen.

Fünf Dinge, die deine Daten sauber halten.

Das Datenmodell übernimmt die Buchführung, damit deine Listen nicht verrotten.

01
Ein Datensatz pro Person.
Ein Kontakt pro E-Mail, mit Vor- und Nachname, einer externen ID und deinen eigenen benutzerdefinierten Daten.
02
Zielgruppen sind Zugehörigkeit.
Eine Zielgruppe ist eine Menge von Kontakten, die du frei hinzufügst und entfernst. Attribute leben immer am Kontakt, nie kopiert auf die Liste.
03
Typisierte Property-Registry.
Definiere deine benutzerdefinierten Felder vorab: string, number oder boolean, mit optionalen Fallbacks. Unbekannte Keys und falsch typisierte Werte werden beim Schreiben abgelehnt.
04
Batch-Upsert von bis zu 1.000.
Führe einen Upsert von bis zu 1.000 Kontakten in einem einzigen Aufruf durch und füge sie im selben Request einer Zielgruppe hinzu.
05
Exakter Match-Lookup.
Finde einen Kontakt per exaktem E-Mail-Match, damit deine eigenen Systeme synchronisieren können, ohne jeden Datensatz zu durchsuchen.

Bring eine ganze Liste mit einem Aufruf rein.

Upsert ist idempotent auf Basis der Identifikatoren jedes Eintrags – ein erneuter Import aktualisiert vorhandene Kontakte, statt Duplikate zu erzeugen. Fügen Sie bis zu 1.000 Kontakte hinzu und ordnen Sie sie in derselben Anfrage einer Audience zu – ohne separaten Mitgliedschafts-Schritt und ohne nachträgliche Deduplizierung. Größere Listen werden in Batches von 1.000 hochgeladen. Jeder Aufruf ist unabhängig, sodass ein unterbrochener Import sicher an der Stelle fortgesetzt werden kann, an der er gestoppt wurde.

import.ts

202

// Upsert up to 1,000 contacts and add them to an audience at once.
const result = await bird.contacts.batch({
  audience_ids: ["adn_01krdgeqcxet5s7t44vh8rt9mg"],
  contacts: [
    { email: "ada@example.com",   first_name: "Ada",   data: { plan: "growth" } },
    { email: "grace@example.com", first_name: "Grace", data: { plan: "free" } },
  ],
});

// Per-contact results come back in submission order.
for (const item of result.data) {
  console.log(item.email, item.status);
}

Felder, die nicht abdriften können.

Benutzerdefinierte Kontaktdaten laufen durch eine typisierte Registry. Deklariere jedes Feld einmal als string, number oder boolean, mit einem optionalen Fallback, und ein vertippter Key oder falsch typisierter Wert wird in dem Moment abgelehnt, in dem du ihn schreibst, statt mitten in einer Kampagne aufzufallen. Weil Attribute am Kontakt leben, nicht an der Liste, hinterlässt das Verschieben einer Person zwischen Zielgruppen nie eine veraltete Kopie.

Funktioniert mit dem Rest von Email.

Sprich die Zielgruppen, die du hier aufbaust, aus einem Broadcast an, und dieselben Kontakte erhalten transaktionale Mail über die Send-API.

Der Rest der Email-Plattform

Eine API, ein Satz Keys. Entdecke die weiteren Funktionen.

SendenTransaktionale und Marketing-E-Mails, Templates und Batch-Sends.TemplatesGespeicherte, versionierte E-Mail-Templates, beim Versand pro Empfänger personalisiert.BroadcastsMarketing-Kampagnen: entwerfen, eine Zielgruppe ansprechen, planen und senden.ZustellbarkeitAuthentifizierung, IP-Warmup, Suppression und Blocklist-Monitoring.AnalyticsZustell- und Engagement-Metriken pro Domain, pro ISP, pro IP.Dedizierte IPsVerwaltete dedizierte IPs und Pools, automatisch aufgewärmt.Sending-DomainsDomain-Verifizierung, DKIM/SPF/DMARC-Signierung und DMARC-Monitoring.SuppressionsAutomatische, reversible Suppression von Bounces, Beschwerden und Abmeldungen.Email API – ÜberblickDie komplette Email API: Senden, Zustellbarkeit, IPs, Suppression, Analytics und Broadcasts.

Rund 40 % der kommerziellen E-Mails weltweit laufen bereits über Bird.

Transaktionale und Marketing-E-Mails auf einer Infrastruktur, die wir seit einem Jahrzehnt betreiben. Zielgruppen sind eine Funktion der Bird Email API: Senden, Broadcasts, Zustellbarkeit, Suppression und Analytics sind direkt mit dabei.

Entdecke die Email-Plattform Loslegen