Explication des champs personnalisés pour Advocate

Vous pouvez utiliser champs personnalisés pour envoyer à impact.com des données supplémentaires sur les participants de votre programme de parrainage. Ces informations peuvent être utilisées dans vos règles du programme pour déterminer quand les objectifs et les actions sont déclenchés. Vous pouvez également segmenter vos participants en fonction des valeurs des champs personnalisés.

Les types de champs personnalisés que vous envoyez sont flexibles. Par exemple, vous pouvez souhaiter inclure des informations sur un participant :

• Date de naissance
• Langue
• Emplacement
• Type d’abonnement
• Statut d’adhésion

Les champs personnalisés peuvent être envoyés à impact.com lorsque vous importez un fichier d’importation utilisateur ou via UTT, l’API, le SDK ou une autre méthode d’intégration.

Caractéristiques des champs

Tous les champs personnalisés que vous envoyez doivent respecter quelques exigences concernant les noms et les valeurs des champs.

Noms

• Jusqu’à 64 caractères.
• Seuls les caractères alphanumériques, les tirets et les underscores sont acceptés (les lettres doivent être non accentuées).
• Sensible à la casse, par ex. : customFieldName est considéré comme distinct de customfieldname.

Valeurs

• Prend en charge chaîne de caractères, nombre, Booléen, et types null.
• Valeur maximale d’une chaîne de 1024 caractères.
• Les dates doivent être formatées comme un horodatage UNIX en millisecondes.
• Un maximum de 100 champs peut être ajouté/mis à jour par requête.
• Définir un champ personnalisé pour un utilisateur sur null supprimera le champ pour cet utilisateur.

Envoyer les informations de champ personnalisé à impact.com

Vous pouvez inclure des champs personnalisés chaque fois que vous créez, mettez à jour ou effectuez un upsert d’utilisateurs, quelle que soit la méthode utilisée pour envoyer les données.

Importations de fichiers

Vous pouvez inclure des champs personnalisés lors de l’importation de nouveaux utilisateurs ou de la mise à jour en masse d’utilisateurs existants. Reportez-vous à Importer des participants Advocate en masse pour obtenir des instructions.

Ci-dessous se trouvent deux fichiers d’exemple que vous pouvez utiliser pour guider votre importation.

• Importations de données utilisateur : CSV ou JSONL
• Importations de données d’événements : CSV ou JSONL

API et SDK

Les champs personnalisés peuvent être inclus lors de l’utilisation des méthodes GraphQL ou points de terminaison de l’API REST qui créent, mettent à jour ou effectuent un upsert d’utilisateurs. Ils peuvent également être inclus lors de l’utilisation de UTT ou de nos options mobiles pour créer, mettre à jour ou effectuer un upsert d’utilisateurs depuis votre application.