Importer des données de 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	Requis	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 du participant.
Code de parrainage		Le code de parrainage principal du participant (le cas échéant).
URL de l'image		L'URL de l'image du participant.
IP vue pour la première fois		L'adresse IP du participant la première fois qu'il a effectué un upsert non-API.
IP vue pour la dernière fois		L'adresse IP du participant la dernière fois qu'il a effectué un upsert non-API.
Date de création		La date à laquelle cet utilisateur participant a été créé, au format millisecondes depuis l'époque Unix .
Hash de l'e-mail		La valeur de hachage MD5 de l'adresse e-mail d'un participant.
Locale		La localisation géographique du participant.
Code pays		Le code pays du participant.
Segments		Les segments utilisateur du participant.
Lien de partage		Le lien de partage du programme principal du participant (le cas échéant).
Lien de partage Facebook		Le lien de partage Facebook du programme principal du participant (le cas échéant).
Lien de partage Twitter		Le lien de partage Twitter/X du programme principal du participant (le cas échéant).
Lien de partage par e-mail		Le lien de partage par e-mail du programme principal du participant (le cas échéant).
Lien de partage LinkedIn		Le lien de partage LinkedIn du programme principal du participant (le cas échéant).
Lien de partage nettoyé		Le lien personnalisé principal du participant sans encodage.
Champ personnalisé		Si un participant a un champ personnalisé, {ExampleName} sera le nom du champ.

Fichier de données des parrainages

