Ambassadors ajoute un bouton Télécharger le CSV à plusieurs endroits dans l’administration. Cette page explique où se trouve chaque bouton, à quoi il sert, et fournit un dictionnaire complet des colonnes pour chaque exportation afin que vous sachiez exactement ce que vous manipulez.

Que vous extraiez des données pour un rapport de conseil d’administration, importiez des enregistrements d’ambassadeurs dans un CRM, ou conserviez simplement une trace écrite de vos décisions de modération, ceci est votre référence.

Requis : Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Comment exporter vos données

Chaque exportation CSV dans Ambassadors fonctionne de la même manière : trouvez la section souhaitée, cliquez sur le bouton Télécharger le CSV, et le fichier est téléchargé immédiatement. Il n’y a pas d’écran d’exportation séparé ni de file d’attente à attendre. Voici où se trouve chaque bouton et à quoi il sert.

Exportations du tableau de bord de présentation

Allez dans Charitable » Ambassadeurs » Présentation. Plusieurs sections de cet écran ont leur propre bouton Télécharger le CSV, et chacune exporte les données pour la plage de dates que vous avez actuellement sélectionnée. Ajustez d’abord la plage de dates, puis cliquez sur exporter, et le fichier reflétera exactement ce que vous voyez à l’écran.

• Résumé des KPI : Les six chiffres clés (Montant collecté, Dons, Donateurs, etc.) plus les pourcentages de tendance par rapport à la période précédente. Utile pour les rapports de conseil d’administration ou les instantanés mensuels.
• Dons au fil du temps : Les mêmes données que celles du graphique principal, réparties par intervalles de dates. Idéal pour tracer les tendances dans une feuille de calcul.
• Meilleurs collecteurs de fonds : Une liste classée de vos collecteurs de fonds les plus performants avec la progression de leurs objectifs et le nombre de donateurs.
• Meilleurs ambassadeurs : Récapitulatif par personne des montants collectés et du nombre de collecteurs de fonds. Utile pour reconnaître les meilleurs performeurs.
• Meilleurs parents : Quelles campagnes parentales génèrent le plus d’activité. Utile pour décider où concentrer vos efforts.
• Journal de recrutement / Meilleurs recruteurs : Uniquement disponible lorsque les Invitations sont activées. Indique qui a recruté qui et comment vos meilleurs invités performent.

Exportation de modération

Allez dans Charitable » Ambassadeurs » Modération et sélectionnez la vue que vous souhaitez exporter (En attente, Action requise, Rejeté ou Approuvé). Le bouton Télécharger le CSV exporte la vue actuellement active. Ceci est utile pour les audits, les transferts entre modérateurs, ou pour conserver un enregistrement des candidatures rejetées.

Exportations de répertoire

Allez dans Charitable » Ambassadeurs » Répertoire. L’exportation au niveau de la liste télécharge tous les ambassadeurs de votre vue filtrée actuelle, y compris leurs statistiques à vie, leur statut de vérification et qui les a recrutés. Vous pouvez également ouvrir le profil d’un ambassadeur individuel et exporter uniquement son historique de dons depuis l’onglet Dons de cette page de profil.

Exportations d’invitations

Allez dans Charitable » Ambassadeurs » Invitations. Vous y trouverez deux exportations : un journal d’activité chronologique de chaque événement lié aux invitations, et un classement de vos meilleurs recruteurs. Les deux reflètent la plage de dates actuellement sélectionnée.

Exportation des dons par ambassadeur

Celle-ci est destinée à vos ambassadeurs eux-mêmes, pas aux administrateurs. Lorsque vous activez le paramètre Autoriser l’exportation de l’historique des dons, chaque ambassadeur voit une option d’exportation des dons sur sa page Mes campagnes. Ils peuvent télécharger l’historique des dons pour leurs propres collectes de fonds uniquement. Les adresses e-mail des donateurs sont exclues par défaut, sauf si vous l’activez explicitement.

---

Ce que chaque exportation a en commun

Avant de vous plonger dans les détails des colonnes, voici quelques points communs à toutes les exportations CSV produites par Ambassadors :

