Ambassadors incluye un botón Descargar CSV en varios lugares de la administración. Esta página detalla dónde se encuentra cada uno, para qué sirve y un diccionario completo de columnas para cada exportación, de modo que sepa exactamente con qué está trabajando.

Ya sea que esté extrayendo datos para un informe de la junta directiva, importando registros de embajadores a un CRM o simplemente manteniendo un registro de sus decisiones de moderación, esta es su referencia.

Requiere: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Cómo exportar sus datos

Cada exportación CSV en Ambassadors funciona de la misma manera: encuentre la sección que desea, haga clic en el botón Descargar CSV y el archivo se descargará inmediatamente. No hay una pantalla de exportación separada ni una cola para esperar. Aquí se detalla dónde se encuentra cada botón y para qué lo usaría.

Exportaciones del panel general

Vaya a Charitable » Ambassadors » Overview. Varias secciones de esta pantalla tienen su propio botón Descargar CSV, y cada una exporta datos para el rango de fechas que tiene seleccionado actualmente. Ajuste primero el rango de fechas, luego haga clic en exportar y el archivo reflejará exactamente lo que ve en pantalla.

• Resumen de KPI: Los seis números principales (recaudado, donaciones, donantes, etc.) más los porcentajes de tendencia en comparación con el período anterior. Útil para informes de la junta directiva o resúmenes mensuales.
• Donaciones a lo largo del tiempo: Los mismos datos detrás del gráfico principal, divididos en períodos de fechas. Bueno para graficar tendencias en una hoja de cálculo.
• Principales recaudadores: Una lista clasificada de sus recaudadores con mejor rendimiento con el progreso de la meta y el recuento de donantes.
• Principales embajadores: Resumen por persona de los totales recaudados y el recuento de recaudadores. Útil para reconocer a los mejores.
• Principales padres: Qué campañas principales están impulsando la mayor actividad. Útil para decidir dónde centrarse.
• Registro de reclutamiento / Principales reclutadores: Solo disponible cuando las invitaciones están habilitadas. Muestra quién reclutó a quién y cómo están rindiendo sus principales reclutadores.

Exportación de moderación

Vaya a Charitable » Ambassadors » Moderation y seleccione la vista que desea exportar (Pendiente, Requiere acción, Rechazado o Aprobado). El botón Descargar CSV exporta la vista que esté activa en ese momento. Esto es útil para auditorías, traspasos entre moderadores o para mantener un registro de las solicitudes rechazadas.

Exportaciones de directorio

Vaya a Charitable » Ambassadors » Directory. La exportación a nivel de lista descarga a todos los embajadores en su vista filtrada actual, incluidas sus estadísticas de por vida, estado de verificación y quién los reclutó. También puede abrir el perfil de un embajador individual y exportar solo su historial de donaciones desde la pestaña Donaciones en esa página de perfil.

Exportaciones de invitaciones

Vaya a Charitable » Ambassadors » Invitations. Aquí encontrará dos exportaciones: un registro de actividad cronológico de cada evento relacionado con invitaciones y una tabla de clasificación de sus principales reclutadores. Ambas reflejan el rango de fechas seleccionado actualmente.

Exportación de donaciones por embajador

Este es para sus propios embajadores, no para los administradores. Cuando habilita la configuración Permitir exportación del historial de donaciones, cada embajador ve una opción de exportación de Donaciones en su página de Mis Campañas. Pueden descargar el historial de donaciones solo para sus propias recaudaciones de fondos. Las direcciones de correo electrónico de los donantes se excluyen por defecto a menos que usted lo active específicamente.

---

Lo que todas las exportaciones tienen en común

Antes de profundizar en los detalles de las columnas, hay algunas cosas que son ciertas para cada exportación CSV que Genera Embajadores:

Garantía	Notas
Seguro contra inyección de fórmulas	Cada celda que comienza con =, +, -, @, tabulador o CR se antepone con una comilla simple para que Excel no la interprete como una fórmula. Defensa estándar OWASP.
Límite de 10.000 filas	Por defecto por exportación. Se puede filtrar mediante charitable_ambassadors_<surface>_csv_max_rows. Las exportaciones más grandes deben dividirse por rango de fechas.
Codificado en UTF-8	Incluye el BOM para que Excel muestre correctamente los caracteres acentuados en Windows.
La primera fila es la cabecera	Nombres de columna en inglés claro.
No PII a menos que opte por participar	Los nombres de donantes anónimos aparecen como “Anónimo” por defecto. La configuración de exportación de detalles de donantes anónimos del Directorio cambia eso, y las exportaciones etiquetadas como superficies de “propietario” muestran nombres completos.

Exportaciones generales

