Mide el contacto.
Aprende de la venta.

Qué hace esta actualización

No necesitas comprar un CRM para este flujo. La hoja organiza las fases comerciales. El dato de cierre lo registra una persona o una integración: el módulo no puede adivinar si se ha vendido.

La versión 0.3.0 es una candidata para instalación supervisada. Incluye pruebas locales de lógica y flujo simulado. La conexión OAuth, la recepción real en Google y cada combinación de formulario y banner deben verificarse en la web del cliente antes del despliegue.

El recorrido de un contacto

Ejemplo ilustrativo: entran diez formularios, cuatro encajan con el servicio y uno contrata por 2.000 €. Son diez leads, cuatro contactos cualificados y una venta; no quince ventas. En Google Ads se elige qué fase utilizar como objetivo principal de puja.

Instalación en cinco pasos

1. Actualiza el plugin. En WordPress → Plugins → Añadir plugin → Subir plugin, selecciona el ZIP 0.3.0 y confirma la sustitución de la versión existente. Conserva una copia previa. La nueva extensión está desactivada por defecto.
2. Prepara la hoja. Importa NDC-Medicion-Contactos.xlsx desde la carpeta docs como Google Sheets. Conserva la pestaña Leads y los encabezados. La plantilla de trabajo de la agencia ya puede prepararse como hoja nativa con desplegables. La fila DEMO es ficticia y el conector la omite.
3. Selecciona los formularios. En NDC · Medición → Google Ads y contactos, añade su proveedor, ID y nombres de los campos. Activa conversiones mejoradas y selecciona una única vía: GTM o etiqueta directa.
4. Autoriza Google. Tras la preparación técnica inicial, pulsa Conectar Google, elige una cuenta con permisos sobre la hoja y las conversiones, y autoriza Sheets y Data Manager. Pega el enlace de la hoja y guarda.
5. Comprueba antes de enviar. Activa la sincronización, deja desmarcados los envíos reales y pulsa Comprobar y sincronizar. Completa el ensayo descrito abajo antes de activar producción.

Tener Google Drive conectado a ChatGPT no autoriza automáticamente al plugin de WordPress. El plugin necesita su propia autorización OAuth. El ZIP público no contiene credenciales ni el enlace privado de ningún cliente.

Cómo trabaja una persona sin conocimientos técnicos

Abre la pestaña Leads. Trabaja en las cuatro primeras columnas. No hace falta entrar en WordPress para actualizar cada contacto.

Al pasar de Cualificado a Ganado, actualiza la fecha y el importe de la nueva fase. No inventes una fecha actual para una venta antigua. El módulo comprueba que la fecha no sea anterior al lead ni esté en el futuro.

Nombre, Email, Teléfono, Recibido, ID y Formulario los completa el módulo. Envío Ads explica el resultado. Si necesitas detener futuros envíos de un contacto, cambia Permiso Ads a Retirado. Esta retirada queda conservada en WordPress y no se revierte cambiando la celda a Concedido.

Ordena y filtra filas completas. No renombres encabezados ni cambies IDs. El módulo busca por ID antes de escribir resultados, de modo que ordenar la hoja no cambie la identidad del contacto.

Preparación de Google · una tarea técnica inicial

1. Proyecto y autorización

1. Crea o utiliza un proyecto Google Cloud controlado por la empresa.
2. Habilita Google Sheets API y Data Manager API.
3. Configura la pantalla de consentimiento OAuth, las páginas de soporte y privacidad y el público de la aplicación. Completa las verificaciones que Google exija para su distribución.
4. Crea un cliente OAuth de tipo Aplicación web. Registra la URI exacta que muestra el módulo en Preparación técnica.
5. Introduce ID y secreto en WordPress. Nunca los metas en un ZIP descargable, una hoja compartida ni una captura pública.
6. Si la aplicación está en pruebas, añade el usuario permitido y revisa la caducidad de los tokens. Valida también las restricciones del administrador de Google Workspace.

Se solicitan los permisos https://www.googleapis.com/auth/spreadsheets y https://www.googleapis.com/auth/datamanager. El permiso de Sheets es amplio; el código del módulo utiliza únicamente la hoja indicada. Para una distribución masiva con un único botón sin preparación por instalación, hace falta un servicio OAuth central de la agencia y su proceso de verificación: no está incluido en este ZIP.

2. Acciones de conversión

Prepara una acción web para el formulario y acciones de importación desde clics para Cualificado y Ganado. Activa las conversiones mejoradas y revisa los términos de datos de clientes con el titular de la cuenta.

La cuenta de destino debe ser la que posee las acciones. Si las conversiones pertenecen al MCC, utiliza esa cuenta de conversión. La cuenta de acceso/MCC es opcional y se configura aparte. El ID numérico de la acción offline, el ID AW y la etiqueta de la conversión web son valores diferentes.

3. Evita contar el mismo resultado por dos vías

La versión envía las fases comerciales desde WordPress a Data Manager API. No configures además esta misma hoja como importación automática en Google Ads. Tampoco mantengas una etiqueta GTM del mismo formulario cuando actives el envío directo de este módulo sin revisar la deduplicación.

Conversiones mejoradas del formulario

Opción A · conservar Google Tag Manager

1. Mantén el ID GTM y tu instalación de Consent Mode.
2. Crea una variable de capa de datos, versión 2, para ndc_user_data. En una variable de Datos proporcionados por los usuarios, utiliza la modalidad Código y esa variable como objeto.
3. En la etiqueta de conversión Google Ads, activa los datos proporcionados por el usuario y vincula la variable anterior.
4. Usa ndc_form_success como activador y ndc_event_id como ID de transacción. Los eventos ndc_debug_* no deben activar etiquetas reales.
5. Configura Conversion Linker/etiqueta Google y los requisitos de consentimiento. Revisa con Tag Assistant que solo se dispara una conversión y recibe los campos esperados.

