Advocate-Teilnehmer per Massenimport 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 anzuzeigen.
Hinweis: Wir empfehlen, dass jeder Import 500.000 Einträge nicht überschreitet.
Teilnehmende in großen Mengen importieren
Wählen Sie im linken Navigationsmenü
[Engage] → Teilnehmer.Wählen Sie Benutzer importieren.
Unter Importtypwählen Sie Benutzer.
Fügen Sie Ihre Importdatei hinzu, indem Sie Datei auswählen.
[Optional] Um die importierten Teilnehmenden 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 Teilnehmenden.
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ß-/kleinschreibungsempfindlich.
Standardfelder werden mit derselben Validierung geparst wie unser Open Endpoint User Upsert API-Aufruf:
accountId (erforderlich)
string
Die eindeutige Kennung des Kontos, zu dem diese teilnehmende Person gehört.
id (erforderlich)
string
Die eindeutige Kennung, die für diese teilnehmende Person angegeben wurde.
firstName
string
Der Vorname der teilnehmenden Person.
lastName
string
Der Nachname der teilnehmenden Person.
string
Die E-Mail-Adresse der teilnehmenden Person.
referable
boolean
Kennzeichen, das von impact.com verwendet wird, um festzustellen, ob eine teilnehmende Person weiterempfohlen werden kann.
Hinweis: Das Kennzeichen muss nur mit einem r geschrieben werden, damit der Status erfolgreich geändert werden kann.
locale
string
Das Gebietsschema der teilnehmenden Person, 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
string
Das Gebietsschema der teilnehmenden Person, verwendet für Internationalisierung. Der Ländercode des Benutzers (z. B. CA).
referredBy.code
string
Der Empfehlungscode des Kunden-Befürworters, der diese teilnehmende Person empfohlen hat.
referralCodes.{programId}
string
Der Vanity-Empfehlungscode für diese teilnehmende Person, den sie für das angegebene Programm teilen kann (wird automatisch generiert, wenn er nicht enthalten ist).
sharelinks.{programId}
string
Der Vanity-Share-Link für diese teilnehmende Person, den sie für das angegebene Programm teilen kann (wird automatisch generiert, wenn er nicht enthalten ist).
dateCreated
string
Das Datum, an dem diese teilnehmende Person in Ihrem Advocate-Programm erstellt wurde.
imageUrl
string
Wird optional in Widgets, E-Mails und Themes verwendet. Wenn Sie eine absolute Profilbild-URL angeben, beträgt die Mindestbildgröße 80 px x 80 px.
dateUsTaxFormSubmitted
integer
Das Datum, an dem das W-9-Steuerformular einer teilnehmenden Person als eingereicht markiert wurde. Wird für die W-9-Konformität auf Ihrem Tenant verwendet, sofern konfiguriert.
customFields.{fieldName}
string
Verwenden Sie diese Struktur, um ein benutzerdefiniertes Feld Ihrer Wahl einzuschließen.
Benutzerdefinierte Benutzerfelder ermöglichen Daten, die für Ihre Teilnehmenden einzigartig sind. Sie können Ihre Programmziele so festlegen, dass sie basierend auf Informationen in einem benutzerdefinierten Benutzerfeld ausgelöst werden.
Beispiel: Belohnen Sie Teilnehmende, wenn sie ihr Abonnement verlängern. Fügen Sie zunächst das benutzerdefinierte Feld customFields.subscriptionPaid mit dem Wert jahinzu. Legen Sie dann das Ziel so fest, dass es konvertiert wird, wenn customFields.subscriptionPaid gleich ja.
Fügen Sie benutzerdefinierte Felder in diesem Format zur Spaltenüberschrift hinzu: customFields.IhrBenutzerdefinierterFeldname.
Hinweis: Benutzerdefinierte Felder können keine Array- oder Objektwerte akzeptieren.
Ergebnisse
Wir benachrichtigen Sie per E-Mail, wenn Ihr Import abgeschlossen ist. Sie können die Importergebnisse von der [Engage] → Berichte → Importe & Exporte Seite innerhalb Ihres Advocate-Programms herunterladen.
Warnung: Download-Links verfallen nach 30 Tagen.
Wenn der Import erfolgreich abgeschlossen wird, wird eine Datei mit den Teilnehmendeninformationen generiert und Ihnen per E-Mail zugesendet. Die in diesen Ergebnissen enthaltenen Informationen sind dieselben wie in unserem Bericht mit Benutzerdetails.
Wenn während des Imports Fehler auftreten, wird zusätzlich eine weitere Datei generiert. Diese Fehlerdatei enthält Einträge für jeden aufgetretenen Fehler, einschließlich der Zeilennummer des Datensatzes (aus der ursprünglichen Importdatei), der fehlgeschlagen ist, sowie aller zugehörigen Fehlermeldungen.
2
Diese Anfrage erfordert eine gültige, nicht leere ID
BAD_REQUEST
400
Falls wider Erwarten ein Systemfehler auftritt und der Import unterbrochen wird, erscheint der Import als abgebrochen und kann nicht wiederhergestellt werden. Bitte wenden Sie sich an unser Support-Team, wenn Sie weitere Unterstützung benötigen.
Zuletzt aktualisiert
War das hilfreich?