NDC Meta.
Conecta, comprueba y mide.

1. Qué hace el módulo

El píxel envía eventos desde el navegador. La API de conversiones permite enviarlos desde tu servidor de WordPress. NDC Meta coordina ambas vías con el mismo nombre e identificador para que Meta pueda deduplicarlas. Las compras pagadas de WooCommerce se originan en el servidor; los clics y formularios confirmados dependen de la señal del navegador.

El plugin funciona con independencia del tema. No requiere Divi, Elementor ni WooCommerce para páginas, clics y formularios personalizados. WooCommerce solo es necesario para los eventos de tienda.

2. Antes de instalar

• WordPress 6.4+ y PHP 7.4+ como base de diseño. Revisa la validación incluida; no se han probado todas las combinaciones de versiones.
• HTTPS, REST API de WordPress accesible y WP-Cron operativo.
• ID del píxel/conjunto de datos y token de Conversions API de tu propia empresa.
• Un banner que gestione el consentimiento publicitario.
• Desactivar los eventos equivalentes de otros plugins o GTM para evitar duplicados.

3. Instálalo y conecta Meta

1. Ve a Plugins → Añadir nuevo → Subir plugin y selecciona el ZIP ndc-meta-0.1.0.zip. Actívalo.
2. Abre Ajustes → NDC Meta. La medición empieza en pausa.
3. En Meta, abre Administrador de eventos → Tu conjunto de datos → Configuración → API de conversiones y genera el token con el permiso adecuado.
4. Copia ID y token en el panel. El campo del token quedará vacío al guardar para no exponerlo; dejarlo vacío en posteriores guardados conserva el valor.
5. En Probar eventos de Meta, copia el código y guárdalo en el módulo.
6. Pulsa Enviar evento sintético de prueba. Revisa que el panel indique aceptación y que Meta muestre el evento.
7. Configura consentimiento, activa la medición en Pruebas y visita la web sin sesión de administrador.
8. Valida el recorrido completo. Después selecciona Producción.

En modo Pruebas no se carga el píxel del navegador para evitar eventos reales; CAPI utiliza el código de prueba. La deduplicación entre navegador y servidor se valida con una conversión controlada al pasar a producción. El botón de prueba siempre utiliza el código de prueba y datos sintéticos, aunque el modo guardado sea Producción.

4. Conecta el consentimiento

// Solo desde el callback real del banner:
NDCMeta.setConsent(true);  // Publicidad aceptada
NDCMeta.setConsent(false); // Publicidad rechazada o retirada

Selecciona «Otro banner» antes de usar estas llamadas. No llamarlas al cargar la página por defecto. El plugin no instala otro banner ni convierte el envío por servidor en una excepción al consentimiento. Al revocar bloquea nuevos eventos, elimina sus identificadores de Meta accesibles y cancela los envíos pendientes cuyo permiso ya no sea válido.

5. Eventos y compatibilidad

Los adaptadores de formulario incluidos son Contact Form 7, Elementor Pro y WPForms en modo AJAX. Para Divi, formularios a medida u otros proveedores, llama lo siguiente únicamente después de que el sistema confirme éxito:

NDCMeta.formSuccess('contacto_principal');

No lo conectes a un clic o al evento submit. Nunca pases el email, teléfono, nombre ni el texto del mensaje a esta función. Los adaptadores no leen el contenido de los formularios.

WooCommerce utiliza sus métodos de pedidos y declara compatibilidad HPOS. Se contemplan los hooks de checkout clásico y Blocks. En esta primera versión no hay captura automática de carrito Blocks, productos variables, suscripciones, renovaciones, reembolsos, pedidos manuales ni motores de reservas. Deben validarse por separado antes de ampliar su uso.

La compra requiere consentimiento recogido en el checkout, aún válido y con antigüedad inferior a 24 horas. Los métodos transferencia, cheque y contra reembolso esperan pedido completado y fecha de pago. Un pago confirmado más tarde puede quedar fuera de esa ventana. No se importan pedidos anteriores a la instalación.

6. Datos, seguridad y retención

El token se conserva únicamente en una opción de WordPress sin carga automática, o en la constante NDC_META_ACCESS_TOKEN de wp-config.php. Los administradores con acceso a la base de datos pueden leer la opción: protege tus copias de seguridad. No se expone en la configuración pública ni se registra en el diagnóstico.

CAPI recibe nombre y hora del evento, URL sin parámetros ni fragmentos, IP, agente del navegador y cookies fbp/fbc cuando existen. Compras y productos incluyen IDs, importes y moneda. La coincidencia avanzada es opcional: utiliza email y teléfono internacional con SHA-256; esos hashes siguen siendo identificadores personales. El píxel de Meta puede recoger el contexto de la página según su propio funcionamiento: evita datos personales o sensibles en las URLs.

Tras consentir, ndcm_permission vincula una autorización firmada con el servidor durante un máximo de 24 horas (HttpOnly, SameSite=Lax, Secure en HTTPS). El contexto temporal de checkout caduca a las 24h; los envíos a la hora. WordPress elimina físicamente los datos caducados mediante cron/limpieza. El diagnóstico guarda como máximo 50 estados, sin IP, emails, token ni payloads.

Al desactivar se cancela la cola y se elimina el contexto temporal propio. Al borrar el plugin se eliminan ajustes y credenciales. Los identificadores de evento permanecen en pedidos; ningún pedido se borra.

7. Si algo no llega a Meta

• Sin actividad: comprueba medición activada, ID, token, código de prueba, consentimiento y exclusión de administradores.
• En cola: comprueba WP-Cron. Si está desactivado o la web no recibe visitas, configura un cron real.
• HTTP 400/401: revisa token, permisos, ID y formato del evento en Meta. No se reintentan indefinidamente.
• HTTP 429 o 5xx: el módulo reintenta hasta cuatro veces dentro de una hora, manteniendo el identificador.
• Píxel en conflicto: retira la instalación duplicada de GTM u otro plugin. El módulo no puede deduplicar eventos ajenos.
• API acepta, anuncio no atribuye: aceptación y atribución son cosas distintas. Revisa calidad de coincidencia y diagnóstico de Meta.

// Estado local del navegador, sin token:
NDCMeta.snapshot();

8. Validación y límites de esta entrega

Se han realizado pruebas locales de activación, ajustes, seguridad del endpoint, consentimiento, deduplicación, errores y navegador. El transporte de Meta se ha simulado para no enviar datos reales. Los contratos de WooCommerce utilizan dobles de sus objetos. No se ha validado todavía la recepción con una cuenta Meta real ni una compra mediante una pasarela real. Revisa VALIDACION.txt. Esta versión se distribuye como beta.

Referencias oficiales

• Meta: primeros pasos con Conversions API
• Meta: deduplicación de eventos
• Contact Form 7: eventos DOM
• WPForms: confirmación AJAX
• Complianz: integración de consentimiento
• Condiciones de tecnología de Meta · Privacidad de Meta