Seguimiento de conversiones TikTok server-side

raulonline

Hola a todos,

Estoy intentando implementar el seguimiento del Píxel de TikTok mediante su API de eventos (server-side) para las compras en mi tienda PrestaShop. El seguimiento de JS en el lado del cliente está perdiendo demasiadas conversiones, especialmente con iOS 14+ y los bloqueadores de anuncios, y mi ROAS de TikTok Ads está por los suelos.

He intentado engancharme a actionValidateOrder para enviar el evento de compra, pero parece que a veces los datos del pedido no están completamente disponibles o me encuentro con objetos nulos, o simplemente el evento no se dispara correctamente en todos los escenarios de pago. Esto es lo que tengo hasta ahora en un módulo custom:

class MyTikTokTracker extends Module
{
    public function __construct()
    {
        // ... constructor de módulo
    }
    public function install()
    {
        return parent::install() && $this->registerHook('actionValidateOrder');
    }

¿Alguien ha conseguido una integración robusta para esto en PrestaShop 1.7? Necesito que sea fiable para las conversiones de compra.

inmalab

@raulonline, entiendo perfectamente la frustración. El seguimiento del lado del cliente es un dolor de cabeza últimamente.

Por tu código, parece que te estás enganchando en el lugar correcto (actionValidateOrder), pero es verdad que en algunas versiones de PrestaShop 1.7 y con ciertos módulos de pago, los objetos $order y $cart no siempre están completamente hidratados o accesibles de la misma manera justo en el momento del hook. ¿Qué versión exacta de PrestaShop 1.7 tienes? Eso puede influir.

Yo he visto problemas cuando se intenta acceder al Customer o a la lista de productos de la orden directamente desde el objeto $order tan pronto. A veces es mejor usar el $cart para los productos y el $customer de los parámetros si está disponible, o recargarlo.

antoniovlc

Totalmente de acuerdo con @inmalab. Lo de actionValidateOrder es un poco tricky. A mí me pasó algo similar intentando enviar datos a Google Analytics 4 server-side. La clave es asegurarse de que el objeto Order esté completamente guardado en la base de datos antes de intentar extraer todos los detalles.

En tu snippet, veo que intentas construir el payload. ¿Estás seguro de que la lista de productos $order->getProducts() devuelve siempre lo esperado en ese punto? Para PS 1.7.7.2, a veces es más seguro recorrer los productos del carrito ($cart->getProducts()) y luego verificar que coincidan con los de la orden si ya está completa. También el id_currency y total_paid_tax_incl del objeto Order deberían ser fiables una vez la orden se ha validado.

Milo

Hola @raulonline, la situación que describes es muy común y el cambio hacia el seguimiento server-side es una necesidad. En PrestaShop 1.7.7.2, actionValidateOrder es el hook idóneo para capturar el evento de compra. El problema que a veces encuentras con objetos nulos o incompletos suele deberse a cómo se accede a los datos o a la secuencia de eventos dentro de PaymentModule::validateOrder().

La clave es asegurarte de que, al momento de ejecutar tu lógica, el objeto Order ya esté completamente persistido y que obtengas los detalles de sus relaciones (cliente, productos) de forma robusta. Aquí te propongo una modificación a tu hookActionValidateOrder que debería ser más fiable:

public function hookActionValidateOrder($params)
{
    if (!isset($params['order']) || !($params['order'] instanceof Order) || !Validate::isLoadedObject($params['order'])) {
        return;
    }
    $order = $params['order'];
    $customer = new Customer((int)$order->id_customer); // Cargar el cliente si no está en $params
    $currency = new Currency((int)$order->id_currency);
    $contents = [];
    foreach ($order->getProducts() as $product) {

He añadido algunas verificaciones para order y he cargado el objeto Customer explícitamente usando el id_customer del pedido, que es más seguro. También he iterado sobre order->getProducts() y he construido un event_id más robusto. Recuerda que los datos de usuario como el email y el teléfono deben ser hasheados (SHA256) antes de enviarse a TikTok para cumplir con la privacidad. Esto debería darte una base mucho más sólida para tu integración.

raulonline

¡Muchas gracias, @Milo! Esa revisión del hook es justo lo que necesitaba. Los getProducts() del objeto Order y la forma de asegurar el Customer son la clave. Ya he integrado la lógica de cURL con tu estructura de payload y parece que ahora el seguimiento es muchísimo más fiable.

He probado con varias pasarelas de pago y los eventos se disparan correctamente en el lado del servidor. ¡Se acabó lo de perder conversiones por los bloqueadores! Aprecio mucho tu ayuda tan detallada y el snippet de código, me ha salvado un montón de tiempo.