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

Vous voulez savoir comment un téléchargement numérique ou un article posté parvient réellement à votre donateur ? Deux des 4 types de récompenses nécessitent une livraison, les récompenses numériques étant envoyées par e-mail et les récompenses physiques par courrier.

Ce guide couvre les deux. Il explique les 3 types de récompenses numériques, comment les liens de téléchargement sont protégés et comment Récompenses collecte les adresses d'expédition pour les articles physiques.

Une livraison correcte garantit que les donateurs reçoivent ce qu'ils ont gagné et que vos fichiers restent avec les personnes qui les ont gagnés. Les récompenses de reconnaissance et d'adhésion n'ont pas besoin de livraison, car elles sont enregistrées et c'est tout.

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 vidéo montre une récompense numérique et une récompense physique, de la configuration à la livraison.

Récompenses numériques

Une récompense numérique est un code, un lien ou un fichier. Vous choisissez lequel lors de sa création.

Type	Utiliser pour	Ce que le donateur reçoit
Code	Un code de réduction, un bon ou une clé d'accès	Le code lui-même, dans l'e-mail de livraison
Lien	Quelque chose hébergé ailleurs, comme une vidéo ou un formulaire	L'URL, dans l'e-mail de livraison
Fichier	Un PDF, un pack d'images ou un fichier audio	Un lien de téléchargement protégé

Les fichiers sont protégés

C'est la différence entre un vrai téléchargement et une URL que n'importe qui peut diffuser.

Un fichier téléchargé ne se trouve pas dans votre dossier de téléchargements public, où quelqu'un pourrait deviner l'URL. Il est stocké dans un espace protégé, et le donateur reçoit un lien avec 3 protections.

• Signé. L'URL contient une signature cryptographique liée à ce donateur et à cette récompense. Modifier une partie de celle-ci l'empêche de fonctionner.
• Expirant. Le lien cesse de fonctionner après un délai défini, 7 jours par défaut.
• Limité. Vous pouvez limiter le nombre de fois où le fichier d'une récompense individuelle peut être téléchargé.

Ainsi, un lien qui est transféré après son expiration ne fonctionnera pas. Si un donateur en a besoin à nouveau, renvoyez l'e-mail de livraison plutôt que de chercher une URL de fichier.

Définir une limite de téléchargement

La « Limite de téléchargement » sur une récompense numérique limite le nombre de fois où le fichier peut être téléchargé. Laissez-la vide pour des téléchargements illimités.

Un petit nombre comme 3 ou 5 fonctionne généralement bien. C'est suffisant pour un donateur qui perd le fichier ou change d'appareil, et assez peu pour qu'un lien divulgué ait une valeur limitée.

Ce que les donateurs reçoivent

Lorsqu'une réclamation numérique est confirmée, l'e-mail de livraison numérique de la récompense est envoyé avec le code, le lien ou l'URL de téléchargement.

C'est un e-mail Charitable normal que vous pouvez modifier dans les paramètres des e-mails, vous pouvez donc définir le ton et ajouter vos propres instructions.

Récompenses physiques

Une récompense physique a besoin d'un endroit où aller, donc Rewards collecte une adresse d'expédition sur le formulaire de don lui-même. Les champs n'apparaissent que lorsque le donateur est sur le point de recevoir quelque chose de physique.

Rewards collecte 7 champs.

• Nom
• Adresse
• Adresse ligne 2
• Ville
• État
• Code postal
• Pays

Livraison estimée

Chaque récompense physique peut afficher une estimation du délai de livraison sur la carte de récompense. C'est du texte libre, donc « 4-6 semaines » ou « expédié à temps pour les fêtes » fonctionnent tous les deux.

Nous suggérons de le remplir. La question la plus fréquente concernant une récompense physique est de savoir quand elle arrivera, et y répondre sur le formulaire évite un e-mail.

Les adresses sont enregistrées lors du don

Les détails d'expédition sont stockés par rapport au don, et non à la récompense ou à la réclamation. L'adresse d'un donateur appartient au cadeau, et 1 don qui rapporte 2 récompenses physiques a 1 adresse, pas 2.

En pratique, l'adresse s'affiche sur le dossier de don et sur chaque réclamation associée. La voir nécessite la capacité charitable_view_reward_pii.

Ensuite, c'est un travail de préparation

Une fois la réclamation confirmée, l'article rejoint votre liste de réclamations. Marquez-le comme expédié et enregistrez le transporteur et le numéro de suivi, et Rewards envoie l'e-mail récompense expédiée avec un lien de suivi.