El Panel General tiene botones de Descargar CSV en varias secciones. Cada uno exporta datos para el rango de fechas actualmente seleccionado en la parte superior de la pantalla.

Resumen de KPI CSV

Esta exportación le proporciona los seis números principales de la parte superior del panel, junto con cómo cada métrica tendió en comparación con el período anterior de igual duración. Bueno para incluir en un informe mensual o una diapositiva para la junta directiva.

Columna	Tipo	Notas
Métrica	cadena	“Recaudado”, “Donaciones”, “Donantes”, etc.
Valor	flotante	Valor numérico para el período actual.
Valor anterior	flotante	Valor para el período anterior de igual duración.
% de tendencia	flotante	Cambio porcentual. Vacío si alguno de los valores es cero.
Dirección de la tendencia	cadena	“arriba”, “abajo”, “plano” o vacío.

CSV de donaciones a lo largo del tiempo

Esta exportación contiene los mismos datos agrupados que el gráfico principal de la pantalla de resumen. Cada fila es un grupo de fechas, lo que facilita la creación de sus propios gráficos o análisis de tendencias en una hoja de cálculo.

Columna	Tipo	Notas
Inicio del grupo	fecha	Primer día del grupo (AAAA-MM-DD).
Fin del grupo	fecha	Último día del grupo.
Campañas principales	flotante	Total en dólares para las campañas principales de este grupo.
Recaudadores	flotante	Total en dólares para los recaudadores de este grupo.
Total	flotante	Suma de los dos.

CSV de los mejores recaudadores

Una lista clasificada de sus recaudadores con mejor rendimiento para el rango de fechas seleccionado, con el progreso completo de la meta y el número de donantes incluidos. Útil para reconocer a los mejores o compartir resultados con los organizadores de la campaña.

Columna	Tipo	Notas
Clasificación	entero	Posición basada en 1 en la lista principal.
Título del recaudador	cadena	El título de la campaña.
Nombre del embajador	cadena	El autor.
Título principal	cadena	La campaña principal a la que se suma.
Recaudado	flotante	En el rango de fechas activo.
Meta	flotante	Objetivo estático.
Porcentaje de objetivo	flotante	Recaudado / Objetivo.
Número de donantes	entero	Donantes únicos en el rango.

CSV de los mejores embajadores

Un resumen por persona que muestra cuánto recaudó cada embajador en todas sus campañas de recaudación en el rango seleccionado. Útil para correos electrónicos de reconocimiento de tablas de clasificación o importaciones de CRM.

Columna	Tipo	Notas
Clasificación	entero	Basado en 1.
Nombre del embajador	cadena	Nombre para mostrar.
Correo electrónico	cadena	Dirección de correo electrónico.
Número de campañas de recaudación	entero	Número de campañas de recaudación en el rango.
Recaudado	flotante	Total en todas sus campañas de recaudación en el rango.
Número de donantes	entero	Donantes únicos en el rango.

CSV de los mejores padres

Los datos detrás del gráfico circular en la pantalla de Resumen, que muestran qué campañas principales están impulsando la mayor actividad de recaudación de fondos. Útil para decidir dónde enfocar los esfuerzos de reclutamiento o promoción.

Columna	Tipo	Notas
Clasificación	entero	Basado en 1.
Título principal	cadena	Título de la campaña principal.
Recaudado	flotante	En el rango.
Número de donantes	entero	Donantes únicos en el rango.
Porcentaje del total	flotante	Lo recaudado por este padre dividido por el total del sitio.

CSV del registro de reclutamiento

Solo disponible cuando las Invitaciones están habilitadas. Esta exportación le brinda un registro cronológico de cada recluta, quién los trajo y cuál es su estado actual.

Columna	Tipo	Notas
Nombre del recluta	cadena	El embajador reclutado.
Correo electrónico del recluta	cadena	Correo electrónico.
Nombre del invitador	cadena	El reclutador.
Correo electrónico del invitador	cadena	Correo electrónico.
Estado	cadena	“Aprobado”, “Pendiente”, “Rechazado”.
Reclutado en	fecha y hora	Cuando se marca la atribución (AAAA-MM-DD HH:MM:SS).
Token	cadena	El token a través del cual llegaron.

CSV de los principales reclutadores de reclutamiento

Una tabla de clasificación de tus invitadores más activos, que muestra los reclutas totales junto con los reclutas aprobados para que puedas separar la actividad de los resultados.

Columna	Tipo	Notas
Clasificación	entero	Basado en 1.
Nombre del invitador	cadena	El reclutador.
Correo electrónico del invitador	cadena	Correo electrónico.
Reclutas totales	entero	Todo el estado.
Reclutas aprobados	entero	Estado = Solo aprobados.

Exportación de moderación

