Importer des participants Advocate en masse
Advocate accepte les importations soumises au format .csv ou .jsonl Veuillez vous référer à notre fichier d'exemple CSV pour l'import et fichier d'exemple JSONL pour l'import pour voir la structure de fichier requise pour votre importation.
Remarque : Nous recommandons que chaque importation n'excède pas 500 000 entrées.
Importer des participants en masse
Dans le menu de navigation gauche, sélectionnez
[Engage] → Participants.
Sélectionnez Importer des utilisateurs.
Sous Type d'importation, sélectionnez Utilisateurs.
Ajoutez votre fichier d'importation en sélectionnant Sélectionner un fichier.
[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'importation.
Sélectionnez Démarrer l'importation.
Lorsque l'importation est terminée, un courriel de confirmation est envoyé. Les importations peuvent prendre jusqu'à 30 minutes, en fonction de la file d'attente et de la taille du fichier.
Champs
Les importations massives 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.
Les champs standard sont analysés avec la même validation que notre appel API Open Endpoint User Upsert:
accountId (Requis)
chaîne
L'identifiant unique du compte auquel ce participant appartient.
id (Requis)
chaîne
L'identifiant unique fourni pour ce participant.
firstName
chaîne
Le prénom du participant.
lastName
chaîne
Le nom de famille du participant.
chaîne
L'adresse e-mail du participant.
referable
booléen
Indicateur utilisé par impact.com pour déterminer si un participant peut être référé.
Remarque : Le drapeau doit être orthographié avec seulement une r pour que le statut puisse être modifié avec succès.
locale
chaîne
La locale du participant, utilisée pour Internationalisation. La locale doit être au format language_COUNTRY où le code 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 Internationalisation. Le code pays de l'utilisateur (ex. CA).
referredBy.code
chaîne
Le code de parrainage de l'avocat client qui a parrainé 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é optionnellement dans les widgets, les e-mails et les thèmes. Si vous fournissez une URL d'image de profil absolue, la taille d'image minimale est de 80px x 80px.
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 locataire, si configuré.
customFields.{fieldName}
chaîne
Utilisez cette structure pour inclure un champ personnalisé de votre choix.
Les champs utilisateur personnalisés permettent des données propres à vos participants. Vous pouvez définir les objectifs de votre programme pour se déclencher en fonction des informations contenues dans un champ utilisateur personnalisé.
Exemple: Récompenser les participants lorsqu'ils renouvellent leur abonnement. Tout d'abord, incluez le champ personnalisé customFields.subscriptionPaid avec la valeur oui. Ensuite, définissez l'objectif pour qu'il se convertisse lorsque customFields.subscriptionPaid est égal à oui.
Ajoutez des champs personnalisés à l'en-tête de colonne dans ce format : customFields.votreNomDeChampPersonnalise.
Remarque : Les champs personnalisés ne peuvent pas accepter de valeurs de type tableau ou objet.
Résultats
Nous vous informons par e-mail lorsque votre importation est terminée. Vous pouvez télécharger les résultats d'importation depuis la [Engage] → Reporting → Imports & Exports page au sein de votre programme Advocate.
Avertissement : Les liens de téléchargement expireront après 30 jours.
Si l'importation se termine avec succès, un fichier contenant les informations des participants sera généré et 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.
Si des erreurs sont rencontrées pendant l'importation, un fichier supplémentaire sera généré. Ce fichier d'erreurs inclut des entrées pour chaque erreur survenue, y compris le numéro de ligne de l'enregistrement (à partir du fichier d'importation initial) qui a échoué, et les messages d'erreur associés.
2
Cette requête nécessite un id valide non vide
MAUVAISE_REQUÊTE
400
Dans l'éventualité peu probable où une erreur système se produirait et que l'importation soit interrompue, l'importation apparaîtra comme abandonnée et ne se rétablira pas. Veuillez contacter notre équipe Support si vous avez besoin d'une assistance supplémentaire.
Mis à jour
Ce contenu vous a-t-il été utile ?

