Importer des participants Advocate en masse

Advocate accepte les imports soumis au format .csv ou .jsonl . Veuillez consulter notre fichier d’import CSV d’exemple et fichier d’import JSONL d’exemple pour voir la structure de fichier requise pour votre import.

Remarque : Nous recommandons que chaque import ne dépasse pas 500 000 entrées.

Importer des participants en masse

1. Dans le menu de navigation de gauche, sélectionnez [Engage] → Participants.

2. Sélectionnez Importer des utilisateurs.

3. Sous Type d’import, sélectionnez Utilisateurs.

4. Ajoutez votre fichier d’import en sélectionnant Sélectionner un fichier.

5. [Facultatif] Pour ajouter ou supprimer les participants importés d’un segment d’utilisateurs spécifique, sélectionnez le segment dans la liste déroulante.

Remarque : Cette sélection s’applique à tous les participants inclus dans ce fichier d’import.

1. Sélectionnez Démarrer l’import.

Une fois l’import terminé, un e-mail de confirmation est envoyé. Les imports peuvent prendre jusqu’à 30 minutes, selon la file d’attente et la taille du fichier.

Champs

Les imports groupés d’utilisateurs prennent en charge à la fois les champs standard et les champs personnalisés dans le fichier téléversé. Les champs sont sensibles à la casse.

Champs standard

Les champs standard sont analysés avec la même validation que notre appel API Open Endpoint User Upsert:

Champ	Type	Description
accountId (obligatoire)	chaîne de caractères	L’identifiant unique du compte auquel appartient ce participant.
id (obligatoire)	chaîne de caractères	L’identifiant unique fourni pour ce participant.
firstName	chaîne de caractères	Le prénom du participant.
lastName	chaîne de caractères	Le nom du participant.
email	chaîne de caractères	L’adresse e-mail du participant.
referable	booléen	Indicateur utilisé par impact.com pour déterminer si un participant peut être recommandé. Remarque : L’indicateur doit être orthographié avec seulement un r pour que le statut soit modifié avec succès.
locale	chaîne de caractères	La langue et la région du participant, utilisée pour l’internationalisation. La valeur locale doit être au format langue_PAYS où le code de langue doit être en minuscules et le code pays en majuscules. Le séparateur doit être un tiret bas.
countryCode	chaîne de caractères	La langue et la région du participant, utilisée pour l’internationalisation. Le code pays de l’utilisateur (par ex. CA).
referredBy.code	chaîne de caractères	Le code de parrainage du client advocate qui a recommandé ce participant.
referralCodes.{programId}	chaîne de caractères	Le code de parrainage personnalisé de ce participant à partager pour le programme spécifié (généré automatiquement s’il n’est pas inclus).
sharelinks.{programId}	chaîne de caractères	Le lien de partage personnalisé de ce participant à partager pour le programme spécifié (généré automatiquement s’il n’est pas inclus).
dateCreated	chaîne de caractères	La date à laquelle ce participant a été créé dans votre programme Advocate.
imageUrl	chaîne de caractères	Utilisé éventuellement dans les widgets, e-mails et thèmes. Si vous fournissez une URL absolue d’image de profil, la taille minimale de l’image est de 80 px x 80 px.
dateUsTaxFormSubmitted	entier	La date à laquelle le formulaire fiscal W-9 d’un participant a été marqué comme collecté. Utilisé pour la conformité W-9 sur votre tenant, si configuré.
customFields.{fieldName}	chaîne de caractères	Utilisez cette structure pour inclure un champ personnalisé de votre choix.

Champs personnalisés

Résultats

Nous vous informons par e-mail lorsque votre import est terminé. Vous pouvez télécharger les résultats de l’import depuis la page [Engage] → Rapports → Importations et exports dans votre programme Advocate.

Avertissement : Les liens de téléchargement expireront après 30 jours.

Téléversement réussi

Si l’import se termine avec succès, un fichier contenant les informations des participants sera généré et vous sera envoyé par e-mail. Les informations incluses dans ces résultats sont les mêmes que celles figurant dans notre rapport de détails utilisateur.

Erreurs