TikTok Pixel: configuración y ayuda

Sigue los pasos de Inicio rápido.

Abre "Configure" desde el gestor de módulos. Necesitas un Pixel existente para tu cuenta TikTok. La página de configuración muestra avisos de configuración obligatorios, preparación del seguimiento y diagnósticos de Events API.

El seguimiento en el navegador exige permiso de marketing/servicio y permiso para enviar datos de coincidencia. La autorización de almacenamiento por sí sola no basta. El módulo admite decisiones de consentimiento de Cookies Revolution, Cookie Banner, Cookiebot, OneTrust y TCF; configura y prueba las decisiones que proporciona tu tienda. Un permiso desconocido retiene el seguimiento. Una CMP compatible detectada sigue aplicándose si desactivas el ajuste de consentimiento del módulo.

El módulo también comprueba contexto seguro de página/referente, estado del personal, propiedad y reglas de salida. Usa una instancia ttq verificada específica del Pixel. Elimina cargadores TikTok duplicados o inicializados de forma ambigua antes de probar.

Opciones de eventos estándar

Todas las opciones de eventos estándar tienen Sí como valor predeterminado. Desactiva los eventos que no necesites.

El módulo carga https://analytics.tiktok.com/i18n/pixel/events.js para tu Pixel. Los eventos de carrito requieren un aumento de cantidad correcto y confirmado; un clic de añadir o una notificación updateCart por sí solos no bastan. Los eventos incluyen ID de producto y cantidad. Los precios actuales y el valor del carrito solo se incluyen si están confirmados.

Los datos de compra usan Purchase; CompletePayment es un alias interno. Incluyen el ID estable de evento basado en el pedido, la referencia del pedido cuando está disponible, valor, moneda y contenidos comprados. La política predeterminada de valor de compra incluye impuestos y envío y resta descuentos. Son valores predeterminados del proveedor en este módulo, no campos de ajustes separados.

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" y "Track product engagement" tienen No como valor predeterminado. Los clics telefónicos y los inicios reales compatibles del chat Tawk se asignan a Contact, con metadatos generales de la señal. Los formularios necesitan un comprobante de éxito confirmado por el servidor.

"Confirmed form event" tiene Lead como valor predeterminado. Selecciona SubmitForm solo si necesitas esa asignación antigua. "Send confirmed forms through the server API" tiene No como valor predeterminado; actívalo solo junto con la señal de formulario y las credenciales API. Un formulario solo se envía desde el servidor si su comprobante, el consentimiento del visitante y la atribución del clic se guardaron al enviarlo; si no, se retiene. Los valores del formulario no se copian al evento.

Usa "Product engagement thresholds" para un objeto JSON. Un campo almacenado vacío usa los valores predeterminados del paquete: 3 interacciones con la galería, 1 cambio de variante, 1 interacción con los detalles o 45 segundos, con una limitación de opciones de 1500 ms. Los recuentos admiten de 1 a 20, la permanencia de 5 a 600 segundos y la limitación de 250 a 60000 ms. El comportamiento predeterminado de high_intent_product_engagement es una vez por producto/sesión cuando se permite el almacenamiento.

"Track custom events" tiene No como valor predeterminado. "Custom event rules" empieza vacío. Añade reglas antes de activar el ajuste. Los nombres empiezan por una letra y usan letras, cifras, guiones bajos o guiones, con un límite de 50 caracteres. Se procesan hasta 50 reglas y 50 nombres distintos. Los eventos estándar, incluidos PageView, Purchase, Contact, SubmitForm, Download y Subscribe, están reservados.

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-cover img","params":{"content_type":"product"},"once":false},
  {"event":"SizeGuideView","trigger":"url","contains":["/size-guide"],"params":{"content_type":"page"}},
  {"event":"ContactIntent","trigger":"controller","controllers":["contact"],"modules":["contactform"]},
  {"event":"ConfiguratorChanged","trigger":"event","dom_event":"product:configured","params":{"configurator_step":"finish"},"once":false}
]

document.dispatchEvent(new CustomEvent('product:configured'));

