Descripción
PrestaShop · Gratuito · Versión 0.1.0
Mide los pedidos pagados de PrestaShop en TikTok Ads mediante una conexión directa de servidor con TikTok Events API v1.3.
¿Qué resuelve este módulo de TikTok Ads para PrestaShop?
Un comprador puede pagar fuera de la tienda y cerrar el navegador antes de volver al checkout. El módulo observa el pedido pagado, guarda su importe y prepara el evento en una cola. El cron procesa ese evento aunque la página de gracias no se abra.
La compra se comunica como Purchase mediante Events API v1.3. Conserva ttclid y la cookie _ttp cuando existen y hay consentimiento. La respuesta debe incluir code igual a 0 para considerarse aceptada.
Cómo instalar y configurar el módulo
- Haz copia de seguridad y utiliza una tienda de pruebas. Abre Módulos → Gestor de módulos → Subir módulo y selecciona el ZIP instalable.
- Selecciona una tienda concreta si utilizas multitienda. Abre la configuración de NDC TikTok Ads y añade Pixel ID y Access Token de Events API.
- Conecta la CMP con el puente de consentimiento que aparece debajo. Comunica la preferencia inicial en cada página, así como aceptación y retirada.
- Elige el importe: total con impuestos, total sin impuestos o productos netos. Mantén el mismo criterio en los informes que vayas a comparar.
- Conserva un ID estable de evento, por ejemplo NDC-{shop_id}-{order_id}. Si tienes otra integración de compra, retírala o adapta su deduplicación antes de activar.
- Empieza en simulación local. Confirma que has probado la CMP y activa captura y cola.
- Programa en el alojamiento una llamada HTTPS POST cada minuto a la URL de cron mostrada en el panel. Envía la clave privada en la cabecera
X-NDC-Cron-Key. - Realiza una compra de prueba. Revisa el pedido, la cola y el resultado. Después cambia a Producción y comprueba un pedido nuevo en TikTok Ads.
Conectar el banner de consentimiento
El módulo no incorpora otro banner. Desde la CMP envía los valores reales; sustituye este ejemplo por la elección del visitante:
window.NDCTracking.setConsent({
analytics_storage: 'denied',
ad_storage: 'granted',
ad_user_data: 'granted',
ad_personalization: 'denied'
});Antes de cargar los scripts también puedes definir window.NDCConsentState con esos valores. Al rechazar o retirar el permiso, cambia las cuatro señales a denied. No copies el ejemplo como una aceptación automática: el envío requiere la decisión real de la persona. La ausencia de señal mantiene bloqueada la medición.
Configurar el cron del servidor
Usa la URL y la clave exclusivas que muestra tu instalación, con id_shop de la tienda seleccionada. El cron es necesario para enviar eventos; no es necesario instalar un servidor de etiquetado. No publiques la clave ni la pongas en el navegador o en la URL.
curl --request POST --header 'X-NDC-Cron-Key: TU_CLAVE_PRIVADA' 'URL_CRON_MOSTRADA_EN_EL_PANEL'
PayPal, InstantPay, tarjeta y pagos a plazos
| Recorrido | Condición de medición |
|---|---|
| Pago exprés o externo | La pasarela debe crear el pedido, enlazarlo al carrito y confirmar un estado pagado. Debe conservarse el contexto consentido antes de la redirección. |
| PayPal o InstantPay sin retorno | El callback de la pasarela actualiza el pedido. El cron puede enviar la compra sin depender de la página de gracias. |
| Pago financiado o a plazos | Configura un estado adicional solo si significa pago confirmado para el comercio. Se mide una compra con el importe del pedido, no cada cuota. |
| Pendiente, cancelado o fallido | No se envía como compra. Un reembolso posterior al envío requiere un proceso separado. |
La compatibilidad depende del comportamiento del módulo de pago instalado. No se incluyen conectores de webhook propios de PayPal o InstantPay ni una certificación universal de pasarelas.
Pruebas antes de activar campañas
- Rechaza el consentimiento: no debe salir ninguna compra publicitaria ni cargarse el píxel opcional.
- Completa un pedido y repite su notificación de pago: debe existir un único registro de compra.
- Repite el pago cerrando la ventana antes de volver a PrestaShop.
- Comprueba importe, moneda, evento
Purchasey fecha de pago. - Prueba un error temporal, un pedido pendiente, una cancelación y la retirada del permiso antes del cron.
- Verifica el evento recibido en la plataforma. Una aceptación HTTP no acredita atribución a la campaña.
Requisitos, datos y mantenimiento
Objetivo de compatibilidad: PrestaShop 1.7.8, 8 y 9; PHP 7.4 o posterior, cURL, OpenSSL, HTTPS y cron operativo. Las pruebas locales utilizan un entorno simulado de PrestaShop; no certifican todas las versiones ni MySQL de producción.
El módulo guarda de forma cifrada el contexto consentido y los eventos pendientes. El email con SHA-256 es opcional y está desactivado al instalar. El hash sigue siendo un dato personal. No envía datos a Nivel de Calidad. Conserva un registro mínimo por pedido para evitar reenvíos al reinstalar.
Los eventos nuevos tienen una ventana operativa de 24 horas para el envío y no cambian artificialmente la fecha de pago. Los contextos caducan a los 30 días; el cron limpia instantáneas antiguas. Con el módulo o el cron detenido no se ejecutan limpiezas. La desinstalación conserva configuración y tablas: planifica su eliminación con tu técnico si deseas retirarlo definitivamente.
Preguntas frecuentes
¿Es igual que el plugin de WordPress?
Comparte la conexión con TikTok Ads, pero esta edición se centra en pedidos de PrestaShop. Los formularios de Elementor, Divi o CF7 pertenecen a WordPress y no se trasladan a PrestaShop.
¿Evita duplicados con cualquier otro módulo?
Impide repetir su propio envío por pedido. Si otro módulo manda la misma compra con otro ID, debes desactivar ese envío o coordinar los identificadores. PageView opcional no envía compras desde el navegador.
¿Un pedido validado pasa luego a producción?
No. Los pedidos probados quedan marcados y no se vuelven a enviar. Usa un pedido nuevo después del cambio de modo.
¿Necesito Google Tag Manager?
Esta conexión no lo necesita. El alojamiento ejecuta las llamadas a la API y el cron.
Desarrollo: Nivel de Calidad. Revisado el . Documentación oficial de TikTok Events API v1.3.
