Importer des participants Advocate en masse

Advocate accepte les imports soumis dans .csv ou .jsonl les formats de fichier. 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 d'utilisateurs en masse prennent en charge à la fois les champs standard et les champs personnalisés dans le fichier téléversé. La casse des champs est sensible.

Champs standard

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

Champ	Type	Description
accountId (obligatoire)	chaîne	L'identifiant unique du compte auquel appartient ce participant.
id (obligatoire)	chaîne	L'identifiant unique fourni pour ce participant.
firstName	chaîne	Le prénom du participant.
lastName	chaîne	Le nom du participant.
e-mail	chaîne	L'adresse e-mail du participant.
referable	booléen	Drapeau utilisé par impact.com pour déterminer si un participant peut être recommandé. Remarque : Le drapeau doit être orthographié avec un seul un r pour que le statut soit modifié avec succès.
locale	chaîne	La locale du participant, utilisée pour l'internationalisation. La locale doit être au format language_COUNTRY où le code de langue doit être en minuscules et le code pays en majuscules. Le séparateur doit être un underscore.
countryCode	chaîne	La locale du participant, utilisée pour l'internationalisation. Le code pays de l'utilisateur (par ex. CA).
referredBy.code	chaîne	Le code de parrainage du défenseur client qui a recommandé ce participant.
referralCodes.{programId}	chaîne	Le code de parrainage personnalisé pour que ce participant le partage pour le programme spécifié (généré automatiquement s'il n'est pas inclus).
sharelinks.{programId}	chaîne	Le lien de partage personnalisé pour que ce participant le partage pour le programme spécifié (généré automatiquement s'il n'est pas inclus).
dateCreated	chaîne	La date à laquelle ce participant a été créé dans votre programme Advocate.
imageUrl	chaîne	Utilisé facultativement dans les widgets, les e-mails et les 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	Utilisez cette structure pour inclure un champ personnalisé de votre choix.

Champs personnalisés

Champs utilisateur personnalisés permettent de gérer des données propres à vos participants. Vous pouvez configurer les objectifs de votre programme pour qu'ils se déclenchent en fonction des informations contenues dans un champ utilisateur personnalisé.

Exemple: Récompensez les participants lorsqu'ils renouvellent leur abonnement. Commencez par inclure le champ personnalisé customFields.subscriptionPaid avec la valeur oui. Puis, définissez l'objectif de conversion lorsque customFields.subscriptionPaid est égal à oui.

Ajoutez des champs personnalisés à l'en-tête de colonne au format suivant : customFields.yourCustomFieldName.

Remarque : Les champs personnalisés n'acceptent pas de valeurs de tableau ou d'objet.

Résultats

Nous vous avertissons par e-mail lorsque votre import est terminé. Vous pouvez télécharger les résultats de l'import depuis la [Engage] → Rapports → Imports et exports page de 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 du participant sera généré et vous sera envoyé par e-mail. Les informations incluses dans ces résultats sont les mêmes que celles que l'on trouve dans notre rapport de détails des utilisateurs.

Erreurs

Si des erreurs sont rencontrées pendant l'import, un fichier supplémentaire sera alors généré. Ce fichier d'erreurs inclut une entrée pour chaque erreur survenue, y compris le numéro de ligne de l'enregistrement (provenant du fichier d'import initial) ayant échoué, ainsi que tous les messages d'erreur associés.

recordNumber	message	apiErrorCode	statusCode
2	Cette requête nécessite un id valide non vide	BAD_REQUEST	400

Dans le cas peu probable où une erreur système se produit et que l'import est interrompu, l'import apparaîtra comme interrompu et ne pourra pas être récupéré. Veuillez contacter notre équipe d'assistance si vous avez besoin d'aide supplémentaire.