Garantie	Remarques
Sécurisé contre l’injection de formules	Chaque cellule commençant par =, +, -, @, une tabulation ou un retour chariot est précédée d’une apostrophe afin qu’Excel ne l’interprète pas comme une formule. Défense OWASP standard.
Plafond de 10 000 lignes	Par défaut par exportation. Filtrable via charitable_ambassadors_<surface>_csv_max_rows. Les exportations plus volumineuses doivent être divisées par plage de dates.
Encodé en UTF-8	Inclut le BOM afin qu’Excel affiche correctement les caractères accentués sous Windows.
La première ligne est l’en-tête	Noms de colonnes en anglais simple.
Pas d’informations personnelles identifiables (PII) sauf si vous optez pour.	Les noms des donateurs anonymes apparaissent par défaut sous « Anonyme ». Le paramètre d’exportation des détails des donateurs anonymes du répertoire modifie cela, et les exportations étiquetées comme surfaces « propriétaire » affichent les noms complets.

Exportations de la vue d’ensemble

Le tableau de bord de la vue d’ensemble comporte des boutons Télécharger CSV dans plusieurs sections. Chacun exporte les données pour la plage de dates actuellement sélectionnée en haut de l’écran.

CSV du résumé des indicateurs clés de performance

Cette exportation vous donne les six chiffres principaux du haut du tableau de bord, ainsi que la façon dont chaque métrique a évolué par rapport à la période précédente de même durée. Idéal pour l’intégrer dans un rapport mensuel ou une diapositive de présentation.

Colonne	Type	Remarques
Métrique	chaîne de caractères	« Montant collecté », « Dons », « Donateurs », etc.
Valeur	nombre à virgule flottante	Valeur numérique pour la période actuelle.
Valeur précédente	nombre à virgule flottante	Valeur pour la période précédente de même durée.
% de tendance	nombre à virgule flottante	Variation en pourcentage. Vide si l'une des valeurs est nulle.
Direction de la tendance	chaîne de caractères	« hausse », « baisse », « stable » ou vide.

CSV des dons au fil du temps

Cette exportation contient les mêmes données groupées qui alimentent le graphique principal de l'écran d'aperçu. Chaque ligne représente un groupe de dates, ce qui facilite la création de vos propres graphiques ou analyses de tendances dans une feuille de calcul.

Colonne	Type	Remarques
Début du groupe	date	Premier jour du groupe (AAAA-MM-JJ).
Fin du groupe	date	Dernier jour du groupe.
Campagnes parentes	nombre à virgule flottante	Montant total en dollars versé aux campagnes parentes dans ce groupe.
Collectes de fonds	nombre à virgule flottante	Montant total en dollars versé aux collectes de fonds dans ce groupe.
Total	nombre à virgule flottante	Somme des deux.

CSV des meilleures collectes de fonds

Une liste classée de vos collectes de fonds les plus performantes pour la période sélectionnée, avec la progression complète de l'objectif et le nombre de donateurs inclus. Utile pour reconnaître les meilleurs performeurs ou partager les résultats avec les organisateurs de campagne.

Colonne	Type	Remarques
Classement	entier	Position basée sur 1 dans la liste principale.
Titre de la collecte de fonds	chaîne de caractères	Le titre de la campagne.
Nom de l'ambassadeur	chaîne de caractères	L'auteur.
Titre parent	chaîne de caractères	La campagne parente à laquelle cela se rapporte.
Collecté	nombre à virgule flottante	Dans la période active.
Objectif	nombre à virgule flottante	Cible statique.
Pourcentage de l'objectif	nombre à virgule flottante	Collecté / Objectif.
Nombre de donateurs	entier	Donateurs uniques dans la période.

Meilleurs ambassadeurs (CSV)

Un total par personne montrant combien chaque ambassadeur a collecté sur toutes ses campagnes de collecte de fonds dans la période sélectionnée. Utile pour les e-mails de classement ou les importations CRM.

Colonne	Type	Remarques
Classement	entier	Basé sur 1.
Nom de l'ambassadeur	chaîne de caractères	Nom d'affichage.
E-mail	chaîne de caractères	Adresse e-mail.
Nombre de campagnes de collecte	entier	Nombre de campagnes de collecte dans la période.
Collecté	nombre à virgule flottante	Total sur toutes leurs campagnes de collecte dans la période.
Nombre de donateurs	entier	Donateurs uniques dans la période.