Disponible en la pestaña Moderación. La exportación siempre refleja la vista en la que te encuentras actualmente, así que cambia a la vista que necesites (Pendiente, Acción requerida, Rechazado o Aprobado) antes de hacer clic en Descargar CSV.

Exportación de la cola de moderación

Columna	Tipo	Notas
ID de la recaudación de fondos	entero	ID de la publicación de la campaña.
Título	cadena	Título de la recaudación de fondos.
Nombre del embajador	cadena	Nombre para mostrar del autor.
Correo electrónico del embajador	cadena	Correo electrónico del autor.
Título principal	cadena	Campaña principal.
Estado	cadena	Pendiente / Acción requerida / Rechazado / Aprobado.
Enviado	fecha y hora	Primera presentación.
Última acción	fecha y hora	Marca de tiempo de la entrada más reciente del registro de auditoría.
Motivo / Notas	cadena	Motivo de rechazo más reciente o notas de solicitud de cambio.

Exportaciones de directorios

El Directorio ofrece dos niveles de exportación: una exportación a nivel de lista para toda tu lista de embajadores y una exportación a nivel de perfil para el historial de donaciones de un embajador individual.

CSV de la lista del directorio

Esto exporta a cada embajador en la vista que estás viendo actualmente, incluyendo cualquier filtro que hayas aplicado. Si has filtrado solo a embajadores verificados, eso es lo que se exporta. Todas las columnas visibles en la tabla de la lista están incluidas, además de algunas adicionales.

Columna	Tipo	Notas
ID de usuario	entero	ID de usuario de WP.
Nombre a mostrar	cadena
Correo electrónico	cadena
Roles	cadena	Roles de WP separados por comas.
Verificado	booleano	“1” o “0”.
Total de recaudaciones	entero	Recuento de todos los estados.
Recaudaciones publicadas	entero
Recaudaciones pendientes	entero
Recaudaciones rechazadas	entero
Recaudado de por vida	flotante	En todas sus recaudaciones.
Recaudado en lo que va de año	flotante	Año actual.
Número de donantes	entero	Donantes únicos.
Recuento de donaciones	entero	Donaciones recibidas.
Última actividad	fecha y hora
Registrado	fecha y hora	user_registered de WP.
Reclutado por	cadena	Nombre a mostrar del invitador, o “” si es autorregistro.

CSV de donaciones del perfil del directorio

Disponible desde la pestaña Donaciones dentro de la página de perfil de un embajador individual. Esto enumera cada donación que las recaudaciones de ese embajador han recibido, lo cual es útil para dar a un embajador una imagen completa de su impacto o para fines de mantenimiento de registros de cumplimiento.

Columna	Tipo	Notas
Fecha	fecha y hora
Nombre del donante	cadena	“Anónimo” a menos que la configuración de anulación esté activada.
Correo electrónico del donante	cadena	“” si es anónimo.
Importe	flotante
Moneda	cadena	Código ISO.
Título del recaudador	cadena	Qué evento de recaudación de fondos recibió la donación.
Estado	cadena	Completado / Reembolsado / Fallido.

Exportaciones de invitaciones

Disponible en la pestaña Invitaciones cuando Invitaciones está habilitado.

CSV de actividad reciente

Un registro cronológico de cada evento relacionado con invitaciones en el rango de fechas activo, incluidos los clics que no resultaron en un registro. Útil para comprender dónde están teniendo repercusión sus enlaces de invitación y dónde se están enfriando.

Columna	Tipo	Notas
Marca de tiempo	fecha y hora
Evento	cadena	“Clic”, “Reclamado”, “Autoreclutamiento omitido”, etc.
Nombre del invitador	cadena
Correo electrónico del invitador	cadena
Nombre del recluta	cadena	“” para eventos de clic sin reclamo.
Correo electrónico del recluta	cadena	“”.
Token	cadena
Campaña principal	cadena	Campaña a la que se limita (si la hay).

CSV de los principales reclutadores

Esta exportación tiene las mismas columnas que el CSV de los principales reclutadores de la Descripción general. Se muestra aquí en la pestaña Invitaciones para que pueda obtener datos de reclutadores sin tener que volver a la pantalla de Descripción general. Si ya está trabajando en Invitaciones, esto le ahorra el viaje.

Informe de donaciones por embajador

Los embajadores pueden exportar su historial de donaciones desde la página Mis campañas utilizando la acción Donaciones en cada tarjeta de recaudación de fondos. Esto está regido por la configuración Permitir exportación del historial de donaciones, por lo que usted mantiene el control sobre si está disponible.

Las columnas coinciden con el CSV de donaciones del perfil del directorio, con tres diferencias:

