=== NDC TikTok — Pixel y Events API ===
Contributors: niveldecalidad
Requires at least: 6.4
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Módulo independiente de medición TikTok para WordPress. Consulta LEEME.html para la guía ilustrada.

== Instalación ==
1. Plugins > Añadir nuevo > Subir plugin > ndc-tiktok-1.0.0.zip.
2. Activar. Abrir Ajustes > NDC TikTok.
3. Pegar ID del píxel y token Events API generado para ese píxel.
4. Elegir aviso de consentimiento propio (solo TikTok) o adaptar el banner existente.
5. Activar la medición, guardar y comprobar en una ventana privada.

== Funciones ==
Píxel: PageView, ViewContent, AddToCart confirmado por WooCommerce, InitiateCheckout, Purchase y Contact.
API: Purchase desde pedidos pagados de WooCommerce y SubmitForm desde el hook de éxito de Contact Form 7.
CF7 usa exclusivamente servidor cuando API está configurada; si no, usa píxel.
WhatsApp mide clics, no conversaciones. No se leen mensajes ni el contenido de formularios.
Compras con mismo event_id en píxel/API. Reintentos de compras ante errores transitorios.
No carga TikTok antes de aceptar. Excluye administradores de las mediciones.

== Alcance ==
No requiere servidor adicional, GTM ni suscripción al módulo.
WooCommerce y CF7 son opcionales. Sin WooCommerce siguen funcionando visitas y contactos.
Divi y Elementor: independiente de la maquetación; sus formularios propios NO tienen integración de éxito en esta versión.
Checkout clásico y Store API: adaptadores implementados; validar cada pasarela en pruebas antes de producción.
Motores de reserva externos, PrestaShop y Shopify no incluidos.
No declara soporte de activación multisite en red.

== Servicios externos ==
Después del consentimiento, el píxel se descarga desde https://analytics.tiktok.com/i18n/pixel/events.js.
Events API envía eventos a https://business-api.tiktok.com/open_api/v1.3/event/track/.
El SDK de TikTok puede recoger URL, referente y señales del dispositivo y utilizar cookies propias.
El módulo envía los datos de eventos descritos en LEEME.html; el email de facturación SHA-256 es opcional.
Consulta los términos y la política de privacidad de TikTok antes de activar el servicio:
https://www.tiktok.com/legal/page/eea/privacy-policy/es
https://ads.tiktok.com/i18n/official/policy/business-products-terms

== Validación ==
Activación y panel comprobados en WordPress aislado / PHP 8.3, sin errores de JavaScript.
24 pruebas de servidor con dobles de WooCommerce/API y 16 comprobaciones en navegador.
La recepción real por TikTok y el recorrido completo con WooCommerce/pasarela/CF7/Divi/Elementor
de cada web requieren validación con sus credenciales. No se han enviado eventos reales durante estas pruebas.

== Changelog ==
= 1.0.0 =
Primera versión instalable. 8 de octubre de 2026.
