Requis : plugin Charitable Pro 1.8.16+
Plan Pro et supérieur

Vous voulez savoir si vos récompenses rapportent des cadeaux et si des colis attendent d'être envoyés ? La Vue d'ensemble des récompenses répond aux deux sur un seul écran.

Ce guide couvre la bannière d'attention, les tuiles des chiffres clés, le graphique, les vérifications de l'état des récompenses, les tableaux et comment extraire vos données.

En le consultant régulièrement, aucun donateur n'attend trop longtemps pour une récompense qu'il a gagnée.

Charitable Rewards nécessite la version 1.8.16 ou supérieure du plugin Charitable Pro, sur le plan Pro et supérieur.

Ce que contient ce guide ?

Regarder la vidéo

Si vous préférez regarder plutôt que lire, cette courte vidéo présente la Vue d'ensemble des récompenses.

Trouver la Vue d'ensemble

Pour l'ouvrir, allez dans Caritatif » Récompenses » Vue d'ensemble dans votre administration WordPress.

C'est l'onglet par défaut, donc l'ouverture des Récompenses vous amène ici.

Ce qui nécessite votre attention

La bannière en haut est la chose la plus utile de la page. Elle vous indique les informations suivantes en langage clair.

• Combien de récompenses sont en attente de réalisation et depuis combien de temps la plus ancienne attend
• Combien de réclamations sont signalées pour un examen manuel

Chacune est accompagnée d'un lien direct vers une liste filtrée de réclamations. Vous passez ainsi de « 5 choses à expédier » à la liste de ces 5 choses en 1 clic.

Les chiffres clés

Il y a 6 tuiles, et toutes suivent la plage de dates sélectionnée.

Tuile	Signifie
Réclamations confirmées	Récompenses gagnées pendant la période
En attente de traitement	Récompenses confirmées et toujours dues, avec la date la plus ancienne
Revenus attribués aux récompenses	La valeur du don pour les cadeaux qui ont réclamé une récompense
Remboursé	Réclamations sur les dons remboursés
Juste valeur marchande totale	La juste valeur marchande combinée réclamée
Total déductible	La partie déductible combinée

Les 2 derniers n'apparaissent que lorsque la réception fiscale est activée.

Revenus attribués aux récompenses est le chiffre que les gens lisent le plus souvent mal. Il s'agit du total des dons pour les cadeaux qui ont généré une récompense, et non de la valeur des récompenses elles-mêmes, ni des revenus que les récompenses ont *causés*.

Considérez-le comme « l'argent qui est entré en même temps qu'une réclamation de récompense ».

Le graphique

Récompenses au fil du temps trace les réclamations sur la période, avec 1 ligne par récompense. Vous pouvez voir quels avantages les donateurs choisissent et quand.

Un pic après l'envoi d'un e-mail vous indique que l'e-mail a fonctionné.

Avec une courte période et peu de réclamations, le graphique semble clairsemé. Ce sont les données, pas un défaut.

État des récompenses

Ce panneau effectue 4 vérifications de santé. Chacune est soit claire, soit vous indique ce qui ne va pas.

Vérifier	Surveille
Exécution	Réclamations physiques confirmées sans adresse de livraison, qui ne peuvent pas être expédiées
Téléchargements	Si le stockage protégé est accessible en écriture
Reçus fiscaux	Si la juste valeur marchande est enregistrée et divulguée
Inventaire	Récompenses sur le point d'être épuisées

La vérification du traitement est la plus importante. Une réclamation physique sans adresse est difficile à repérer ailleurs, et ce panneau les compte et vous y renvoie.

Les tableaux

Vous verrez 4 onglets sous le graphique.

• Réclamations récentes affiche l'activité la plus récente, avec le donateur et le statut.
• Meilleures récompenses montre quelles récompenses sont les plus réclamées.
• Par campagne indique quelles campagnes génèrent des demandes de récompense.
• Niveaux indique les performances par niveau de don, lorsque les niveaux sont utilisés.

Mix de récompenses est affiché à côté et détaille les demandes par type. En un coup d'œil, vous pouvez voir si vous gérez un programme de reconnaissance ou une opération d'expédition.

Plages de dates

Tout suit le sélecteur de plage en haut. Les préréglages couvrent les fenêtres habituelles, et une plage personnalisée ouvre un calendrier.

La plage par défaut est le mois en cours, donc les demandes plus anciennes sont exclues. Si le tableau de bord semble plus vide que prévu, élargissez la plage avant de décider que quelque chose ne va pas.

Extraire les données

Exporter	Vous donne
CSV par tableau	Chaque tableau a son propre téléchargement, limité à la plage actuelle
CSV des demandes	Depuis l'onglet Demandes, avec les filtres appliqués et les colonnes fiscales activées
CSV du catalogue	La bibliothèque de récompenses elle-même
Résumé PDF	Un instantané du tableau de bord sur 1 page

Note importante. Le téléchargement PDF nécessite la version 1.8.19 ou plus récente du plugin Charitable Pro, car il repose sur des éléments PDF et graphiques qui sont arrivés dans cette version. Sur une version plus ancienne, le bouton explique cela plutôt que de ne rien faire silencieusement.