Colonne	Requis	Description
Utilisateur parrainé - ID utilisateur		L'identifiant utilisateur externe de l'ami parrainé.
Utilisateur parrainé - ID de compte		L'identifiant de compte externe de l'ami parrainé.
Utilisateur parrainant - ID utilisateur		L'identifiant utilisateur externe du défenseur client.
Utilisateur parrainant - ID de compte		L'identifiant de compte externe du défenseur client.
ID du parrainage		L'identifiant unique du parrainage.
Date modifiée		La date à laquelle le parrainage a été modifié pour la dernière fois (par ex. démarré, converti, modéré, etc.), au format millisecondes depuis l'époque Unix .
Date de début du parrainage		La date à laquelle le parrainage a été créé, au format millisecondes depuis l'époque Unix .
Date de conversion		La date à laquelle le premier objectif a été atteint, au format 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, au format 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 l'ami parrainé.
Utilisateur parrainé - Code de parrainage		Le code de parrainage principal de l'ami parrainé (dépend du programme dans lequel ce parrainage a été créé).
Utilisateur parrainé - IP vue pour la première fois		La première adresse IP que l'ami parrainé a utilisée lors du chargement d'un widget.
Utilisateur parrainé - IP vue pour la dernière fois		L'adresse IP la plus récente que l'ami parrainé a utilisée lors du chargement d'un widget.
Utilisateur parrainé - URL de l'image		L'image de l'ami parrainé.
Utilisateur parrainé - Locale		La locale 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), au format millisecondes depuis l'époque Unix .
Utilisateur parrainé - Segments		Les segments utilisateur de l'ami parrainé.
referredUserCustomFields.<fieldName>		Les champs personnalisés de l'ami parrainé.
Utilisateur parrainant - E-mail		L'adresse e-mail du défenseur client.
Utilisateur parrainant - Prénom		Le prénom du défenseur client.
Utilisateur parrainant - Nom		Le nom du défenseur client.
Utilisateur parrainant - 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 parrainant - IP vue pour la première fois		La première adresse IP que le défenseur client a utilisée lors du chargement d'un widget.
Utilisateur parrainant - IP vue pour la dernière fois		L'adresse IP la plus récente que le défenseur client a utilisée lors du chargement d'un widget.
Utilisateur parrainant - URL de l'image		L'image du défenseur client.
Utilisateur parrainant - Locale		La locale du défenseur client.
Utilisateur parrainant - Date de création		La date à laquelle le défenseur client a été vu pour la première fois par SaaSquatch (créé dans SaaSquatch), au format millisecondes depuis l'époque Unix .
Statut de modération		Le statut de modération de fraude du parrainage (par ex., EN ATTENTE, TRAITÉ).
Date de modération		La date à laquelle le parrainage a commencé, au format millisecondes depuis l'époque Unix .
Utilisateur parrainé - ID de récompense		L'identifiant de la récompense de l'ami parrainé.
Utilisateur parrainant - ID de récompense		L'identifiant de la récompense du défenseur client.
Segments de l'utilisateur parrainant		Les segments utilisateur 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	Requis	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, réduction, carte-cadeau, etc.
Unité de récompense		L'unité dans laquelle les récompenses sont acquises, par ex., argent, points, mois, etc.
Valeur de la récompense		La valeur numérique de la récompense dans son unité de mesure la plus petite, par ex., pour une récompense en espèces de 1,00 $, la valeur serait 100 (cents).
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é globale de la récompense		Clé de la configuration globale de la récompense dans le catalogue de récompenses. Ceci se trouve sous Rewards → Catalog → Create rewards → Reward Name.
Source de la récompense		Comment la récompense a été créée, par ex., Manuelle, Utilisateur parrainé, Inscription d'un ami.
Date de création		La date à laquelle la récompense a été gagnée, au format millisecondes depuis l'époque Unix .
Date attribuée		La date à laquelle la récompense a été attribuée, au format millisecondes depuis l'époque Unix . (Cette valeur peut différer de Date de création si la récompense était en attente).
Date programmée		La date à laquelle la récompense était prévue d'être attribuée à l'utilisateur, au format millisecondes depuis l'époque Unix .
Date d'expiration		La date après laquelle la récompense ne peut plus être échangée, au format millisecondes depuis l'époque Unix .
Date d'annulation		La date à laquelle vous avez annulé la récompense, au format millisecondes depuis l'époque Unix .
Date modifiée		La date à laquelle vous avez apporté des modifications à la récompense, au format millisecondes depuis l'époque Unix .
Date de rachat		La date à laquelle la récompense complète a été rachetée par l'utilisateur, au format millisecondes depuis l'époque Unix .
Crédit attribué		Le montant dans l'unité de base pour les récompenses Crédit. C'est l'équivalent de Valeur de la récompense, mais pour les récompenses Crédit.
Montant racheté		Le Valeur de la partie de la récompense qui a été rachetée.
Type de réservoir de carburant		Cela peut être soit Crédit ou % de réduction.
Code du réservoir de carburant		Ceci est comme un code coupon, par ex., SummerSave20, 20%OFF, etc.
ID de l'utilisateur parrainé		L'identifiant utilisateur de l'ami parrainé.
ID du compte parrainé		L'identifiant du compte de l'ami parrainé.
referral.referredUser.id		Utilisé conjointement avec ID du programme pour lier un parrainage à un ID de programme, si nous voulons attacher un parrainage à une récompense. Cela peut ne pas toujours correspondre au ID utilisateur.
referral.referredUser.accountId		Utilisé conjointement avec ID du programme pour lier un parrainage à un ID de programme, si nous voulons attacher un parrainage à une récompense. Cela peut ne pas toujours correspondre au ID de compte.

Référence des erreurs de validation

Vous pouvez obtenir 3 types d'erreurs de validation :

1. Message d'erreur en ligne : ceux-ci apparaissent dans le tableau de validation d'aperçu et provoquent la mise en surbrillance des lignes d'erreur en rouge :

   • CHAMP_NON_VALIDE — par ex., le Date de création champ n'a pas été formaté en millisecondes depuis l'époque Unix .

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

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

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

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

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

   
3. Erreurs listées : celles-ci apparaissent sous forme de liste de comptes d'erreurs sur l'écran Imports & Exports lorsque le type d'importation n'a pas de tableau de validation d'aperçu. 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 & Exports pour afficher le rapport.