Meilleurs parents (CSV)

Les données derrière le graphique circulaire de l'écran d'aperçu, montrant quelles campagnes parentales génèrent le plus d'activité de collecte de fonds. Utile pour décider où concentrer les efforts de recrutement ou de promotion.

Colonne	Type	Remarques
Classement	entier	Basé sur 1.
Titre parent	chaîne de caractères	Titre de la campagne parente.
Collecté	nombre à virgule flottante	Dans la période.
Nombre de donateurs	entier	Donateurs uniques dans la période.
Part du total	nombre à virgule flottante	Ce que ce parent a collecté divisé par le total du site.

Journal de recrutement (CSV)

Disponible uniquement lorsque les Invitations sont activées. Cette exportation vous donne un enregistrement chronologique de chaque recrue, de qui l'a recrutée et de son statut actuel.

Colonne	Type	Remarques
Nom de la recrue	chaîne de caractères	L'ambassadeur recruté.
E-mail de la recrue	chaîne de caractères	E-mail.
Nom de l'invitant	chaîne de caractères	Le recruteur.
E-mail de l'invitant	chaîne de caractères	E-mail.
Statut	chaîne de caractères	« Approuvé », « En attente », « Rejeté ».
Recruté le	date et heure	Quand l'attribution a été marquée (AAAA-MM-JJ HH:MM:SS).
Jeton	chaîne de caractères	Le jeton par lequel ils sont arrivés.

CSV des meilleurs recruteurs de recrutement

Un classement de vos parrains les plus actifs, montrant le total des recrues ainsi que les recrues approuvées afin que vous puissiez séparer l'activité des résultats.

Colonne	Type	Remarques
Classement	entier	Basé sur 1.
Nom de l'invitant	chaîne de caractères	Le recruteur.
E-mail de l'invitant	chaîne de caractères	E-mail.
Total des recrues	entier	Tous statuts.
Recrues approuvées	entier	Statut = Approuvé uniquement.

Exportation de modération

Disponible dans l'onglet Modération. L'exportation reflète toujours la vue sur laquelle vous vous trouvez actuellement, alors passez à la vue dont vous avez besoin (En attente, Action requise, Rejeté ou Approuvé) avant de cliquer sur Télécharger le CSV.

Exportation de la file d'attente de modération

Colonne	Type	Remarques
ID de la collecte de fonds	entier	ID de la publication de la campagne.
Titre	chaîne de caractères	Titre de la collecte de fonds.
Nom de l'ambassadeur	chaîne de caractères	Nom d'affichage de l'auteur.
E-mail de l'ambassadeur	chaîne de caractères	E-mail de l'auteur.
Titre parent	chaîne de caractères	Campagne parente.
Statut	chaîne de caractères	En attente / Action requise / Rejeté / Approuvé.
Soumis	date et heure	Première soumission.
Dernière action	date et heure	Horodatage de la dernière entrée du journal d'audit.
Raison / Notes	chaîne de caractères	Raison de rejet la plus récente ou notes de demande de modification.

Exportations de répertoire

Le Répertoire offre deux niveaux d'exportation : une exportation au niveau de la liste pour l'ensemble de votre liste d'ambassadeurs, et une exportation au niveau du profil pour l'historique des dons d'un ambassadeur individuel.

CSV de la liste du répertoire

Ceci exporte tous les ambassadeurs dans la vue que vous consultez actuellement, y compris les filtres que vous avez appliqués. Si vous avez filtré uniquement sur les ambassadeurs vérifiés, c'est ce qui sera exporté. Toutes les colonnes visibles dans le tableau de la liste sont incluses, plus quelques extras.

Colonne	Type	Remarques
ID utilisateur	entier	ID utilisateur WP.
Nom d'affichage	chaîne de caractères
E-mail	chaîne de caractères
Rôles	chaîne de caractères	Rôles WP séparés par des virgules.
Vérifié	bool	« 1 » ou « 0 ».
Total des collectes de fonds	entier	Nombre total de toutes les collectes de fonds.
Collectes de fonds publiées	entier
Collectes de fonds en attente	entier
Collectes de fonds rejetées	entier
Montant collecté à vie	nombre à virgule flottante	Sur toutes leurs collectes de fonds.
Montant collecté depuis le début de l'année	nombre à virgule flottante	Année en cours.
Nombre de donateurs	entier	Donateurs uniques.
Nombre de dons	entier	Dons reçus.
Dernière activité	date et heure
Rejoint	date et heure	user_registered WP.
Recruté par	chaîne de caractères	Nom d'affichage de l'invitant, ou « » si inscription automatique.