Les exportations CSV bloquent l'injection de formules. Une récompense nommée avec un = en préfixe ne peut pas être exécutée comme une formule lorsque le fichier est ouvert dans une feuille de calcul.

Rapport de performance par récompense

Au-delà du tableau de bord, Récompenses ajoute un rapport à la propre zone Rapports de Charitable. Les performances des récompenses sont affichées à côté de vos autres rapports, avec leur propre exportation CSV.

Vous le trouverez dans Charitable » Rapports.

Journaux et informations système

L'activité des récompenses est enregistrée dans le journal de Charitable. C'est l'endroit à consulter lorsque quelque chose ne s'est pas produit et que vous avez besoin de savoir pourquoi, comme un e-mail qui n'a pas été envoyé ou une demande qui n'a pas été confirmée.

Vous le trouverez dans Charitable » Outils » Journaux.

Une section Récompenses est également ajoutée aux Informations système. Elle signale la version de Récompenses, les paramètres, l'état des tables et les décomptes, alors incluez-la lorsque vous ouvrez un ticket de support.

Vous le trouverez dans Charitable » Outils » Informations système.

Conseils à garder à l'esprit

Ces habitudes maintiennent l'aperçu utile semaine après semaine.

• Vérifiez d'abord la bannière d'attention, puis les tuiles. La bannière est la partie qui vous dit quoi faire ensuite.
• Lorsqu'un nombre semble incorrect, élargissez la plage de dates à 'Toute la vie' avant de supposer que quelque chose est cassé.
• Exportez le CSV des demandes comme liste d'emballage plutôt que de travailler à partir de l'écran.
• Si le contrôle de préparation signale des demandes bloquées, corrigez-les avant une session d'emballage. Une liste filtrée qui suppose qu'une adresse existe ne les affichera pas.

FAQ sur le reporting des récompenses

Pourquoi ma Vue d'ensemble semble-t-elle vide ?

La plage par défaut est le mois en cours, donc les demandes plus anciennes sont exclues. Élargissez la plage de dates et les demandes plus anciennes apparaîtront.

Pourquoi ne vois-je pas les tuiles FMV total et Déductible total ?

Ces 2 tuiles n'apparaissent que lorsque la gestion des reçus fiscaux est activée.

Pourquoi ne puis-je pas télécharger le résumé PDF ?

Le PDF nécessite la version 1.8.19 ou plus récente du plugin Charitable Pro. Sur une version plus ancienne, le bouton l'explique.

Référence développeur

Filtres

Filtre	Objectif
charitable_rewards_overview_range_presets	La liste des préréglages de plage de dates
charitable_rewards_overview_empty_state_html	Marque affichée lorsqu'il n'y a rien à signaler
charitable_rewards_admin_tabs	La liste des onglets Récompenses
charitable_rewards_admin_tab_badges	Compter les badges sur les onglets
charitable_rewards_reports_overview_stat	Une statistique dans l'intégration Rapports
charitable_reports_advanced_report_strings	Libellés des rapports dans le framework de rapports de Pro
charitable_reports_advanced_report_type_filter_values	Valeurs du filtre de type de rapport

Données de la Vue d'ensemble

Charitable_Rewards_Overview_Data gère toutes les requêtes derrière le tableau de bord, couvrant les décomptes de statut, les totaux des revenus, les totaux des taxes, la série chronologique et les tableaux principaux.

Il est réservé à l'administration et n'est pas chargé sur le front-end ou sous WP-CLI, donc l'appeler à partir d'un script CLI échouera avec une classe manquante.

Les totaux des taxes dérivent le montant déductible en SQL des valeurs marchandes justes figées plutôt que de lire une colonne stockée. Voir Gestion des reçus fiscaux.

Exportation PDF

L'action PDF est charitable_rewards_download_overview_pdf. Elle est limitée à Pro 1.8.19, qui a introduit les éléments PDF et image de graphique dont elle dépend.

Exemples de personnalisation

Ajouter un préréglage "6 derniers mois" au sélecteur de plage.

add_filter( 'charitable_rewards_overview_range_presets', function ( $presets ) {
    $presets['last_6_months'] = __( 'Last 6 months', 'your-textdomain' );
    return $presets;
} );

Remplacer le message d'état vide.

add_filter( 'charitable_rewards_overview_empty_state_html', function () {
    return '<p>' . esc_html__( 'No reward claims yet. Attach a reward to a campaign to get started.', 'your-textdomain' ) . '</p>';
} );

En résumé

Vous savez maintenant comment lire l'aperçu des récompenses, agir sur la bannière d'attention, vérifier la santé de vos récompenses et exporter vos données.

Si vous êtes bloqué à une étape, notre équipe de support est heureuse de vous aider.

Vous pourriez aussi vouloir lire

Ces guides couvrent les écrans vers lesquels l'aperçu vous dirige.

• Réclamations et exécution. Traitez les réclamations vers lesquelles la bannière d'attention vous dirige.
• Gestion des reçus fiscaux et valeur marchande juste. Apprenez d'où proviennent les chiffres des 2 tuiles fiscales.
• Création de récompenses. Définissez les limites de stock que le panneau de statut surveille.