Advocate-Teilnehmer im Bulk importieren

Advocate akzeptiert Importe, die in .csv oder .jsonl Dateiformaten eingereicht werden. Bitte beachten Sie unsere Beispiel-CSV-Importdatei und Beispiel-JSONL-Importdatei um die erforderliche Dateistruktur für Ihren Import einzusehen.

Hinweis: Wir empfehlen, dass jeder Import 500.000 Einträge nicht überschreitet.

Teilnehmer in großen Mengen importieren

1. Wählen Sie im linken Navigationsmenü [Engage] → Teilnehmer.

2. Wählen Sie Benutzer importieren.

3. Unter Importtypwählen Sie Benutzer.

4. Fügen Sie Ihre Importdatei hinzu, indem Sie Datei auswählen.

5. [Optional] Um die importierten Teilnehmer zu einem bestimmten Benutzersegment hinzuzufügen oder daraus zu entfernen, wählen Sie das Segment aus der Dropdown-Liste aus.

Hinweis: Diese Auswahl gilt für alle Teilnehmer, die in dieser Importdatei enthalten sind.

1. Wählen Sie Import starten.

Wenn der Import abgeschlossen ist, wird eine Bestätigungs-E-Mail gesendet. Importe können je nach Warteschlange und Dateigröße bis zu 30 Minuten dauern.

Felder

Massenimporte von Benutzern unterstützen sowohl Standardfelder als auch benutzerdefinierte Felder in der Upload-Datei. Felder sind Groß-/Kleinschreibungssensitiv.

Standardfelder

Standardfelder werden mit derselben Validierung wie unsere Open Endpoint User Upsert API-Aufruf:

Feld	Typ	Beschreibung
accountId (Erforderlich)	string	Die eindeutige Kennung des Kontos, zu dem dieser Teilnehmer gehört.
id (Erforderlich)	string	Die für diesen Teilnehmer angegebene eindeutige Kennung.
firstName	string	Der Vorname des Teilnehmers.
lastName	string	Der Nachname des Teilnehmers.
email	string	Die E-Mail-Adresse des Teilnehmers.
referable	boolean	Flag, das von impact.com verwendet wird, um zu bestimmen, ob ein Teilnehmer weiterempfohlen werden kann. Hinweis: Das Flag muss ausschließlich mit einem r geschrieben werden, damit der Status erfolgreich geändert werden kann.
locale	string	Die Locale des Teilnehmers, verwendet für Internationalisierung. Die Locale muss im Format language_COUNTRY sein, wobei der Sprachcode kleingeschrieben und der Ländercode großgeschrieben sein muss. Der Trenner muss ein Unterstrich sein.
countryCode	string	Die Locale des Teilnehmers, verwendet für Internationalisierung. Der Ländercode des Benutzers (z. B. CA).
referredBy.code	string	Der Referral-Code des Kundenadvokaten, der diesen Teilnehmer empfohlen hat.
referralCodes.{programId}	string	Der individuelle Referral-Code, den dieser Teilnehmer für das angegebene Programm teilen kann (wird automatisch generiert, wenn er nicht enthalten ist).
sharelinks.{programId}	string	Der individuelle Share-Link, den dieser Teilnehmer für das angegebene Programm teilen kann (wird automatisch generiert, wenn er nicht enthalten ist).
dateCreated	string	Das Datum, an dem dieser Teilnehmer in Ihrem Advocate-Programm erstellt wurde.
imageUrl	string	Optional in Widgets, E-Mails und Themes verwendet. Wenn Sie eine absolute Profilbild-URL angeben, beträgt die minimale Bildgröße 80px x 80px.
dateUsTaxFormSubmitted	integer	Das Datum, an dem das W-9-Steuerformular eines Teilnehmers als eingereicht markiert wurde. Wird für W-9-Compliance in Ihrem Mandanten verwendet, sofern konfiguriert.
customFields.{fieldName}	string	Verwenden Sie diese Struktur, um ein benutzerdefiniertes Feld nach Wahl einzuschließen.

Benutzerdefinierte Felder

Ergebnisse

Wir benachrichtigen Sie per E-Mail, wenn Ihr Import abgeschlossen ist. Sie können Importergebnisse von der [Engage] → Berichte → Importe & Exporte Seite innerhalb Ihres Advocate-Programms herunterladen.

Warnung: Download-Links verfallen nach 30 Tagen.

Erfolgreicher Upload

Wenn der Import erfolgreich abgeschlossen wird, wird eine Datei mit den Teilnehmerinformationen generiert und Ihnen per E-Mail zugesandt. Die in diesen Ergebnissen enthaltenen Informationen sind dieselben wie in unserem Benutzerdetailbericht.

Fehler