• Se omite "Correo electrónico del donante" de forma predeterminada. Active Incluir detalles personales para donantes anónimos en la configuración de Mis campañas para incluirlo.
• Se omite "Moneda" ya que esta es siempre una exportación de moneda única.
• Se omite "Título de la recaudación de fondos" ya que la exportación ya está limitada a una sola recaudación de fondos.

Patrón de nombre de archivo

Todos los CSV de embajadores siguen la misma convención de nombres, lo que facilita encontrar el archivo correcto más tarde:

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

Por ejemplo:

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

Las fechas en el nombre del archivo son la ventana de la exportación, por lo que puede usar el nombre del archivo en sí como clave de archivo sin tener que abrir el archivo.

Límite de filas

El límite predeterminado es 10.000 filas por exportación. Si supera ese límite con regularidad, tiene dos opciones: reducir el rango de fechas para dividir la exportación en fragmentos más pequeños o aumentar el límite usando el filtro para esa superficie:

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;
} );

Algunas cosas que vale la pena saber antes de abrir ese CSV

La mayoría de estas solo aparecen una vez, pero son el tipo de cosas que te ahorran 20 minutos de frustración cuando sí lo hacen.

• Usa Google Sheets si Excel no funciona. Sheets maneja la BOM UTF-8 correctamente en Mac y Linux. Excel en Windows puede dañar caracteres acentuados incluso cuando la BOM está presente, así que si los nombres o las direcciones se ven garabateados, prueba Sheets primero.
• Guarda el archivo antes de abrirlo en Excel. Algunas versiones de Excel en Windows convertirán automáticamente las columnas en el momento en que las abras, lo que puede convertir IDs numéricos en fechas o eliminar ceros iniciales. Guardar el archivo sin procesar primero te da una opción de respaldo.
• Solo activa los detalles de donantes anónimos si realmente los necesitas. La mayoría de los programas no necesitan exponer PII anonimizada en sus exportaciones, y mantener esa configuración desactivada significa menos datos para administrar y proteger.
• Usa el nombre del archivo como tu clave de archivo. El rango de fechas está integrado en cada nombre de archivo, por lo que siempre sabrás qué ventana cubre un archivo determinado sin tener que abrirlo.

---

Referencia del desarrollador

Clases de manejo de CSV

Clase	Maneja
Charitable_Ambassadors_Overview_CSV	Exportaciones del panel general.
Charitable_Ambassadors_Directory_CSV	Lista del directorio + exportaciones de perfiles.
Charitable_Ambassadors_Invitations_CSV	Exportaciones de la pestaña de invitaciones.

Cada manejador se invoca a través de admin-post.php?action=charitable_ambassadors_<surface>_csv con un argumento de consulta section y nonce.

Neutralización de inyección de fórmulas

Cada valor de celda pasa por:

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

Esto antepone una comilla simple a cualquier cadena que comience con =, +, -, @, una tabulación o un retorno de carro, siguiendo la defensa recomendada por OWASP contra la inyección de CSV y la inyección de fórmulas de Excel.

Filtros

Filtro	Predeterminado	Propósito
charitable_ambassadors_overview_csv_max_rows	10000	Límite en las exportaciones generales.
charitable_ambassadors_directory_csv_max_rows	10000	Límite en las exportaciones del directorio.
charitable_ambassadors_invitations_csv_max_rows	10000	Límite en las exportaciones de invitaciones.
charitable_ambassadors_directory_csv_cell	''	Anula el valor de una columna personalizada. Recibe ('', $col, $user).
charitable_ambassadors_overview_csv_header_<section>	calculado	Modifica la fila de encabezado para una sección dada.
charitable_ambassadors_overview_csv_row_<section>	calculado	Modifica las filas de datos para una sección dada.

Capacidades

Todas las exportaciones del lado del administrador requieren manage_charitable_settings. El informe de donaciones por embajador en Mis Campañas requiere que el usuario sea el post_author de la campaña que se está exportando.

También te Puede Interesar Leer

Estos son los documentos de Embajadores más relacionados con este. Marca los que coincidan con cómo usas tus datos y vuelve a ellos cuando necesites un recordatorio.

• Panel de Resumen: aquí es donde residen la mayoría de estas exportaciones y donde se selecciona el rango de fechas.
• Directorio: la lista completa de embajadores, con sus propias exportaciones a nivel de lista y de perfil.
• Moderación: la cola donde revisas y apruebas las presentaciones de recaudación de fondos, con su propia exportación por vista.
• Invitaciones: el sistema de reclutamiento detrás de las exportaciones del Registro de Reclutamiento y Principales Reclutadores.
• Hooks y filtros en Embajadores: la referencia del desarrollador para personalizar el comportamiento de exportación.