Eigene Felder

Eigene Felder speichern zusätzliche Daten zu jedem Kontakt, etwa einen Firmennamen, einen Tarif oder einen Geburtstag. Sie definieren die Felder einmal für den Workspace, füllen sie dann bei den Kontakten aus und verwenden sie, um Kontakte zu filtern, Kampagnen zu personalisieren und Automatisierungen zu starten.

Feldtypen

Jedes Feld hat einen Namen, den die Weboberfläche anzeigt, und einen Schlüssel, den API, Importe, Filter und Platzhalter verwenden. Die Werte werden beim Kontakt als JSON-Objekt gespeichert, mit dem Feldschlüssel als Schlüssel:

{
  "company": "Acme",
  "plan": "pro",
  "birthday": "1990-04-12",
  "interests": ["news", "offers"]
}

Eigenes Feld erstellen

1. Custom fields öffnen. Öffnen Sie Workspace›Settings›Custom fields und wählen Sie Add custom field.

2. Feld benennen. Geben Sie einen Name ein, zum Beispiel Company size. Emailit bildet den Schlüssel automatisch aus dem Namen: in Kleinbuchstaben, wobei jede Folge anderer Zeichen durch _ ersetzt wird. Aus Company size wird so company_size.

   Um den Schlüssel selbst zu wählen, wählen Sie Show advanced options und bearbeiten Sie Key. Schlüssel werden immer in dieser Form mit Kleinbuchstaben und Unterstrichen gespeichert, und jeder Schlüssel darf pro Workspace nur einmal vorkommen.

3. Typ auswählen. Wählen Sie Text, Number, Date, Boolean, Select oder Multi select.

4. Optionen für Auswahlfelder hinzufügen. Geben Sie für Select und Multi select mindestens eine Option ein und fügen Sie mit Add option weitere hinzu. Diese Werte erscheinen im Dropdown bei den Kontakten.

5. Speichern. Wählen Sie Create. Das Feld erscheint bei jedem Kontakt, in den Kontaktfiltern und als Platzhalter in den Kampagnen-Editoren.

Die Seite Custom fields listet jedes Feld mit Name, Typ und Optionen auf. Mit Edit benennen Sie ein Feld um, ändern seinen Typ oder Schlüssel oder bearbeiten seine Optionen.

Werte setzen

Per API übergeben Sie custom_fields an Kontakt erstellen oder Kontakt aktualisieren:

curl https://api.emailit.com/v2/contacts/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_fields": {
      "company": "Acme",
      "plan": "pro",
      "birthday": "1990-04-12",
      "interests": ["news", "offers"]
    }
  }'

Wichtige Regeln:

• custom_fields ersetzt das gesamte Objekt. Geben Sie beim Aktualisieren jeden Wert an, den Sie behalten möchten, nicht nur die geänderten.
• Verwenden Sie Feldschlüssel, keine Namen. Werte für Schlüssel, die unter Custom fields nicht definiert sind, werden gespeichert, erscheinen aber nicht in der Weboberfläche.
• Datumsangaben müssen das Format YYYY-MM-DD haben. Emailit wandelt ISO-Datums- und Zeitangaben sowie Datumszellen aus Excel in ein Datum um. Alles andere gibt 400 mit „Custom field “Birthday” must be a date in YYYY-MM-DD format“ zurück. Datumsangaben haben keine Uhrzeit und keine Zeitzone.
• Auswahlwerte werden nicht gegen die Optionen geprüft. Ein Wert, der nicht in der Optionsliste steht, wird trotzdem gespeichert, und die Weboberfläche zeigt ihn weiterhin an.

Kontakte nach einem eigenen Feld filtern

Öffnen Sie in der Weboberfläche Email Marketing›Contacts, wählen Sie Filter und dann das eigene Feld anhand seines Namens. Filter für eigene Felder vergleichen den gespeicherten Wert als Text. Verwenden Sie daher equals, does not equal, contains, does not contain, starts with, ends with, is empty oder is not empty.

Per API verwenden Sie custom_fields.<key>.<condition> bei Kontakte auflisten und Kontakte exportieren, mit denselben Textbedingungen (exact, not_exact, contains, not_contains, starts_with, ends_with, empty, not_empty):

curl "https://api.emailit.com/v2/contacts?custom_fields.plan.exact=pro&custom_fields.company.contains=acme" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Für einen Bereich, etwa Geburtstage in den 1990er-Jahren, verwenden Sie die Parameter filter[custom_fields.<key>][gte] und [lte]. Sie vergleichen den gespeicherten Text, der bei Datumsangaben im Format YYYY-MM-DD richtig sortiert:

curl -G "https://api.emailit.com/v2/contacts" \
  --data-urlencode "filter[custom_fields.birthday][gte]=1990-01-01" \
  --data-urlencode "filter[custom_fields.birthday][lte]=1999-12-31" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Wie Filter kombiniert werden, erfahren Sie unter Filtern.

Eigene Felder in Kampagnen verwenden

Fügen Sie in Inhalte und Betreffzeilen von Kampagnen ein eigenes Feld mit dem Platzhalter {{cf.<key>}} ein, zum Beispiel {{cf.company}}. Der Rich-Text-Editor und Dragit listen Ihre eigenen Felder bei ihren Variablen auf, sodass Sie den Schlüssel nicht tippen müssen.

<p>Hi {{first_name}}, here's what's new for {{cf.company}}.</p>

Hat ein Kontakt keinen Wert, wird der Platzhalter durch nichts ersetzt. Werte von Mehrfachauswahlfeldern werden als kommagetrennte Liste ausgegeben. Siehe Platzhalter.

Eigene Felder in Automatisierungen verwenden

• Trigger Date anniversary. Wählen Sie ein Feld vom Typ Date, um jedes Jahr an dem darin gespeicherten Monat und Tag einen Durchlauf zu starten, etwa an einem Geburtstag. Siehe Trigger.
• Trigger Contact updated. Filtern Sie nach einem eigenen Feld oder nach seinem vorherigen Wert, um auf Änderungen zu reagieren.
• Schritt Condition. Verzweigen Sie anhand des Werts eines eigenen Felds.
• Schritt Edit contact. Setzen Sie ein eigenes Feld, indem Sie seinen Schlüssel eingeben.

API-Referenz

Die Definitionen eigener Felder werden nur in der Weboberfläche verwaltet. Die Werte von Kontakten verwenden das Objekt custom_fields der API für Kontakte, und dasselbe Objekt wird akzeptiert, wenn Sie einer Kontaktliste einen Abonnenten hinzufügen.

Siehe auch