El seguimiento de conversiones envía eventos nativos de Meta Pixel, TikTok Pixel y Google Tag Manager dataLayer desde tus páginas de campaña, formularios de donación y páginas de recibo. Cada evento transporta el contexto completo de la donación, incluyendo importe, divisa, nombre de la campaña, tipo de donación y método de pago, para que tus plataformas publicitarias puedan optimizar el gasto basándose en resultados reales de recaudación de fondos.
Disponible con Charitable Pro 1.8.13.5 o posterior en planes de licencia Pro, Agency y Elite.
Características clave
- Dispara eventos Meta Pixel
PurchaseyDonateen cada donación confirmada - Dispara eventos TikTok Pixel
CompletePaymentcon el valor y la divisa de la donación completos - Envía datos enriquecidos de donaciones a
window.dataLayerpara Google Tag Manager y GA4 - Realiza un seguimiento de las vistas de páginas de campaña y las aperturas de formularios de donación como eventos de la parte superior del embudo
- Incluye el importe de la donación, la divisa, el nombre de la campaña, el tipo de donación y el método de pago en cada conversión
- Respeta el consentimiento del visitante a través de la API de consentimiento de WP, con un hook de filtro para gestores de consentimiento personalizados
- Evita conversiones duplicadas en las actualizaciones de la página de recibo utilizando el seguimiento de sesiones con ámbito de pestaña
- Revisa el estado del seguimiento para cada donación dentro del administrador de WordPress
¿Por qué usar el seguimiento de conversiones?
Las organizaciones sin ánimo de lucro que ejecutan anuncios de pago en Meta, TikTok o a través de Google Tag Manager necesitan una atribución de conversiones precisa para optimizar el gasto publicitario y demostrar el ROI. Los plugins de píxeles genéricos disparan eventos vacíos que solo indican a la plataforma publicitaria que ocurrió una "conversión". El seguimiento de conversiones de Charitable envía el importe de la donación, la divisa y el contexto de la campaña que los algoritmos de Meta y TikTok utilizan realmente para encontrar más donantes que aporten. Tu coste de adquisición por donante disminuye. Tus campañas aprenden más rápido.
Requisitos
- Charitable Pro 1.8.13 o posterior
- Un plan de licencia Charitable Pro, Agency o Elite
- WordPress 5.0 o posterior
- PHP 7.2 o posterior
- Opcional: API de consentimiento de WP y un plugin de gestión de consentimiento compatible, si deseas que los píxeles estén restringidos por el consentimiento del visitante
Empezar
Activación
- Descarga el complemento de seguimiento de conversiones desde el panel de tu cuenta de Charitable.
- En WordPress, ve a Plugins > Añadir nuevo > Subir plugin y sube el archivo ZIP.
- Activa Charitable – Seguimiento de conversiones.
- Ve a Charitable > Ajustes > Avanzado > Seguimiento de conversiones para introducir tus IDs de píxel.
Introduce tus IDs de píxel
Cada plataforma tiene un único campo de ID. Dejar un campo vacío deshabilita esa plataforma. No se necesita un interruptor de activación/desactivación independiente.
Uso
El seguimiento de conversiones se ejecuta automáticamente una vez que se introducen los IDs de píxel. No hay ningún bloque ni shortcode que colocar. El complemento escucha en tres momentos a lo largo de tu sitio:
- Vista de página de campaña. Se dispara cuando un visitante carga una página de campaña individual.
- Formulario de donación mostrado. Se dispara cuando se muestra un formulario de donación en cualquier página.
- Donación confirmada. Se dispara en la página de recibo después de una donación exitosa, para todas las pasarelas, incluidas Stripe, PayPal, Square, Braintree, Mollie y Offline.
Opciones de configuración
IDs de plataforma
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
meta_pixel_id | cadena | vacío | Tu ID de Píxel de Meta de 15 dígitos. Ejemplo: 123456789012345 |
tiktok_pixel_id | cadena | vacío | Tu ID de Píxel de TikTok. Ejemplo: CXXXXXXXXXXXXXXX |
gtm_container_id | cadena | vacío | Tu ID de Contenedor de GTM. Charitable envía eventos dataLayer pero no carga GTM por sí mismo. Instala GTM a través de tu tema o un plugin separado. Ejemplo: GTM-XXXXXXX |
Seguimiento de Comportamiento
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
pixel_track_campaign_views | casilla de verificación | activado | Dispara los eventos ViewContent y charitable_campaign_view cuando un visitante carga una página de campaña |
pixel_track_form_opens | casilla de verificación | activado | Dispara los eventos InitiateCheckout y charitable_initiate_checkout cuando se muestra un formulario de donación |
pixel_consent_integration | casilla de verificación | activado | Comprueba wp_has_consent( 'marketing' ) antes de disparar cualquier píxel |
Referencia de Eventos
| Momento | Píxel de Meta | Píxel de TikTok | Evento dataLayer de GTM |
|---|---|---|---|
| Vista de página de campaña | ViewContent | ViewContent | charitable_campaign_view |
| Formulario de donación mostrado | InitiateCheckout | InitiateCheckout | charitable_initiate_checkout |
| Donación confirmada | Purchase y Donate | CompletePayment | charitable_donation_complete |
Payload de dataLayer al completar la donación
window.dataLayer.push({
event: 'charitable_donation_complete',
donationId: 8937,
value: 28.87,
currency: 'USD',
campaignId: 7952,
campaignName: 'Clean Water for Rural Communities',
donationType: 'one-time',
paymentMethod: 'stripe'
});Personalización
Múltiples Campañas en una Sola Donación
Cuando una donación cubre más de una campaña, el Seguimiento de Conversiones utiliza la campaña con el mayor importe de donación como objetivo de atribución. El value total es la suma de todas las campañas. Utiliza el filtro charitable_pixel_primary_campaign para anular esta selección.
Estados de donación que activan conversiones
Por defecto, el Seguimiento de Conversiones activa píxeles para donaciones con los estados charitable-completed, charitable-preapproved y charitable-pending. Utiliza el filtro charitable_pixel_fire_statuses para añadir o eliminar estados.
Solución de problemas
No aparecen eventos de píxel en Meta Events Manager ni en TikTok Events Manager
Comprueba que el campo del ID del píxel esté rellenado para esa plataforma y que tu visitante haya otorgado el consentimiento de marketing (o que pixel_consent_integration esté deshabilitado). Abre la pestaña Red de las Herramientas de Desarrollador de tu navegador en la página de recibo y filtra por fbevents.js o analytics.tiktok.com para confirmar que la biblioteca de píxeles se carga.
Los eventos de dataLayer de GTM se activan pero las etiquetas de GTM no
Charitable envía eventos a window.dataLayer pero no instala el contenedor de GTM en sí. Instala GTM a través del encabezado de tu tema o un plugin dedicado de GTM. Confirma que el ID del contenedor en GTM coincide con el ID introducido en la configuración del Seguimiento de Conversiones.
Los eventos de la página de recibo no se activan
Comprueba el estado de la donación. Las donaciones sin conexión que permanezcan en charitable-pending sin ser aprobadas manualmente no activarán píxeles. Confirma también que la donación pasó por la página de recibo en lugar de una redirección personalizada de agradecimiento, ya que el Seguimiento de Conversiones se basa en el hook charitable_donation_receipt_page.
Conversión rastreada dos veces cuando el visitante actualiza la página de recibo
El Seguimiento de Conversiones utiliza sessionStorage con el ID de donación como clave para evitar que se active de nuevo en la misma pestaña del navegador. Abrir la URL del recibo en una nueva pestaña cuenta como una nueva sesión y se activará una vez, que es el comportamiento esperado.
Aparece el banner de licencia inactiva en el administrador
Confirma que Charitable Pro está instalado y activado, que tu licencia es del plan Pro, Agency o Elite, y que la licencia se ha introducido y activado en Charitable > Settings > Licenses. Las licencias caducadas tienen un período de gracia de 30 días antes de que se bloquee la entrega.
Recursos para desarrolladores
Ganchos y filtros
charitable_pixel_fire_statuses— matriz de estados de donación que permiten la activación de píxelescharitable_pixel_primary_campaign— anula la campaña elegida para donaciones múltiplescharitable_pixel_consent_granted— verificación de consentimiento de respaldo cuando la API de consentimiento de WP no está disponiblecharitable_ajax_donation_response— añadido al núcleo de Charitable Pro; permite a los complementos enriquecer la respuesta de donación AJAX para futuros trabajos de la API de Conversiones
Claves meta de donación
_charitable_pixel_tracking_status—tracked,consent_blocked,status_blocked,license_blocked, onot_configured_charitable_pixel_tracked_at— Marca de tiempo Unix del evento de seguimiento_charitable_pixel_platforms— matriz de plataformas que se activaron, por ejemplo,['meta', 'tiktok', 'gtm']_charitable_pixel_event_id— ID de evento único reservado para la futura desduplicación de la API de conversiones de Meta
Integración de consentimiento
El seguimiento de conversiones lee el consentimiento a través de la API de consentimiento de WP cuando está disponible:
if ( function_exists( 'wp_has_consent' ) ) {
return (bool) wp_has_consent( 'marketing' );
}
return (bool) apply_filters( 'charitable_pixel_consent_granted', true, 'marketing' );Los sitios sin un gestor de consentimiento activan los píxeles por defecto. Los sitios con un plugin de consentimiento compatible (CookieYes, Complianz y otros que implementan la API de consentimiento de WP) respetan el consentimiento automáticamente.