CSV des dons du profil du répertoire

Disponible à partir de l'onglet Dons dans la page de profil d'un ambassadeur individuel. Ceci liste chaque don que les collectes de fonds de cet ambassadeur ont reçu, ce qui est utile pour donner à un ambassadeur une image complète de son impact ou pour la tenue de registres de conformité.

Colonne	Type	Remarques
Date	date et heure
Nom du donateur	chaîne de caractères	« Anonyme » sauf si le paramètre de substitution est activé.
Email du donateur	chaîne de caractères	“” si anonyme.
Montant	nombre à virgule flottante
Devise	chaîne de caractères	Code ISO.
Titre de la collecte de fonds	chaîne de caractères	Collecte de fonds qui a reçu le don.
Statut	chaîne de caractères	Terminé / Remboursé / Échoué.

Exportations d'invitations

Disponible dans l'onglet Invitations lorsque les Invitations sont activées.

CSV d'activité récente

Un journal chronologique de chaque événement lié à une invitation dans la plage de dates active, y compris les clics qui n'ont pas abouti à une inscription. Utile pour comprendre où vos liens d'invitation gagnent du terrain et où ils se refroidissent.

Colonne	Type	Remarques
Horodatage	date et heure
Événement	chaîne de caractères	« Cliqué », « Réclamé », « Ignoré auto-recrutement », etc.
Nom de l'invitant	chaîne de caractères
E-mail de l'invitant	chaîne de caractères
Nom de la recrue	chaîne de caractères	“” pour les événements de clic sans réclamation.
E-mail de la recrue	chaîne de caractères	“”.
Jeton	chaîne de caractères
Campagne parente	chaîne de caractères	Campagne ciblée (le cas échéant).

CSV des meilleurs recruteurs

Cette exportation a les mêmes colonnes que le CSV des meilleurs recruteurs de la vue d'ensemble. Elle est affichée ici dans l'onglet Invitations afin que vous puissiez extraire les données des recruteurs sans avoir à revenir à l'écran de la vue d'ensemble. Si vous travaillez déjà dans les Invitations, cela vous évite le déplacement.

Rapport de dons par ambassadeur

Les ambassadeurs peuvent exporter leur propre historique de dons à partir de la page Mes campagnes en utilisant l'action Dons sur chaque carte de collecte de fonds. Ceci est régi par le paramètre Autoriser l'exportation de l'historique des dons, vous gardez donc le contrôle de sa disponibilité.

Les colonnes correspondent au CSV des dons du profil d'annuaire, avec trois différences :

• « Email du donateur » est omis par défaut. Activez Inclure les détails personnels pour les donateurs anonymes dans les paramètres de Mes campagnes pour l'inclure.
• « Devise » est omis car il s'agit toujours d'une exportation à devise unique.
• « Titre de la collecte de fonds » est omis car l'exportation est déjà limitée à une seule collecte de fonds.

Modèle de nom de fichier

Chaque CSV d'ambassadeur suit la même convention de nommage, ce qui permet de retrouver facilement le bon fichier plus tard :

ambassadors-<section>-<start-date>-to-<end-date>.csv

Par exemple :

ambassadors-kpi-summary-2026-01-01-to-2026-12-31.csv
ambassadors-top-fundraisers-2026-05-01-to-2026-05-31.csv
ambassadors-directory-2026-05-30.csv

Les dates dans le nom du fichier correspondent à la fenêtre d'exportation, vous pouvez donc utiliser le nom du fichier lui-même comme clé d'archive sans avoir à ouvrir le fichier.

Limite de lignes

La limite par défaut est de 10 000 lignes par exportation. Si vous atteignez régulièrement cette limite, vous avez deux options : réduire votre plage de dates pour diviser l'exportation en plus petits morceaux, ou augmenter la limite à l'aide du filtre pour cette surface :

add_filter( 'charitable_ambassadors_overview_csv_max_rows', function () {
    return 50000;
} );