Usa selector, contains, controllers/modules o dom_event para el activador correspondiente. once vale true por defecto para todos los tipos de regla de este módulo. El motor activo usa los parámetros configurados y no mezcla detalles arbitrarios de eventos DOM. Usa reglas configuradas en lugar del antiguo auxiliar window.mprtkpxTrack.

actionValidateOrder guarda el consentimiento y los identificadores de la sesión del comprador y pone en cola un Purchase apto. Un callback, webhook o una solicitud sin la sesión del comprador no puede proporcionarlos. El proceso vuelve a comprobar el consentimiento original y actual, el permiso de coincidencia, la política del personal, el destino y las reglas de salida. Una compra sin identificadores de coincidencia se retiene. Un token API por sí solo no basta para enviar compras.

El envío desde el servidor cubre compras y formularios confirmados por el servidor opcionales. Los eventos de navegación estándar y las reglas JSON personalizadas se envían desde el navegador. Las demás llamadas frontend no se pueden enviar mediante Events API.

Asegúrate de que tu ejecutor cron MPR compartido ejecute:

task: send_tiktok_events_api_conversions
callable: mprtiktokpixel::cronProcessTikTokConversions
schedule: every:300
context: any
timeout: 30

Las compras usan el proveedor de cola tiktok_events_api. El mismo proceso trata un canal separado de formularios confirmados, con un lote de 20 para ese canal. Las compras de navegador y servidor comparten el ID de evento del módulo basado en el pedido; valida los informes del proveedor en lugar de suponer que cada evento en cola se acepta o atribuye.

El módulo envía la compra al validar el pedido, lo que puede ocurrir antes de que se liquide el pago. No hay ningún ajuste para esperar al estado pagado ni un reenvío posterior cuando el pedido pasa a pagado.

Revisa preparación, recuentos de la cola y filas HTTP/de error recientes en la página de configuración. Usa un navegador de cliente y herramientas de prueba del proveedor para comprobar vista de página, vista de producto, cambio correcto del carrito, proceso de compra, registro y un pedido de prueba. Prueba el rechazo y la retirada como rutas separadas.

Enviar prueba API necesita un "Test event code" guardado, credenciales, titularidad del seguimiento y permiso de salida. Envía un PageView marcado con el código de prueba, con un objeto de usuario vacío y la URL raíz de tu tienda, no una compra inventada. Una prueba correcta muestra que la conexión funciona; no prueba compras reales ni atribución. Borra el código después de probar.

Reintentar eventos fallidos devuelve a pendientes las filas fallidas aptas de compra y formulario. Las filas sin consentimiento o sin datos guardados, las que TikTok rechazó definitivamente y las de envío dudoso se quedan como están. Revisa el motivo registrado antes de reintentar.

Si el Pixel no carga, revisa activación, "Pixel ID", permisos de marketing/servicio y coincidencia, política del personal, URL seguras, SDK duplicados y solicitudes bloqueadas. Si faltan eventos de carrito o lista de deseos, confirma las señales de éxito esperadas en tu tema.

Si faltan compras en la cola del servidor, comprueba que el consentimiento y los identificadores del comprador se guardaron al validar el pedido; la página de confirmación no puede añadirlos después. Revisa credenciales API, ejecuciones del proceso e identificadores de coincidencia. Si el JSON personalizado no se guarda, comprueba nombres, eventos reservados, campos de activadores y límites de reglas.

El módulo no crea feeds de productos, catálogos ni campañas publicitarias. Configúralos por separado si los usas.

Establece "Enable TikTok Pixel" en No y guarda para pausar esta integración. Desinstala desde el gestor de módulos para eliminar su menú, registro cron y configuración. La tabla de cola compartida se conserva si otro módulo usa el paquete de conversiones; en caso contrario, su auxiliar de desinstalación la elimina. Los datos compartidos de consentimiento y envío se gestionan por separado. Gestiona el Pixel y los informes históricos en TikTok.

Usa los nombres de ajustes anteriores cuando una captura de referencia difiera de tu versión instalada.