Requisitos: plugin Charitable Pro 1.8.16+
Plan Pro y superior

¿Quieres saber cómo llega realmente una descarga digital o un artículo publicado a tu donante? Dos de los 4 tipos de recompensa necesitan entrega, con las recompensas digitales enviadas por correo electrónico y las recompensas físicas enviadas por correo postal.

Esta guía cubre ambos. Explica los 3 tipos de recompensa digital, cómo se protegen los enlaces de descarga y cómo Rewards recopila las direcciones de envío para los artículos físicos.

Hacer bien la entrega significa que los donantes reciben lo que se ganaron y tus archivos se quedan con las personas que se los ganaron. Las recompensas de reconocimiento y membresía no necesitan entrega, porque se registran y ahí termina todo.

Recompensas Benéficas necesita la versión 1.8.16 o superior del plugin Charitable Pro, en el plan Pro y superior.

¿Qué hay en esta guía?

Ver el vídeo

Si prefieres ver a leer, este vídeo muestra una recompensa digital y una recompensa física desde la configuración hasta la entrega.

Recompensas digitales

Una recompensa digital es un código, un enlace o un archivo. Tú eliges cuál al crearlo.

Tipo	Úsalo para	Lo que recibe el donante
Código	Un código de descuento, un vale o una clave de acceso	El código en sí, en el correo electrónico de entrega
Enlace	Algo alojado en otro lugar, como un vídeo o un formulario	La URL, en el correo electrónico de entrega
Archivo	Un PDF, un paquete de imágenes o un archivo de audio	Un enlace de descarga protegido

Los archivos están protegidos

Esta es la diferencia entre una descarga real y una URL que cualquiera puede repartir.

Un archivo subido no reside en tu carpeta de subidas pública, donde alguien podría adivinar la URL. Va a un almacenamiento protegido y el donante recibe un enlace con 3 protecciones.

• Firmado. La URL contiene una firma criptográfica vinculada a ese donante y esa recompensa. Cambiar cualquier parte de ella hará que deje de funcionar.
• Caducado. El enlace deja de funcionar después de un tiempo determinado, 7 días por defecto.
• Limitado. Puedes limitar cuántas veces se puede descargar el archivo de una recompensa individual.

Así, un enlace que se reenvía después de caducar no funcionará. Si un donante lo necesita de nuevo, reenvía el correo de entrega en lugar de buscar la URL del archivo.

Establecer un límite de descarga

El «Límite de descarga» en una recompensa digital limita cuántas veces se puede descargar el archivo. Déjalo vacío para descargas ilimitadas.

Un número pequeño como 3 o 5 suele funcionar bien. Es suficiente para un donante que pierde el archivo o cambia de dispositivo, y lo suficientemente bajo como para que un enlace filtrado tenga un valor limitado.

Lo que reciben los donantes

Cuando se confirma una reclamación digital, se envía el correo electrónico de entrega digital de la recompensa con el código, el enlace o la URL de descarga.

Es un correo electrónico normal de Charitable que puedes editar en la configuración de correos electrónicos, para que puedas establecer el tono y añadir tus propias instrucciones.

Recompensas físicas

Una recompensa física necesita un lugar a dónde ir, por lo que Rewards recopila una dirección de envío en el propio formulario de donación. Los campos solo aparecen cuando el donante está en cola para recibir algo físico.

Rewards recopila 7 campos.

• Nombre
• Dirección
• Dirección línea 2
• Ciudad
• Estado
• Código postal
• País

Entrega estimada

Cada recompensa física puede mostrar un tiempo de entrega estimado en la tarjeta de recompensa. Es texto libre, por lo que "4-6 semanas" o "se envía a tiempo para las fiestas" funcionan.

Sugerimos rellenarlo. La pregunta más común sobre una recompensa física es cuándo llegará, y responderla en el formulario ahorra un correo electrónico.

Las direcciones se registran en la donación

Los detalles de envío se almacenan en la donación, no en la recompensa o la reclamación. La dirección de un donante pertenece al regalo, y 1 donación que genera 2 recompensas físicas tiene 1 dirección, no 2.

En la práctica, la dirección se muestra en el registro de la donación y en cada reclamación de la misma. Verla requiere la capacidad charitable_view_reward_pii.