El objeto lleva sha256_email_address y, si existe un teléfono válido, sha256_phone_number. No vuelvas a aplicar hash. No lo vincules a eventos de GA4 ni a etiquetas de otras plataformas.

Opción B · etiqueta directa desde el plugin

Selecciona etiqueta directa e indica AW y etiqueta de conversión. El módulo espera permiso publicitario, carga la etiqueta y envía la conversión tras el éxito del formulario. Es independiente de tener un contenedor GTM. Configura también en Google Ads las conversiones mejoradas y su elegibilidad.

Para la mejora web de esta implementación se necesita email. El teléfono es un complemento. Los contactos con solo teléfono pueden servir para el flujo offline si Google admite su identificación; no se promete mejora web con teléfono solo.

Las conversiones mejoradas pueden mejorar la atribución frente a depender únicamente de cookies. La API, por sí sola, no garantiza más conversiones ni recuperación del 100 %. Los clics en WhatsApp y teléfono siguen siendo clics: no demuestran una conversación, un lead identificado ni una venta.

Compatibilidad y requisitos

Consentimiento y datos

Esta conexión adopta un criterio conservador: necesita ad_storage y ad_user_data concedidos para capturar y exportar el contacto. Si falta el permiso, el formulario sigue funcionando, pero el contacto no entra en esta cola publicitaria. Conserva tus canales habituales de recepción de leads.

• La web lee solo los campos de nombre, email y teléfono que hayas indicado. No recoge el mensaje completo ni adjuntos.
• Los contactos y tokens se cifran en la base de datos con claves derivadas de las claves de WordPress. No se muestran tokens en los diagnósticos.
• La hoja contiene datos legibles para el equipo: controla quién tiene acceso. A Google Ads se envían hashes y los identificadores publicitarios disponibles.
• GCLID/GBRAID/WBRAID se conservan en la sesión del navegador con permiso, hasta un día. No hay garantía de recuperarlos entre dispositivos o sesiones distintas.
• WordPress conserva la cola 90 días por defecto; puede ajustarse entre 7 y 365. La hoja y Google Ads requieren su propia gestión de conservación y retirada.
• La retirada posterior en la hoja detiene nuevos envíos. No borra conversiones ya recibidas ni funciona como un sistema completo de ejercicio de derechos.

Conserva un único gestor de consentimiento. La CMP externa debe comunicar sus señales a la integración mediante NDCTracking.updateConsent(...), o debe verificarse cómo llegan al dataLayer. Las actualizaciones internas de una CMP que no sean observables necesitan adaptador. El banner NDC incluido en 0.2 sigue siendo opcional y requiere revisión por instalación.

Las señales guardadas reflejan la elección comunicada por la web; no certifican por sí solas el cumplimiento de toda la web. Cambiar las claves de WordPress puede impedir descifrar contactos y tokens antiguos.

Prueba completa antes de activar

1. Comprueba el consentimiento aceptado y rechazado con Tag Assistant. No debe haber datos de usuario enviados cuando falte el permiso.
2. Como administrador, usa el diagnóstico NDC para revisar eventos: están separados de los reales. Los administradores no se guardan como contactos.
3. En una web/conversión de pruebas, envía un formulario válido desde una sesión sin administrador y con datos de prueba propios. Confirma que llega una sola fila a la hoja. Un formulario con errores no debe generar un contacto.
4. Marca Cualificado y escribe su fecha real. Ejecuta Comprobar y sincronizar con envíos reales desactivados. La columna Envío Ads debe indicar Prueba validada.
5. Repite la sincronización: la misma fase no debe duplicarse. Ordena filas completas y comprueba que conserva el ID.
6. En una cuenta de pruebas autorizada, activa el envío real y revisa recibo, procesamiento y diagnóstico en Google Ads. No utilices datos inventados como conversiones de producción.
7. Después de validar la cuenta y el formulario reales, habilita los envíos de producción. Revisa también la fase principal elegida para pujar.

El modo prueba de la API no desactiva por sí solo tus etiquetas de Google Tag Manager. Usa el diagnóstico, una acción secundaria de prueba o un contenedor de pruebas para no contaminar las conversiones web reales.

Si algo no aparece

GTM, WhatsApp y cookies

La actualización conserva los eventos de WhatsApp y teléfono, el diagnóstico y el banner opcional de la versión anterior. Abre la guía técnica de GTM y consentimiento para configurar esos componentes.

Referencias y alcance de validación

Documentación oficial consultada el 8 de octubre de 2026:

• Conversiones mejoradas web con la etiqueta Google.
• Eventos offline y conversiones mejoradas para clientes potenciales.
• events.ingest: esquema y modo validateOnly.
• Consulta del procesamiento de eventos.
• OAuth para aplicaciones web.
• Hooks de Elementor Forms y procesamiento completado de WPForms.

Validación de esta entrega: sintaxis PHP y JavaScript, normalización y hash, cifrado, consentimiento, eventos de prueba, duplicados, preparación del payload y simulación de aceptación, consulta de estado, errores HTTP y reintentos. No equivale a una prueba integral con WordPress, formularios comerciales y una cuenta Google autorizada. Consulta VALIDACION-0.3.0.txt.

Las conversiones online multi-source por Data Manager tienen requisitos específicos de Google y no son la vía implementada aquí. Esta versión combina mejora web por etiqueta con fases comerciales por API.