> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
# Rapports du programme Advocate expliqués
Suivez la formation PXA
Advocate propose divers rapports téléchargeables pour vos données de programme et de participants. Tous les rapports disposent d’options de filtrage pour vous offrir un meilleur contrôle sur les données que vous téléchargez. Chaque rapport peut être téléchargé au format .CSV ou Excel.
Cet article explique les différents rapports et le type de données que chacun contient. Reportez-vous à [Exécuter un rapport de programme Advocate](/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) pour obtenir des instructions sur la génération d’un rapport.
#### Rapport de détails utilisateur
Le *Détails utilisateur* le rapport contient des informations détaillées sur chaque participant dans tous vos programmes. Exportez une liste de tous les participants pour maintenir vos données à jour avec les liens de partage et les codes de parrainage Advocate.
Détails du rapport
Par défaut, le rapport inclura des informations sur le participant telles que :
* Nom
* ID utilisateur et compte
* Adresse e-mail
* Champs personnalisés
* Segments
* Informations de parrainage (le cas échéant)
Lors de la génération du rapport, vous pouvez éventuellement inclure :
* **Statistiques utilisateur**, y compris des informations analytiques sur le participant comme le trafic, les revenus et plus encore.
* **Liens et codes de partage de parrainage**, le cas échéant. Ces informations peuvent être utiles pour la mise à jour des enregistrements de contact dans votre CMS ou système d’e-mail afin d’inclure les liens et codes de partage Advocate de chaque participant.
Une liste complète des champs est disponible lors du [téléchargement de notre CSV d’exemple](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv)  rapport de détails utilisateur.
**Référence des colonnes du rapport**
| Colonne | Description |
| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informations utilisateur** | |
| ID | L’identifiant unique du participant dans le système Advocate. |
| ID de compte | L’identifiant unique du compte du participant (utilisé sur plusieurs programmes, le cas échéant). |
| E-mail | L’adresse e-mail du participant. |
| Prénom | Le prénom du participant. |
| Nom | Le nom de famille du participant. |
| Hachage de l’e-mail | Une version hachée (chiffrée) de l’e-mail du participant, utile pour une correspondance respectant la confidentialité avec d’autres systèmes. |
| **Informations de parrainage et de partage** | |
| Code de parrainage | Le code unique lié au participant, utilisé pour suivre les parrainages qu’il génère. |
| Lien de partage | Le lien de parrainage unique associé au participant. |
| Lien de partage Facebook | Un lien pré-généré pour partager le parrainage sur Facebook. |
| Lien de partage Twitter | Un lien pré-généré pour partager le parrainage sur Twitter. |
| Lien de partage par e-mail | Un lien pré-généré pour partager le parrainage par e-mail. |
| Lien de partage LinkedIn | Un lien pré-généré pour partager le parrainage sur LinkedIn. |
| Lien de partage propre | Une version du lien de parrainage sans paramètres de suivi ; plus neutre pour certaines plateformes ou certains cas d’utilisation. |
| **Géolocalisation et langue** | |
| Première IP vue | L’adresse IP à partir de laquelle le participant a été enregistré pour la première fois. |
| Dernière IP vue | L’adresse IP la plus récente observée pour ce participant. |
| Paramètres régionaux | La langue préférée et les paramètres régionaux du participant (par ex., en-US). |
| Code pays | Le pays du participant basé sur les paramètres régionaux ou l’adresse IP (par ex., ZA, US). |
| **Horodatages** | |
| Date de création | La date et l’heure auxquelles le compte du participant a été créé dans Advocate. |
| Date de soumission du formulaire fiscal américain | (Le cas échéant) La date à laquelle un formulaire fiscal américain a été soumis pour la conformité ou le traitement des récompenses. |
| **Statistiques utilisateur (si incluses dans l’exportation)** | |
| stats.date Modifiée | La dernière date à laquelle les statistiques du participant ont été mises à jour. |
| stats.traffic | Nombre total de visites générées par l’activité de parrainage du participant. |
| stats.parrainages | Nombre total de parrainages réussis effectués par le participant. |
| stats.conversions | Nombre total de conversions (par ex., achats, inscriptions) résultant de ces parrainages. |
| stats.objectifs | Nombre d’achèvements d’objectifs spécifiques associés à l’activité de parrainage du participant (définis sur mesure dans le programme). |
| stats.récompenses | Nombre total de récompenses gagnées par le participant. |
| stats.widget Chargements | Nombre de fois où le widget de parrainage ou l’interface de partage a été chargée par ce participant. |
| stats.revenus | Revenus totaux générés par les utilisateurs parrainés par ce participant. |
| stats.revenus générés | Synonyme de stats.revenue ; certains rapports peuvent faire la distinction si les revenus proviennent de plusieurs sources. |
| stats.revenus parrainés | Revenus attribués spécifiquement aux participants qui se sont inscrits ou ont acheté via le lien de parrainage de ce participant. |
| **Données personnalisées** | |
| champs personnalisés.exemple | Un espace réservé pour tous les champs personnalisés définis par votre programme (par ex., *ID fidélité*, *notes internes*, *étiquette de région*). Chaque champ apparaîtra dans sa propre colonne, préfixée par champs personnalisés. |
| **Autre** | |
| Source du parrainage | La source ou le canal d’origine qui a conduit le participant vers votre programme (par ex., *organique*, *e-mail*, *site partenaire*). |
#### Exportation des événements utilisateur
Le *Exportation des événements utilisateur* le rapport fournit un enregistrement de tous les événements utilisateur que nous avons reçus de votre organisation pour votre programme Advocate. Vous pouvez appliquer des filtres pour affiner une plage de dates, une clé d’événement, un ID utilisateur, et plus encore.
Détails du rapport
Par défaut, le rapport inclut :
* ID de l’événement
* Clé d’événement
* ID utilisateur et compte
* Date de déclenchement
* Date de réception
* Date de traitement
**Référence des colonnes du rapport**
| Colonne | Description |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Informations sur l’événement et l’utilisateur** | |
| ID de l’événement | Un identifiant unique généré pour chaque événement reçu. Utile pour le suivi, le débogage ou l’audit des soumissions d’événements. |
| Clé de l’événement | Le type ou l’intitulé de l’événement, comme `achat`, `inscription`, ou toute clé définie sur mesure envoyée par votre système. |
| ID utilisateur | L’identifiant unique du participant dans Advocate auquel l’événement est associé. |
| ID de compte | L’ID du compte lié à l’utilisateur, particulièrement pertinent dans les programmes où les utilisateurs peuvent appartenir à différentes structures de compte. |
| **Horodatages de l’événement** | |
| Date de déclenchement de l’événement – AAAA-MM-JJ | La date à laquelle l’événement a réellement eu lieu (telle que signalée par votre système). Par exemple, la date à laquelle un achat ou une inscription a eu lieu. |
| Date de réception de l’événement – AAAA-MM-JJ | La date à laquelle Advocate a reçu l’événement de votre système. Peut différer de la date de déclenchement en raison d’un traitement par lots ou de retards du système. |
| Date de traitement de l’événement – AAAA-MM-JJ | La date à laquelle l’événement a été traité et enregistré avec succès dans Advocate. Indique le moment où l’événement est devenu utilisable pour le suivi, les récompenses ou les rapports. |
| **Champs de données d’événement (si inclus dans vos charges utiles d’événements)** | |
| fields.coupon | Tout bon ou code de réduction appliqué pendant l’événement, s’il est envoyé dans les données de l’événement. Utile pour suivre l’utilisation d’incitations ou des déclencheurs de promotion spécifiques. |
| fields.revenue | Le montant des revenus associé à l’événement. Généralement utilisé dans les événements d’achat pour calculer la performance, les récompenses ou le ROI. |
| fields.currency | Le code de devise (par ex., *USD*, *ZAR*, *EUR*) lié au montant des revenus. Important lors de rapports transfrontaliers ou du calcul de récompenses ajustées au taux de change. |
| fields.lead Date de création | La date d’origine à laquelle le prospect (utilisateur) a été créé dans votre système, si elle a été soumise dans le cadre de l’événement. Aide à relier les événements utilisateur aux dates d’acquisition d’origine ou aux enregistrements CRM. |
#### Historique des récompenses
Le *Historique des récompenses* le rapport fournit un enregistrement détaillé de chacune de vos récompenses et des relations avec les participants et les parrainages. Ces informations peuvent être utiles pour créer des bilans, ainsi que pour connaître l’état de toutes vos récompenses à un instant donné.
Détails du rapport
Par défaut, le rapport inclura **champs de récompense** des informations telles que :
* ID de la récompense
* Type de récompense
* Valeur de la récompense
Une liste complète des champs inclus est disponible lors du [téléchargement de notre CSV d’exemple](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [Excel d’exemple](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx)  ou [JSONL d’exemple](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl)  rapports de détails de récompense.
Lors de la génération du rapport, vous pouvez éventuellement inclure :
* **Détails du participant** comme le nom, l’ID utilisateur et compte, l’adresse e-mail, les champs personnalisés, les segments et les informations de parrainage (le cas échéant).
* **Champs de parrainage** comme l’ID de parrainage, les champs de l’ambassadeur client, les champs de l’ami parrainé, et plus encore.
**Référence des colonnes du rapport**
| Colonne | Description |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Informations sur la récompense** | |
| ID | Identifiant unique de l’instance de récompense (généré par Advocate). |
| Type | La catégorie ou le type de récompense (par ex., *Espèces*, *Carte cadeau*, *Coupon*, *Personnalisé*). |
| Valeur | La valeur numérique de la récompense (par ex., 10, 100, etc.). |
| Unité | L’unité associée à la valeur (par ex., *USD*, *points*, *ZAR*, *%*). |
| Nom | Nom affiché de la récompense (tel que défini dans la [configuration de la récompense](/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| Source de la récompense | Décrit ce qui a déclenché la récompense (par ex., *Parrainage*, *Objectif*, *Manuel*, *API*). |
| Type Fuel Tank | Le type de fonds de récompense utilisé (si l’intégration FuelTank est utilisée). Par ex., *Prépayé*, *Carte cadeau*. |
| Code Fuel Tank | Le code associé à la distribution externe (par ex., code de bon ou de carte cadeau). |
| ID du programme | ID du programme Advocate sous lequel la récompense a été attribuée. |
| Clé de récompense du programme | Identifiant interne pour la configuration de récompense spécifique utilisée dans le programme. |
| Clé de récompense globale | Identifiant inter-programmes pour les récompenses configurées au niveau global (le cas échéant). |
| **Horodatages de la récompense** | |
| Date de création | Quand l’enregistrement de la récompense a été créé dans le système. |
| Date prévue pour | Quand la récompense était programmée pour être attribuée (par ex., après un délai ou une période d’attente). |
| Date d’attribution | Quand la récompense a effectivement été attribuée au participant. |
| Date d’expiration | La date d’expiration de la récompense (le cas échéant). |
| Date d’annulation | La date à laquelle la récompense a été annulée ou rendue invalide. |
| Date d’échange | La date à laquelle le participant a utilisé la récompense (le cas échéant). |
| Date de modification | La date à laquelle la mise à jour la plus récente de l’enregistrement de la récompense a été effectuée. |
| **Suivi du crédit et de la valeur** | |
| Crédit attribué | Le montant de crédit attribué à cette récompense (peut différer de la valeur dans certains modèles). |
| Crédit utilisé | Le montant de crédit qui a été utilisé à partir de la récompense. |
| Valeur disponible | La partie restante non utilisée ou non réclamée de la récompense. |
| **État de la récompense et messagerie** | |
| États | État actuel de la récompense (par ex., *En attente*, *Planifiée*, *Attribuée*, *Expiré*, *Annulé*). |
| meta.status | État technique ou système (utile pour le diagnostic ou la gestion des erreurs). |
| meta.message | Message lié à la livraison de la récompense (par ex., « Récompense livrée avec succès »). |
| meta.message interne | Notes internes réservées aux administrateurs (par ex., explications d’échec ou indicateurs). |
| meta.date Modifiée | Dernière fois que les métadonnées liées à la récompense ont été mises à jour. |
| meta.customMeta.testMeta | Un espace réservé pour tous les champs de métadonnées personnalisées envoyés par votre programme (dans ce cas, testMeta est un exemple). |
| **Informations sur le participant (utilisateur)** | |
| user.id | ID de l’utilisateur recevant la récompense. |
| user.account Id | L’ID de compte associé à l’utilisateur dans Advocate. |
| user.first Name
user.last Name
user.email
| Informations de base sur le participant incluses à titre de référence ou pour la correspondance CRM. |
| **Contexte du parrainage (si la récompense est basée sur un parrainage)** | |
| referral.id | L’ID du parrainage qui a déclenché cette récompense. |
| referral.date Début du parrainage | Quand l’action de parrainage a commencé (par ex., événement de clic ou de partage). |
| referral.date Modifiée | Quand l’enregistrement du parrainage a été mis à jour pour la dernière fois. |
| referral.code de parrainage utilisé | Le code utilisé par l’utilisateur parrainé pour rejoindre ou effectuer une action. |
| **Informations sur l’utilisateur parrainé (ami)** | |
| referral.referred User.id | ID de la personne qui a été parrainée (l’« ami »). |
| referral.referred User.account Id | L’ID de compte unique du parrain. |
| referral.referred User.first Name
referral.referred User.last Name
referral.referred User.email
| Les coordonnées de base du parrain. |
| **Informations sur le parrain (Advocate)** | |
| referral.referrer User.id | ID de la personne qui a effectué le parrainage (l’« ambassadeur »). |
| referral.referrer User.account Id | L’ID de compte unique du parrain. |
| referral.referrer User.first Name
referral.referrer User.last Name
referral.referrer User.email
| Les coordonnées de base du parrain. |
| referral.date Converted | La date à laquelle le parrainage a officiellement abouti (par ex., inscription ou achat terminé), déclenchant la récompense. |
#### Historique des parrainages
Le *Historique des parrainages* le rapport fournit un enregistrement de l’état de chaque connexion de parrainage effectuée dans votre programme de parrainage. Ces informations peuvent être utiles pour vérifier le succès de votre programme et suivre le nombre de nouveaux clients apportés par votre programme.
Détails du rapport
Par défaut, le rapport inclut :
* Détails de l’ami parrainé comme le nom, l’ID utilisateur et compte, l’adresse e-mail, et plus encore
* Détails de l’ambassadeur client comme le nom, l’ID utilisateur et compte, l’adresse e-mail, et plus encore
* État du parrainage
* État de modération
* IDs de récompense
Une liste complète des champs est disponible lors du [téléchargement de notre CSV d’exemple](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv)  rapport d’activité de parrainage.
**Référence des colonnes du rapport**
| Colonne | Description |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Métadonnées de parrainage** | |
| ID | Identifiant unique de l’enregistrement de parrainage dans Advocate. |
| Date de modification | La date la plus récente à laquelle une partie quelconque de l’enregistrement de parrainage a été mise à jour. |
| Date de début du parrainage | Quand le parrainage a été initié pour la première fois (par ex., lorsque l’utilisateur parrainé a cliqué sur un lien de parrainage). |
| Date de conversion | Quand le parrainage a abouti, généralement lorsque l’utilisateur parrainé a effectué l’action requise (comme une inscription ou un achat). |
| Date de modification de l’utilisateur | La dernière fois que les données utilisateur impliquées dans ce parrainage (parrain ou parrainé) ont été mises à jour. |
| ID du programme | L’ID du programme de parrainage Advocate auquel appartient ce parrainage. |
| Nom du programme | Le nom du programme de parrainage, utile si vous gérez plusieurs programmes. |
| **Informations sur l’ami parrainé (nouveau client)** | |
| E-mail de l’utilisateur parrainé
Prénom de l’utilisateur parrainé
Nom de l’utilisateur parrainé
| Informations d’identité de base de l’utilisateur parrainé. |
| Code de parrainage de l’utilisateur parrainé | Le code de parrainage attribué à l’utilisateur parrainé (au cas où il pourrait aussi parrainer d’autres personnes plus tard). |
| Première IP vue de l’utilisateur parrainé
Dernière IP vue de l’utilisateur parrainé
| Adresses IP enregistrées lors de la première et de la plus récente activité de l’utilisateur parrainé. |
| URL de l’image de l’utilisateur parrainé | URL de l’image ou de l’avatar, si elle a été capturée ou attribuée à l’utilisateur parrainé. |
| Paramètres régionaux de l’utilisateur parrainé | Paramètre de langue/région (par ex., *en-US*, *fr-FR*) de l’utilisateur parrainé. |
| Date de création de l’utilisateur parrainé | La date à laquelle le compte de l’utilisateur parrainé a été créé dans Advocate. |
| Utilisateur parrainé | ID interne de l’utilisateur parrainé dans le système Advocate. |
| Compte parrainé | ID de compte interne lié à l’utilisateur parrainé (utilisé dans les programmes multi-comptes). |
| **Informations sur le parrain (ambassadeur client)** | |
| E-mail de l’utilisateur parrain
Prénom de l’utilisateur parrain
Nom de l’utilisateur parrain
| Informations d’identité de base du participant qui parraine. |
| Code de parrainage de l’utilisateur parrain | Le code de parrainage appartenant au parrain, code que l’utilisateur parrainé a probablement utilisé. |
| Première IP vue de l’utilisateur parrain
Dernière IP vue de l’utilisateur parrain
| Adresses IP enregistrées lors de la première et de la plus récente activité du parrain. |
| URL de l’image de l’utilisateur parrain | L’URL de l’image ou de l’avatar du parrain. |
| Paramètres régionaux de l’utilisateur parrain | Paramètre régional du parrain. |
| Date de création de l’utilisateur parrain | Quand le parrain a rejoint pour la première fois ou a été enregistré dans le système. |
| Utilisateur parrain | ID interne du parrain dans Advocate. |
| Compte du parrain | ID de compte associé au parrain. |
| **Modération et état** | |
| Statut de modération | Statut global de modération du parrainage. (p. ex., *Approuvée*, *Refusé*, *En attente*.) |
| Date de modération | La date à laquelle la décision de modération (approbation/rejet) a été prise. |
| Date de paiement du parrainage | Quand toute récompense associée a été versée pour le parrainage. |
| Date de fin du parrainage | Quand l'enregistrement du parrainage a été officiellement clôturé (p. ex., en raison de l'expiration ou de l'achèvement). |
| Statut de modération du filleul | Statut de modération propre à la partie du filleul dans le parrainage. |
| Statut de modération du parrain | Statut de modération propre à la partie du parrain dans le parrainage. |
| **Références de récompense** | |
| Récompense du filleul | L'ID ou la référence de récompense attribué(e) à l'utilisateur filleul (le cas échéant). |
| Récompense du parrain | L'ID ou la référence de récompense attribué(e) au parrain (le cas échéant). |
#### Soldes de récompenses par utilisateur
Le *Soldes de récompenses par utilisateur* ce rapport fournit un relevé des récompenses en attente, incluant la valeur et le destinataire prévu, qui ont été générées via votre programme de parrainage. Ce rapport est souvent utilisé dans le cadre de l'attribution manuelle des récompenses, ou dans le cadre d'un traitement par lot vers un système comme Tango Card. Il peut également être utile pour suivre combien votre programme de parrainage a versé sur une période donnée.
Détails du rapport
Par défaut, le rapport inclut :
* Détails du participant tels que le nom, l'ID utilisateur et l'ID du compte, l'adresse e-mail, et plus encore
* Type de récompense
* Unité de récompense
* Montant de la récompense
Une liste complète des champs est disponible lors du [téléchargement de notre CSV d’exemple](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv)  rapport des soldes de récompenses.
**Référence des colonnes du rapport**
| Colonne | Description |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informations du participant** | |
| ID utilisateur | L'identifiant unique du participant dans Advocate. Utilisé pour relier le solde de récompense à l'utilisateur individuel. |
| ID de compte | L'ID de compte interne associé au participant. Particulièrement pertinent si les utilisateurs appartiennent à des organisations ou à des groupes de comptes segmentés. |
| E-mail | L'adresse e-mail du participant. Souvent utilisée pour l'attribution manuelle des récompenses ou la synchronisation avec des systèmes externes. |
| Prénom
Nom
| Le prénom et le nom du participant. Utile pour la personnalisation ou le filtrage lors du traitement des récompenses. |
| Code de parrainage | Le code de parrainage attribué au participant. C'est ce qu'il partage pour parrainer d'autres personnes et suivre l'éligibilité aux récompenses. |
| **Informations sur la récompense** | |
| Type | La catégorie ou la méthode de récompense (p. ex., *Espèces*, *Carte cadeau*, *Points*, *Personnalisé*). Aide à déterminer comment les récompenses doivent être attribuées ou regroupées. |
| Unité | L'unité de la valeur de la récompense (p. ex., *USD*, *ZAR*, *Points*, *%*). Important pour calculer les soldes et pour la gestion des versements régionaux. |
| Montant | Le solde total disponible des récompenses en attente pour cet utilisateur. C'est le chiffre principal utilisé lors de la préparation des paiements ou des exportations. |
| Crédit total attribué | Le montant total de crédit qui a été attribué à cet utilisateur à un moment quelconque (quel que soit son échange). Reflète le coût global du programme alloué à ce participant. |
| Crédit total échangé | La part totale des récompenses que ce participant a déjà échangée. Utile pour l'audit des coûts réels par rapport aux passifs. |
| Crédit total expiré | Récompenses totales attribuées à l'utilisateur mais expirées avant d'avoir été échangées. Aide à suivre les récompenses non réclamées ou les occasions de traitement perdues. |
| **Métadonnées utilisateur** | |
| URL de l'image | URL de l'image de profil ou de l'avatar du participant (si collectée). Principalement esthétique ou utilisée dans les tableaux de bord destinés aux utilisateurs, le cas échéant. |
| Première IP vue | La première adresse IP enregistrée lorsque le participant a été ajouté ou est devenu actif. Utile pour la conformité, le géomarquage ou l'analyse de fraude. |
| Dernière IP vue | L'adresse IP la plus récente associée au participant. Aide à déterminer si l'utilisateur est toujours actif ou engagé. |
| Date de création | La date de création du compte du participant dans Advocate. Utile pour l'analyse de cohorte ou de l'évolution du comportement de récompense dans le temps. |
| Source du parrainage | La source ou le canal d'origine par lequel le participant a été acquis (p. ex., *e-mail*, *organique*, *partner*). Aide à évaluer la portée et l'efficacité du programme de parrainage par canal. |
| Paramètres régionaux | La langue et le paramètre régional du participant (p. ex., *en-US*, *fr-FR*). Important pour des communications personnalisées ou des options de récompense régionales. |
#### Soldes de récompenses disponibles par utilisateur
Le *Soldes de récompenses disponibles par utilisateur* ce rapport fournit une liste des récompenses non échangées. Ce type de rapport est destiné à être utilisé dans le cadre de l'attribution des récompenses via le [rachat groupé des récompenses](/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) processus.
Détails du rapport
Par défaut, le rapport inclut :
* Détails du participant tels que le nom, l'ID utilisateur et l'ID du compte, l'adresse e-mail, et plus encore
* Unité de récompense
* Devise de la récompense
* Montant disponible
Une liste complète des champs est disponible lors du [téléchargement de notre CSV d’exemple](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv)  dans le rapport des soldes de récompenses disponibles.
{% hint style="info" %}
**Remarque**: Ce rapport n'inclut pas de détails sur les récompenses de remise en pourcentage, de réservoir de carburant ou de carte-cadeau. Utilisez le *Soldes de récompenses par utilisateur* rapport pour plus de détails sur ces types de récompenses.
{% endhint %}
**Référence des colonnes du rapport**
| Colonne | Description |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informations du participant** | |
| Prénom | Le prénom du participant, utilisé pour l'identification ou la personnalisation lors du traitement des récompenses. |
| Nom | Le nom de famille du participant. |
| E-mail | L'adresse e-mail du participant, utilisée pour envoyer les récompenses ou faire correspondre les données avec des systèmes externes comme un CRM ou un fournisseur de récompenses. |
| ID utilisateur | L'identifiant unique attribué au participant dans Advocate. |
| ID de compte | L'ID de compte interne lié au participant. |
| Segments | Étiquettes ou catégories utilisées pour [grouper les participants](/brand/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) (p. ex., *par région*, *étape du cycle de vie*, *type de client*). Utiles pour filtrer ou appliquer différentes règles de traitement. |
| **Statut et calendrier des récompenses** | |
| Date de blocage | La date à laquelle l'utilisateur a été empêché de recevoir des récompenses, le cas échéant. Un statut bloqué peut empêcher l'échange ; ce champ indique quand ce blocage a été appliqué. |
| **Données de récompense** | |
| Nom de l'unité | L'intitulé ou le nom affiché de l'unité de récompense (p. ex., *Espèces de parrainage*, *Crédit en magasin*). Cela aide à distinguer plusieurs types de récompenses qu'un programme peut proposer. |
| Devise | Le code de devise de la valeur de la récompense (p. ex., *USD*, *ZAR*, *EUR*). Nécessaire lors de l'attribution des récompenses, en particulier entre différents pays ou systèmes de paiement. |
| Valeur disponible | Le montant de récompense non échangée actuellement disponible pour ce participant. C'est la valeur principale utilisée pour déterminer ce qui doit être versé. |
| Valeur à échanger | La valeur actuellement en file d'attente pour échange (p. ex., en attente dans une attribution groupée ou en attente de traitement). Utile pour éviter un double échange ou garantir l'absence de chevauchement dans les échanges. |
| Valeur totale échangée | La valeur totale des récompenses que ce participant a déjà échangées. Donne un aperçu des échanges passés et peut être utile pour le suivi des plafonds de récompenses |
| Unité | Le code interne ou système de l'unité de récompense (p. ex., *USD*, *points*, etc.). Peut être utilisé dans les appels API ou la logique interne lors de l'attribution. |
#### Rapport fiscal américain W-9
Le rapport fiscal américain W-9 affiche le statut fiscal W-9 des participants ainsi que les récompenses gagnées ou en attente par année.
Détails du rapport
Par défaut, le rapport inclut :
* Détails du participant tels que le nom, l'ID utilisateur et l'ID du compte, l'adresse e-mail, et plus encore
* Date à laquelle le formulaire W-9 du participant a été marqué comme collecté
* Valeur imposable aux États-Unis des récompenses gagnées par année fiscale
* Nombre total de récompenses gagnées par chaque participant au cours de l'année fiscale
**Référence des colonnes du rapport**
| Colonne | Description |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informations du participant** | |
| ID utilisateur | L'identifiant unique du participant dans Advocate. |
| ID de compte | ID de compte interne associé au participant. |
| E-mail | L’adresse e-mail du participant. |
| Prénom | Le prénom du participant. |
| Nom | Le nom de famille du participant. |
| **Informations fiscales W-9** | |
| Date de soumission du formulaire fiscal américain
AAAA-MM-JJ
| La date à laquelle le formulaire W-9 du participant a été marqué comme soumis et collecté dans Advocate. Importante pour la conformité IRS et la vérification du statut des documents fiscaux. |
| **Résumé de l'année fiscale** | |
| Année | L'année fiscale au cours de laquelle le participant a gagné des récompenses. Utilisée pour regrouper les gains par année civile pour le traitement 1099. |
| Valeur imposable aux États-Unis en cents | Valeur totale des récompenses imposables aux États-Unis gagnées par ce participant pendant l'année fiscale spécifiée, exprimée en cents (p. ex., 2500 = 25,00 $). Aide pour les calculs bruts ou les intégrations où la précision est requise. |
| Valeur imposable aux États-Unis en dollars | Identique au-dessus, mais affichée au format dollar standard (p. ex., 25,00). Plus facile à examiner ou à inclure dans des résumés officiels. |
| Nombre de récompenses | Nombre total d'instances de récompense individuelles gagnées par le participant au cours de l'année fiscale spécifiée. Utile pour les pistes d'audit ou pour comprendre la fréquence des récompenses et l'engagement dans le programme. |
#### Paiements et fiscalité
Le *Paiement et fiscalité* ce rapport affiche le statut fiscal des participants ainsi que les récompenses gagnées ou en attente par année.
Si votre programme verse des paiements en espèces aux participants, certains champs liés au statut du formulaire fiscal du participant seront disponibles.
Détails du rapport
Par défaut, le rapport inclut :
* Détails du participant tels que le nom, l'ID utilisateur et l'ID du compte, l'adresse e-mail, et plus encore
* Date à laquelle le formulaire fiscal du participant — comme un W-8 ou un W-9 — a été marqué comme soumis
* Valeur imposable aux États-Unis des récompenses gagnées par année fiscale
* Nombre total de récompenses gagnées par chaque participant au cours de l'année fiscale
* Le statut du formulaire fiscal, p. ex., *valide*, *en attente*, ou *en attente*. Les raisons du blocage des paiements sont également incluses dans le rapport
**Référence des colonnes du rapport**
| Colonne | Description |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informations du participant** | |
| ID utilisateur | L'identifiant unique du participant dans Advocate. |
| ID de compte | L'ID de compte du participant, utilisé pour le regroupement ou les rapports organisationnels. |
| E-mail | L’adresse e-mail du participant. |
| Prénom | Le prénom du participant. |
| Nom | Le nom de famille du participant. |
| **Informations fiscales W-9** | |
| Date de soumission du formulaire fiscal américain
AAAA-MM-JJ
| La date à laquelle le participant a soumis son formulaire W-9 (ou le formulaire fiscal américain pertinent). Importante pour vérifier l'éligibilité fiscale avant d'émettre des paiements en espèces. |
| **Résumé de l'année de paiement** | |
| Année | L'année civile au cours de laquelle le participant a gagné les récompenses. |
| Valeur | Valeur totale des paiements en unités mineures (p. ex., cents) gagnés ou en attente pour ce participant au cours de l'année. Par exemple, 1750 = 17,50 $. |
| Valeur en dollars | Même valeur, affichée au format monétaire standard pour une consultation facile (p. ex., 17,50). |
| Nombre | Nombre total d'instances individuelles de récompense de paiement pour le participant au cours de l'année spécifiée. Utile pour comprendre à quelle fréquence un participant a gagné des paiements. |
| **Éligibilité et statut des paiements** | |
| Blocage des paiements | Indique si les paiements du participant sont actuellement bloqués (Oui ou Non). Les paiements peuvent être bloqués en raison de formulaires fiscaux manquants ou d'une configuration incomplète. |
| Raisons du blocage des paiements | Explique pourquoi le participant est en blocage des paiements (le cas échéant). Exemples de raisons : *Formulaire fiscal manquant*, *Informations bancaires non fournies*, *Examen de conformité*. |
| Devise du paiement | La devise dans laquelle les paiements du participant sont ou seront traités (p. ex., *USD*, *EUR*, *ZAR*). Important pour les systèmes de paiement mondiaux et la comptabilité. |
| Configuration du paiement commencée | Indique si le participant a commencé à configurer sa méthode de paiement (p. ex., via une intégration de prestataire de paiement). Aide à suivre la progression de l'onboarding ou les besoins de relance pour les paiements en attente. |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.