E-Mail-Validierung

Dieser Referenzartikel behandelt die Validierungsregeln für den lokalen und den Host-Teil von E-Mail-Adressen. Die Validierung wird für Dashboard-E-Mail-Adressen, Endnutzer:innen-E-Mail-Adressen (Ihre Kund:innen) sowie für Absender- und Antwortadressen einer E-Mail-Nachricht verwendet.

Funktionsweise

Braze validiert eine E-Mail-Adresse, wenn sie aktualisiert, per API, CSV-Upload oder SDK importiert oder im Dashboard geändert wird. E-Mail-Adressen dürfen keine Leerzeichen enthalten. Wenn Sie die API verwenden, führen Leerzeichen zu einem 400-Fehler.

Braze lehnt bestimmte Zeichen ab und markiert die Adresse als ungültig. Wenn eine E-Mail einen Bounce verursacht, markiert Braze die Adresse als ungültig und ändert den Abo-Status nicht. Wenn der E-Mail-Text nicht standardmäßige ASCII-Zeichen enthält, versendet Braze die E-Mail nicht.

Diese Validierung ist eine Syntaxprüfung, kein Validierungsdienst. Ein Ziel dieses Prozesses ist es, internationale Zeichen (wie UTF-8) im lokalen Teil der E-Mail-Adresse zu unterstützen.

Braze prüft die Syntax sowohl des lokalen Teils als auch des Host-Teils einer E-Mail-Adresse. Der lokale Teil ist alles vor dem At-Zeichen (@), der Host-Teil alles danach. Der lokale Teil darf mit jedem zulässigen Zeichen beginnen und enden, außer mit einem Punkt (.). Dabei wird nicht geprüft, ob die Domain über einen gültigen MX-Server verfügt oder ob unter dieser Domain ein:e Nutzer:in existiert.

Wichtig

Wenn der Domain-Teil nicht standardmäßige ASCII-Zeichen enthält, muss er Punycode-kodiert werden, bevor er an Braze übermittelt wird.

Wenn Braze eine Anfrage erhält, eine:n Nutzer:in mit einer ungültigen E-Mail-Adresse hinzuzufügen, gibt die API einen Fehler zurück. Bei einem CSV-Upload legt Braze die:den Nutzer:in an, lässt die ungültige E-Mail-Adresse jedoch weg.

Validierungsregeln für den lokalen Teil

Allgemeine E-Mail-Validierung

Für die meisten Domains muss der lokale Teil die folgenden Parameter erfüllen:

• Darf beliebige Buchstaben und Zahlen enthalten, einschließlich Unicode-Buchstaben und -Zahlen, sowie die folgenden Zeichen: (+) (&) (#) (_) (-) (^) oder (/)
• Darf das folgende Zeichen enthalten, aber nicht damit beginnen oder enden: (.)
• Darf keine doppelten Anführungszeichen (“) enthalten
• Muss zwischen 1 und 64 Zeichen lang sein

Hinweis

Braze normalisiert E-Mail-Adressen, indem Großbuchstaben in Kleinbuchstaben umgewandelt und führende sowie nachgestellte Leerzeichen entfernt werden. Diese Normalisierung gilt, wenn E-Mail-Adressen über die API, einen CSV-Upload, das SDK oder das Dashboard erstellt oder aktualisiert werden.

Mit dem folgenden regulären Ausdruck können Sie prüfen, ob eine E-Mail-Adresse als gültig gilt:

1

/\A([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}])(([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~\.]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}])*([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}]))?\z/

Gmail-Adressen

Wenn der Domain-Teil Gmail ist, muss der lokale Teil mindestens zwei Zeichen lang sein und der weiter oben in diesem Abschnitt aufgeführten Validierung per regulärem Ausdruck entsprechen.

Microsoft-Domains

Wenn die Host-Domain „msn“, „hotmail“, „outlook“ oder „live“ enthält, verwendet Braze den folgenden regulären Ausdruck, um den lokalen Teil zu validieren: /\A\w[\-\w]*(?:\.[\-\w]+)*\z/i

Der lokale Teil einer Microsoft-Adresse muss die folgenden Parameter erfüllen:

• Darf mit einem Buchstaben (a-z), einem Unterstrich (_) oder einer Zahl (0-9) beginnen.
• Darf beliebige alphanumerische Zeichen (a-z oder 0-9) oder einen Unterstrich (_) enthalten
• Darf die folgenden Zeichen enthalten: (.) oder (-)
• Darf nicht mit einem Punkt (.) beginnen
• Darf nicht zwei oder mehr aufeinanderfolgende Punkte (.) enthalten
• Darf nicht mit einem Punkt (.) enden

Bei der Validierung wird geprüft, ob der lokale Teil vor dem „+“ dem regulären Ausdruck entspricht.

Validierungsregeln für den Host-Teil

Der Host-Teil darf keine IPv4- oder IPv6-Adresse sein. Die Top-Level-Domain (z. B. .com, .org, .net) darf nicht ausschließlich aus Ziffern bestehen.

Der folgende reguläre Ausdruck wird verwendet, um die Domain zu validieren:
/^[a-z\d](?:[a-z\d-]{0,61}[a-z\d])?(?:\.[a-z\d](?:[a-z\d-]{0,61}[a-z\d])?)+$/i

Der Domainname muss diese Parameter erfüllen:

• Besteht aus zwei oder mehr durch Punkte getrennten Labels
  • Jeder Teil eines Domainnamens wird als „Label“ bezeichnet. Der Domainname „example.com“ besteht beispielsweise aus dem Label „example“ und dem Label „com“.
• Muss mindestens einen Punkt (.) enthalten
• Darf keine zwei oder mehr aufeinanderfolgenden Punkte enthalten
• Jedes durch Punkte getrennte Label muss:
  • Nur alphanumerische Zeichen (a-z oder 0-9) und den Bindestrich (-) enthalten
  • Mit einem alphanumerischen Zeichen (a-z oder 0-9) beginnen
  • Mit einem alphanumerischen Zeichen (a-z oder 0-9) enden
  • 1 bis 63 Zeichen enthalten

Zusätzliche Validierung erforderlich

Das letzte Label der Domain muss eine gültige Top-Level-Domain (TLD) sein, die durch alles nach dem letzten Punkt (.) bestimmt wird. Diese TLD sollte in der TLD-Liste der ICANN aufgeführt sein. Der Braze-Validator prüft nur die Syntax. Tippfehler oder nicht existierende Adressen erkennt er nicht.

Wichtig

Unicode wird nur für den lokalen Teil der E-Mail-Adresse akzeptiert. Für den Domain-Teil wird Unicode nicht akzeptiert, er kann jedoch Punycode-kodiert sein.