Importer les données du programme de parrainage depuis SaaSquatch

Cet article contient des références utiles pour vous aider à importer les données de votre plateforme de parrainage de SaaSquatch vers impact.com.

Référence des colonnes du fichier CSV

Fichier de données des utilisateurs

Colonne	Obligatoire	Description
ID utilisateur		L’identifiant du participant.
ID de compte		L’identifiant de compte du participant.
E-mail		L’adresse e-mail du participant.
Prénom		Le prénom du participant.
Nom		Le nom de famille du participant.
Code de parrainage		Le code de parrainage du programme principal du participant (si spécifié).
URL de l’image		L’URL de l’image du participant.
Première IP détectée		L’adresse IP du participant lors de la première opération de mise à jour/insertion hors API.
Dernière IP détectée		L’adresse IP du participant lors de la dernière opération de mise à jour/insertion hors API.
Date de création		La date de création de cet utilisateur participant, formatée en millisecondes depuis l’époque Unix .
Hachage de l’e-mail		La valeur de hachage MD5 de l’adresse e-mail d’un participant.
Paramètres régionaux		L’emplacement géographique du participant.
Code pays		Le code pays du participant.
Segments		Les segments d’utilisateurs du participant.
Lien de partage		Le lien de partage du programme principal du participant (si spécifié).
Lien de partage Facebook		Le lien de partage Facebook du programme principal du participant (si spécifié).
Lien de partage Twitter		Le lien de partage Twitter/X du programme principal du participant (si spécifié).
Lien de partage par e-mail		Le lien de partage par e-mail du programme principal du participant (si spécifié).
Lien de partage LinkedIn		Le lien de partage LinkedIn du programme principal du participant (si spécifié).
Lien de partage nettoyé		Le lien de vanité principal du participant, sans encodage.
Champ personnalisé		Si un participant a un champ personnalisé, {ExampleName} sera le nom du champ.

Fichier de données de parrainage

