# Benutzerdefinierte Felder für Advocate erklärt

Sie können *benutzerdefinierten Feldern* verwenden, um impact.com zusätzliche Daten über Teilnehmer Ihres Empfehlungsprogramms zu senden. Diese Informationen können in Ihren [Programmbestimmungen](https://help.impact.com/brand/de/woruber-mochten-sie-mehr-erfahren/advocate-program/getting-started-with-advocate/advocate-program-rules-explained) verwendet werden, um zu bestimmen, wann Ziele und Aktionen ausgelöst werden. Sie können Ihre Teilnehmer auch anhand von benutzerdefinierten Feldwerten segmentieren.

Die Arten von benutzerdefinierten Feldern, die Sie senden, sind flexibel. Beispielsweise möchten Sie Informationen über einen Teilnehmer wie:

* Geburtstag
* Sprache
* Standort
* Abonnementtyp
* Mitgliedsstatus

Benutzerdefinierte Felder können an impact.com gesendet werden, wenn Sie eine Benutzer-Importdatei hochladen oder über UTT, API, SDK oder eine andere Integrationsmethode.

#### Feldeigenschaften

Alle benutzerdefinierten Felder, die Sie senden, müssen einige Anforderungen für Feldnamen und -werte erfüllen.

{% tabs %}
{% tab title="Namen" %}

* Bis zu 64 Zeichen.
* Es sind nur alphanumerische Zeichen, Bindestriche und Unterstriche zulässig (Buchstaben müssen unakzentuiert sein).
* Groß-/Kleinschreibung beachtet, z. B. `customFieldName` wird unterschieden von `customfieldname`.
  {% endtab %}

{% tab title="Werte" %}

* Unterstützt `String`, `Nummer`, `Boolean`, und `null-Typen`.
* Maximale Zeichenlänge für Strings: 1024 Zeichen.
* Datumsangaben müssen als UNIX-Zeitstempel in Millisekunden formatiert sein.
* Maximal 100 Felder können pro Anfrage hinzugefügt/aktualisiert werden.
* Wenn ein benutzerdefiniertes Feld für einen Benutzer auf `null` gesetzt wird, wird das Feld für diesen Benutzer entfernt.
  {% endtab %}
  {% endtabs %}

#### Senden Sie Informationen zu benutzerdefinierten Feldern an impact.com

Sie können benutzerdefinierte Felder einschließen, wann immer Sie Benutzer erstellen, aktualisieren oder upserten, unabhängig von der Methode, mit der Sie die Daten senden.

{% tabs %}
{% tab title="Dateiimporte" %}
Sie können benutzerdefinierte Felder beim Import neuer Benutzer oder beim Massen-Update vorhandener Benutzer einbeziehen. Siehe [Advocates in großen Mengen importieren](https://help.impact.com/brand/de/woruber-mochten-sie-mehr-erfahren/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk) für Anweisungen.

Im Folgenden finden Sie zwei Beispiel-Dateien, die Sie für Ihren Import verwenden können.

* Benutzerdaten-Importe: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) oder [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
* Ereignisdaten-Importe: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/20lD8Gua3EtW8qIahBvciz/152fd3cfaa3f0ee4076a6729bc8d4164/userEventSample.csv) ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) oder [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/2IPDDkVhCgDBPyQrRANfb9/d38643fba660ca1412b7d85f1b7c0f41/userEventSample.jsonl) ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
  {% endtab %}

{% tab title="APIs und SDKs" %}
Benutzerdefinierte Felder können beim Verwenden der impact.com- [GraphQL-Methoden](https://integrations.impact.com/impact-brand/docs/graphql-reference) oder [REST-API-Endpunkte](https://integrations.impact.com/impact-brand/docs/saasquatch-rest-api-1) eingeschlossen werden, die Benutzer erstellen, aktualisieren oder upserten. Sie können auch eingeschlossen werden, wenn Sie [UTT](https://integrations.impact.com/impact-brand/docs/install-the-utt) oder unsere [mobilen Optionen](https://integrations.impact.com/impact-brand/docs/saasquatch-mobile-overview-1) verwenden, um Benutzer aus Ihrer Anwendung zu erstellen, zu aktualisieren oder upzudaten.
{% endtab %}
{% endtabs %}
