Advocate-Teilnehmer in großen Mengen importieren

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

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

Teilnehmer massenweise importieren

1. Wählen Sie im linken Navigationsmenü [Engage] → Teilnehmer.
2. Wählen Sie Benutzer importieren.
3. Unter Importtyp, wählen Sie Nutzer.
4. Fügen Sie Ihre Importdatei hinzu, indem Sie auswählen 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 in dieser Importdatei enthaltenen Teilnehmer.

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 unterscheiden zwischen Groß- und Kleinschreibung.

Standardfelder

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

Feld	Typ	Beschreibung
accountId (Erforderlich)	Zeichenkette	Die eindeutige Kennung des Kontos, zu dem dieser Teilnehmer gehört.
id (Erforderlich)	Zeichenkette	Die für diesen Teilnehmer bereitgestellte eindeutige Kennung.
Vorname	Zeichenkette	Der Vorname des Teilnehmers.
Nachname	Zeichenkette	Der Nachname des Teilnehmers.
E-Mail	Zeichenkette	Die E-Mail-Adresse des Teilnehmers.
empfehlbar	boolesch	Von impact.com verwendetes Flag, um festzustellen, ob ein Teilnehmer weiterempfohlen werden kann. Hinweis: Das Flag darf nur mit einem r geschrieben werden, damit der Status erfolgreich geändert werden kann.
Gebietsschema	Zeichenkette	Das Gebietsschema des Teilnehmers, verwendet für Internationalisierung. Das Gebietsschema muss das Format Sprache_LAND haben, wobei der Sprachcode kleingeschrieben und der Ländercode großgeschrieben sein muss. Das Trennzeichen muss ein Unterstrich sein.
countryCode	Zeichenkette	Das Gebietsschema des Teilnehmers, verwendet für Internationalisierung. Der Ländercode des Benutzers (z. B. CA).
referredBy.code	Zeichenkette	Der Empfehlungscode des Kundenfürsprechers, der diesen Teilnehmer geworben hat.
referralCodes.{programId}	Zeichenkette	Der benutzerdefinierte Empfehlungscode für diesen Teilnehmer zum Teilen für das angegebene Programm (wird automatisch generiert, falls nicht enthalten).
sharelinks.{programId}	Zeichenkette	Der benutzerdefinierte Freigabelink für diesen Teilnehmer zum Teilen für das angegebene Programm (wird automatisch generiert, falls nicht enthalten).
Erstellungsdatum	Zeichenkette	Das Datum, an dem dieser Teilnehmer in Ihrem Advocate-Programm erstellt wurde.
Bild-URL	Zeichenkette	Optional in Widgets, E-Mails und Themes verwendet. Wenn Sie eine absolute Profilbild-URL angeben, beträgt die minimale Bildgröße 80 px x 80 px.
Datum der Einreichung des US-Steuerformulars	Ganzzahl	Das Datum, an dem das W-9-Steuerformular eines Teilnehmers als eingegangen markiert wurde. Wird für die W-9-Compliance in Ihrem Mandanten verwendet, sofern konfiguriert.
customFields.{fieldName}	Zeichenkette	Verwenden Sie diese Struktur, um ein benutzerdefiniertes Feld Ihrer Wahl einzuschließen.

Benutzerdefinierte Felder

Ergebnisse

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

Warnung: Download-Links laufen nach 30 Tagen ab.

Erfolgreicher Upload

Wenn der Import erfolgreich abgeschlossen wird, wird eine Datei mit den Teilnehmerinformationen generiert und Ihnen per E-Mail zugesendet. Die in diesen Ergebnissen enthaltenen Informationen entsprechen denen in unserem Bericht mit Benutzerdetails.

Fehler