Colonne	Obligatoire	Description
Utilisateur parrainé - ID utilisateur		L’ID utilisateur externe de l’ami parrainé.
Utilisateur parrainé - ID de compte		L’ID de compte externe de l’ami parrainé.
Utilisateur parrain - ID utilisateur		L’ID utilisateur externe du défenseur client.
Utilisateur parrain - ID de compte		L’ID de compte externe du défenseur client.
ID de recommandation		L’identifiant unique du parrainage.
Date de modification		La date de la dernière modification du parrainage (c.-à-d. démarré, converti, modéré, etc.), formatée en millisecondes depuis l’époque Unix .
Date de début du parrainage		La date de création du parrainage, formatée en millisecondes depuis l’époque Unix .
Date de conversion		La date à laquelle le premier objectif a été atteint, formatée en millisecondes depuis l’époque Unix .
Date de modification de l’utilisateur		La date à laquelle un utilisateur a été supprimé d’un parrainage (suppression d’utilisateur) ou ajouté à un parrainage, formatée en millisecondes depuis l’époque Unix .
ID du programme		L’identifiant du programme pour lequel le parrainage a été créé.
Nom du programme		Le nom du programme pour lequel le parrainage a été créé.
Utilisateur parrainé - E-mail		L’adresse e-mail de l’ami parrainé.
Utilisateur parrainé - Prénom		Le prénom de l’ami parrainé.
Utilisateur parrainé - Nom		Le nom de famille de l’ami parrainé.
Utilisateur parrainé - Code de parrainage		Le code de parrainage principal de l’ami parrainé (selon le programme dans lequel ce parrainage a été créé.
Utilisateur parrainé - Première IP vue		La première adresse IP utilisée par l’ami parrainé lors du chargement d’un widget.
Utilisateur parrainé - Dernière IP vue		L’adresse IP la plus récente utilisée par l’ami parrainé lors du chargement d’un widget.
Utilisateur parrainé - URL de l’image		L’image de l’ami parrainé.
Utilisateur parrainé - Paramètre régional		Le paramètre régional de l’ami parrainé.
Utilisateur parrainé - Date de création		La date à laquelle l’ami parrainé a été vu pour la première fois par SaaSquatch (créé dans SaaSquatch), formatée en millisecondes depuis l’époque Unix .
Utilisateur parrainé - Segments		Les segments d’utilisateurs de l’ami parrainé.
referredUserCustomFields.<fieldName>		Les champs personnalisés de l’ami parrainé.
Utilisateur parrain - E-mail		L’adresse e-mail du défenseur client.
Utilisateur parrain - Prénom		Le prénom du défenseur client.
Utilisateur parrain - Nom		Le nom de famille du défenseur client.
Utilisateur parrain - Code de parrainage		Le code de parrainage principal du défenseur client (par ex. le code de parrainage utilisé pour créer ce parrainage).
Utilisateur parrain - Première IP vue		La première adresse IP utilisée par le défenseur client lors du chargement d’un widget.
Utilisateur parrain - Dernière IP vue		L’adresse IP la plus récente utilisée par le défenseur client lors du chargement d’un widget.
Utilisateur parrain - URL de l’image		L’image du défenseur client.
Utilisateur parrain - Paramètre régional		Le paramètre régional du défenseur client.
Utilisateur parrain - Date de création		La date à laquelle le défenseur client a été vu pour la première fois par SaaSquatch (créé dans SaaSquatch), formatée en millisecondes depuis l’époque Unix .
Statut de modération		Le statut de modération de la fraude de parrainage (par ex. EN ATTENTE, TRAITÉ).
Date de modération		La date de démarrage du parrainage, formatée en millisecondes depuis l’époque Unix .
Utilisateur parrainé - ID de récompense		L’identifiant de récompense de l’ami parrainé.
Utilisateur parrain - ID de récompense		L’identifiant de récompense du défenseur client.
Utilisateur parrain - Segments		Les segments d’utilisateurs du défenseur client.
referrerUserCustomFields.<fieldName>		Les champs personnalisés du défenseur client.
Code de parrainage utilisé		Le code de parrainage du défenseur client qui a été utilisé pour le parrainage.
Lien de partage utilisé		Le lien de partage du défenseur client qui a été utilisé pour le parrainage.

Fichier de données des récompenses

Colonne	Obligatoire	Description
ID utilisateur		L’identifiant de l’utilisateur.
ID de compte		L’identifiant de compte de l’utilisateur.
Type		Le type de récompense, par ex. Crédit, remise, carte-cadeau, etc.
Unité de récompense		L’unité dans laquelle les récompenses sont gagnées, par ex. argent, points, mois, etc.
Valeur de la récompense		La valeur numérique de la récompense dans sa plus petite unité de mesure, par ex. pour une récompense en argent de 1,00 $, la valeur serait de 100 (centimes).
Nom de la récompense		Le nom que vous avez attribué à la récompense lors de sa création dans votre programme.
Valeur en USD		La valeur de la récompense en USD.
ID du programme		L’identifiant du programme pour lequel la récompense a été créée.
Clé de récompense globale		Clé de la configuration globale de récompense dans le catalogue de récompenses. Ceci se trouve sous Récompenses → Catalogue → Créer des récompenses → Nom de la récompense.
Source de la récompense		Comment la récompense a été créée, par ex. Manuel, Utilisateur parrainé, Inscription d’un ami.
Date de création		La date à laquelle la récompense a été gagnée, formatée en millisecondes depuis l’époque Unix .
Date d’attribution		La date à laquelle la récompense a été attribuée, formatée en millisecondes depuis l’époque Unix . (Cette valeur peut différer de Date de création si la récompense était en attente).
Date prévue pour		La date à laquelle la récompense devait être attribuée à l’utilisateur, formatée en millisecondes depuis l’époque Unix .
Date d’expiration		La date après laquelle la récompense ne peut plus être échangée, formatée en millisecondes depuis l’époque Unix .
Date d’annulation		La date à laquelle vous avez annulé la récompense, formatée en millisecondes depuis l’époque Unix .
Date de modification		La date à laquelle vous avez apporté des modifications à la récompense, formatée en millisecondes depuis l’époque Unix .
Date d’utilisation		La date à laquelle la récompense complète a été échangée par l’utilisateur, formatée en millisecondes depuis l’époque Unix .
Crédit attribué		Le montant dans l’unité de base pour les récompenses en Crédit. C’est l’équivalent de Valeur de la récompense, mais pour les récompenses en Crédit.
Montant échangé		Le Valeur de la portion de la récompense qui a été échangée.
Type de réservoir de carburant		Cela peut être soit Crédit ou % de remise.
Code Fuel Tank		C’est comme un code promo, par ex. SummerSave20, 20%OFF, etc.
ID de l’utilisateur parrainé		L’identifiant utilisateur de l’ami parrainé.
ID de compte du parrainé		L’identifiant du compte de l’ami parrainé.
referral.referredUser.id		Utilisé conjointement avec ID du programme pour associer un parrainage à un identifiant de programme, si nous voulons rattacher un parrainage à une récompense. Cela peut ne pas toujours correspondre à ID utilisateur.
referral.referredUser.accountId		Utilisé conjointement avec ID du programme pour associer un parrainage à un identifiant de programme, si nous voulons rattacher un parrainage à une récompense. Cela peut ne pas toujours correspondre à ID de compte.

Référence d’erreur de validation

Vous pouvez obtenir 3 types d’erreurs de validation :

1. Message d’erreur en ligne : ceux-ci apparaissent dans le tableau d’aperçu de validation et font que les lignes en erreur sont mises en surbrillance en rouge :

   • INVALID_FIELD — par ex., le Date de création champ n’était pas formaté en millisecondes depuis l’époque Unix .

   • MISSING_FIELD — par ex., un champ obligatoire tel que ID utilisateur ou ID de compte est manquant.

   
2. Message d’alerte d’erreur : ceux-ci apparaissent à la place du tableau d’aperçu de validation sous forme de messages d’avertissement rouges :

   • MISSING_HEADER — par ex., un en-tête de colonne obligatoire tel que ID de compte ou Valeur de la récompense est manquant.

   • CSV_PARSING — par ex., le fichier CSV contient des caractères spéciaux qui sont mal formatés.

   • FILE_REF_IO — par ex., le fichier est corrompu et ne peut pas être lu.

   
3. Erreurs répertoriées : celles-ci apparaissent sous forme de liste de compteurs d’erreurs sur l’ Imports et Exports écran lorsque le type d’importation ne comporte pas de tableau d’aperçu de validation. Les erreurs de ligne et les erreurs de fichier s’afficheront ensemble :

   1. Dans la barre de navigation de gauche, sélectionnez [Engage] → Reporting.

   2. Sélectionnez Imports et Exports pour consulter le rapport.