Voir Réclamations et préparation pour les étapes complètes.

Conseils à garder à l'esprit

Ces habitudes protègent vos récompenses et rendent votre boîte de réception plus calme.

• Pour les fichiers, téléchargez-les plutôt que de lier à votre propre médiathèque. Un fichier téléchargé obtient le lien protégé et expirant, et un lien simple vers une URL publique ne le fait pas.
• Définissez une limite de téléchargement, même généreuse. Un lien illimité qui fuit reste illimité pour toujours.
• Remplissez l'estimation de livraison pour tout ce qui est physique. C'est le moyen le moins cher de réduire les e-mails de support.
• Si un donateur dit qu'un lien a expiré, renvoyez l'e-mail de livraison. Envoyer le fichier en pièce jointe ignore le décompte des téléchargements, vos chiffres cessent donc d'être précis.
• La durée de vie par défaut du lien est de 7 jours, ce qui est généreux. Réduisez-la si vos fichiers sont sensibles, et fiez-vous à la limite de téléchargement plutôt qu'à l'horloge pour tout ce qui a de la valeur.

Référence développeur

Filtres

Filtre	Défaut	Objectif
charitable_rewards_download_url_ttl	604800 (7 jours)	Durée de vie en secondes d'une URL de téléchargement signée
charitable_rewards_allowed_file_types	défaut du plugin	Types de fichiers autorisés pour les téléchargements numériques
charitable_rewards_max_file_size	défaut du plugin	Plafond de taille de téléchargement
charitable_email_reward_digital_delivery_recipient	le donateur	À qui l'e-mail de livraison est envoyé
charitable_email_reward_shipped_recipient	le donateur	À qui l'e-mail d'expédition est envoyé

Les deux e-mails exposent également les filtres _default_subject, _default_headline et _default_body sous le même préfixe.

URL de téléchargement signées

Charitable_Rewards_Download crée et valide l'URL signée. La signature est un HMAC sur la charge utile de la requête utilisant un sel WordPress, de sorte que les URL ne peuvent pas être falsifiées sans les clés du site.

Les décomptes de téléchargement sont suivis dans les métadonnées de don par récompense, ainsi qu'un horodatage du dernier téléchargement.

Le filtre TTL est le moyen pris en charge pour modifier la durée de vie du lien. N'essayez pas de l'allonger en réémettant vous-même les URL.

Champs d'expédition

Charitable_Rewards_Shipping::field_keys() renvoie les 7 définitions de champ. Ils sont enregistrés en tant que champs de don Charitable, ils apparaissent donc dans les exportations et sur l'enregistrement du don comme tout autre champ.

parts_for_donation() les lit en tant que tableau indexé, et format_address() les rend sous forme d'une seule ligne séparée par des virgules.

Les champs sont stockés en tant que métadonnées de publication de don préfixées par charitable_rewards_shipping_.

Clés de charge utile de récompense

Les paramètres numériques et physiques résident dans la charge utile de la récompense plutôt que sous forme de colonnes. Les clés sont digital_code, digital_link, digital_file, download_limit et estimated_delivery.

Exemples de personnalisation

Raccourcir les liens de téléchargement à 1 heure.

add_filter( 'charitable_rewards_download_url_ttl', function () {
    return HOUR_IN_SECONDS;
} );

Autoriser les téléchargements ePub et MOBI.

add_filter( 'charitable_rewards_allowed_file_types', function ( $types ) {
    $types['epub'] = 'application/epub+zip';
    $types['mobi'] = 'application/x-mobipocket-ebook';
    return $types;
} );

Envoyez également la notification d'expédition à votre bureau d'expédition.

add_filter( 'charitable_email_reward_shipped_recipient', function ( $email ) {
    return $email . ',[email protected]';
} );

En résumé

Vous savez maintenant comment les récompenses numériques parviennent aux donateurs via des liens protégés, et comment Rewards collecte les adresses pour les articles physiques.

Ensuite, vous pouvez parcourir votre liste de réclamations et enregistrer le suivi. Si vous êtes bloqué à une étape, notre équipe de support est heureuse de vous aider.

Vous pourriez aussi vouloir lire

Ces guides couvrent les étapes relatives à la livraison.

• Création de récompenses. Choisissez un type et configurez les détails de livraison de la récompense.
• Réclamations et exécution. Parcourez votre liste de réclamations et enregistrez le suivi.
• Expérience donateur. Voyez où les donateurs trouvent leurs récompenses après avoir fait un don.
• Rapports. Vérifiez les totaux de téléchargement et le contrôle de santé du stockage protégé.