Entonces es un trabajo de cumplimiento

Una vez confirmada la reclamación, el artículo se une a tu lista de reclamaciones. Márcalo como cumplimentado y registra el transportista y el número de seguimiento, y Rewards envía el correo electrónico de recompensa enviada con un enlace de seguimiento.

Consulta Reclamaciones y Cumplimentación para ver los pasos completos.

Consejos que vale la pena tener en cuenta

Estos hábitos mantienen tus recompensas protegidas y tu bandeja de entrada más tranquila.

• Para los archivos, súbelos en lugar de enlazarlos a tu propia biblioteca de medios. Un archivo subido obtiene el enlace protegido y caducado, y un enlace simple a una URL pública no lo hace.
• Establece un límite de descarga, incluso uno generoso. Un enlace ilimitado que se filtra permanece ilimitado para siempre.
• Rellena la entrega estimada en todo lo físico. Es la forma más barata de reducir los correos electrónicos de soporte.
• Si un donante dice que un enlace ha caducado, reenvía el correo electrónico de entrega. Enviar el archivo como adjunto omite el recuento de descargas, por lo que tus números dejan de ser precisos.
• La vida útil por defecto del enlace es de 7 días, lo cual es generoso. Acórtala si tus archivos son sensibles y confía en el límite de descarga en lugar del reloj para cualquier cosa valiosa.

Referencia del desarrollador

Filtros

Filtro	Predeterminado	Propósito
charitable_rewards_download_url_ttl	604800 (7 días)	Duración en segundos de una URL de descarga firmada
charitable_rewards_allowed_file_types	predeterminado del plugin	Tipos de archivo permitidos para cargas digitales
charitable_rewards_max_file_size	predeterminado del plugin	Límite de tamaño de carga
destinatario_entrega_digital_recompensa_email_caritativo	el donante	A quién va el correo electrónico de entrega
destinatario_envio_recompensa_email_caritativo	el donante	A quién va el correo electrónico de envío

Ambos correos electrónicos también exponen los filtros _default_subject, _default_headline y _default_body bajo el mismo prefijo.

URLs de descarga firmadas

Charitable_Rewards_Download crea y valida la URL firmada. La firma es un HMAC sobre la carga útil de la solicitud utilizando una sal de WordPress, por lo que las URL no se pueden falsificar sin las claves del sitio.

Los recuentos de descargas se rastrean en los metadatos de donación por recompensa, junto con una marca de tiempo de la última descarga.

El filtro TTL es la forma admitida de cambiar la duración del enlace. No intentes alargarlo reemitir URL tú mismo.

Campos de envío

Charitable_Rewards_Shipping::field_keys() devuelve las 7 definiciones de campo. Se registran como campos de donación de Charitable, por lo que aparecen en las exportaciones y en el registro de donaciones como cualquier otro campo.

parts_for_donation() las lee de nuevo como una matriz con clave, y format_address() las representa como una sola línea separada por comas.

Los campos se almacenan como metadatos de publicación de donación con el prefijo charitable_rewards_shipping_.

Claves de carga útil de la recompensa

La configuración digital y física reside en la carga útil de la recompensa en lugar de como columnas. Las claves son digital_code, digital_link, digital_file, download_limit y estimated_delivery.

Ejemplos de personalización

Restringe los enlaces de descarga a 1 hora.

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

Permitir cargas de ePub y MOBI.

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

Envía la notificación de envío también a tu escritorio de envíos.

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

Conclusión

Ahora sabes cómo las recompensas digitales llegan a los donantes a través de enlaces protegidos y cómo Rewards recopila direcciones para artículos físicos.

A continuación, puedes revisar tu lista de reclamaciones y el registro de seguimiento. Si te atascas en algún paso, nuestro equipo de soporte estará encantado de ayudarte.

También te Puede Interesar Leer

Estas guías cubren los pasos relacionados con la entrega.

• Creación de recompensas. Elige un tipo y configura los detalles de entrega de la recompensa.
• Reclamaciones y Cumplimiento. Revisa tu lista de reclamaciones y el registro de seguimiento.
• Experiencia del donante. Ve dónde los donantes encuentran sus recompensas después de donar.
• Informes. Consulta los totales de descargas y la comprobación del estado del almacenamiento protegido.