add_filter( 'charitable_ambassadors_directory_csv_max_rows', function () {
    return 50000;
} );

add_filter( 'charitable_ambassadors_invitations_csv_max_rows', function () {
    return 50000;
} );

Quelques points à savoir avant d'ouvrir ce CSV

La plupart de ces points ne se présentent qu'une seule fois, mais ce sont le genre de choses qui vous évitent 20 minutes de frustration lorsqu'ils surviennent.

• Utilisez Google Sheets si Excel pose problème. Sheets gère correctement le BOM UTF-8 sur Mac et Linux. Excel sous Windows peut corrompre les caractères accentués même lorsque le BOM est présent, donc si les noms ou les adresses semblent brouillés, essayez Sheets d'abord.
• Enregistrez le fichier avant de l'ouvrir dans Excel. Certaines versions d'Excel sous Windows convertiront automatiquement les colonnes au moment où vous les ouvrez, ce qui peut transformer des ID numériques en dates ou supprimer les zéros non significatifs. Enregistrer le fichier brut d'abord vous donne une solution de repli.
• N'activez les détails des donateurs anonymes que si vous en avez réellement besoin. La plupart des programmes n'ont pas besoin d'exposer des informations personnelles identifiables anonymisées dans leurs exportations, et désactiver ce paramètre signifie moins de données à gérer et à sécuriser.
• Utilisez le nom de fichier comme clé d'archive. La plage de dates est intégrée dans chaque nom de fichier, vous saurez donc toujours quelle période un fichier donné couvre sans avoir à l'ouvrir.

---

Référence développeur

Classes de gestionnaire de CSV

Classe	Gère
Charitable_Ambassadors_Overview_CSV	Exportations du tableau de bord de présentation.
Charitable_Ambassadors_Directory_CSV	Exportations de la liste du répertoire + profils.
Charitable_Ambassadors_Invitations_CSV	Exportations de l'onglet Invitations.

Chaque gestionnaire est appelé via admin-post.php?action=charitable_ambassadors_<surface>_csv avec un argument de requête section et un nonce.

Neutralisation de l'injection de formules

Chaque valeur de cellule passe par :

$value = Charitable_Ambassadors_Overview_CSV::neutralize_csv_cell( $value );

Ceci préfixe une apostrophe à toute chaîne commençant par =, +, -, @, une tabulation ou un retour chariot, suivant la défense recommandée par l'OWASP contre l'injection CSV et l'injection de formules Excel.

Filtres

Filtre	Défaut	Objectif
charitable_ambassadors_overview_csv_max_rows	10000	Plafond des exportations de présentation.
charitable_ambassadors_directory_csv_max_rows	10000	Plafond des exportations du répertoire.
charitable_ambassadors_invitations_csv_max_rows	10000	Plafond des exportations des invitations.
charitable_ambassadors_directory_csv_cell	''	Remplace la valeur pour une colonne personnalisée. Reçoit ('', $col, $user).
charitable_ambassadors_overview_csv_header_<section>	calculé	Modifie la ligne d'en-tête pour une section donnée.
charitable_ambassadors_overview_csv_row_<section>	calculé	Modifier les lignes de données pour une section donnée.

Capacités

Toutes les exportations côté administrateur nécessitent manage_charitable_settings. Le rapport de dons par ambassadeur sur Mes campagnes nécessite que l'utilisateur soit l'post_author de la campagne exportée.

Vous pourriez aussi vouloir lire

Voici les documents Ambassadeurs les plus proches de celui-ci. Marquez ceux qui correspondent à la façon dont vous utilisez vos données et revenez-y lorsque vous avez besoin d'un rappel.

• Tableau de bord – où vivent la plupart de ces exportations et où se fait la sélection de votre plage de dates.
• Annuaire – la liste complète des ambassadeurs, avec ses propres exportations au niveau de la liste et du profil.
• Modération – la file d'attente où vous examinez et approuvez les soumissions de collectes de fonds, avec sa propre exportation par vue.
• Invitations – le système de recrutement derrière les exportations du journal de recrutement et des meilleurs recruteurs.
• Hooks & filtres dans Ambassadeurs – la référence du développeur pour personnaliser le comportement d'exportation.