¿Pinterest Tag y API de Conversiones?

lorenaauto64

Hola a todos,

Estoy intentando integrar el Pinterest Tag y, lo más importante, la API de Conversiones de Pinterest en mi tienda PrestaShop. He intentado varias cosas, pero siempre acabo con soluciones frágiles que se rompen con las actualizaciones o no manejan bien la deduplicación de eventos.

Mi principal problema es enviar los eventos de compra de forma fiable desde el servidor (para la API de Conversiones), sin duplicarlos con los del front-end y asegurándome de que los datos del pedido son correctos.

Aquí un intento que hice para el tag base y un lugar donde pensaba poner la lógica de la API, pero no sé cómo manejar los datos y la llamada HTTP correctamente:

// En mi módulo personalizado, intentando usar hooks estándar:
public function hookDisplayHeader($params)
{
    // Esto solo inserta el JS del Pinterest Tag en el front-end.
    // Asigna el ID del tag y devuelve una plantilla Smarty con el script.
    // Pero ¿cómo hago el seguimiento de las conversiones de forma robusta?
    // ...
    return $this->display(__FILE__, 'views/templates/hook/header.tpl');
}
public function hookActionValidateOrder($params)

¿Alguien ha logrado integrar esto de manera efectiva en PrestaShop 8 sin líos?

manueldeco

Hola @lorenaauto64,

Entiendo tu frustración. La verdad es que la integración de la API de Conversiones de Pinterest no es trivial. El hookDisplayHeader solo te sirve para el tag base y eventos client-side. Para la API de Conversiones necesitas enviar eventos desde el servidor, y como bien dices, el hookActionValidateOrder es el lugar ideal para los eventos de compra.

El problema es que PrestaShop no tiene una solución nativa para esto. Tienes que construir la llamada HTTP POST manualmente, incluyendo los hashes SHA256 para los datos del cliente (email, teléfono, etc.) y asegurarte de enviar los parámetros event_id y event_source_url para la deduplicación. Es bastante código PHP y requiere manejo de cURL o Guzzle.

¿Qué versión exacta de PrestaShop estás usando? En PS 8.2.8 con PHP 8.1, esto puede ser un poco más estable, pero la lógica sigue siendo compleja.

inmasevilla

Totalmente de acuerdo con @manueldeco. El punto clave es la deduplicación y el envío correcto de datos hasheados. Si solo insertas el JS en el header.tpl, solo capturas eventos del navegador. La API de Conversiones es para cuando esos eventos no se pueden capturar bien en el front-end o para dar más fiabilidad.

El desafío está en el hookActionValidateOrder. No solo tienes que hacer la llamada HTTP, sino también asegurarte de que los datos de custom_data (valor del pedido, moneda, productos) y user_data (email, teléfono, IP) están correctamente formateados y hasheados. Un simple var_dump($order) no te da todo lo que necesitas para el payload de la API de Pinterest, tienes que extraerlo y transformarlo. Además, si el usuario hace checkout y luego el pago falla, pero luego vuelve y paga, podrías tener duplicados si no gestionas un event_id único por evento y un sistema de verificación.

Milo

Hola @lorenaauto64,

Los compañeros @manueldeco y @inmasevilla han dado en el clavo. Implementar la Etiqueta de Pinterest y, especialmente, la API de Conversiones de forma robusta en PrestaShop es un desafío significativo. El hookActionValidateOrder es el punto de partida correcto para un evento de compra server-side, pero la lógica que necesitas construir es extensa y propensa a errores si no se maneja correctamente.

Tu snippet muestra bien dónde empiezas a encontrarte con la complejidad. Para enviar un evento de compra a la API de Conversiones desde el servidor, necesitarías algo como esto en tu hookActionValidateOrder o en una función auxiliar:

// Ejemplo simplificado de cómo se estructuraría un payload para la API de Conversiones
// dentro de un hook como hookActionValidateOrder.
// Requiere un token de acceso a la API y una librería HTTP (como Guzzle) o cURL.
// ... dentro de public function hookActionValidateOrder($params) ...
$order = $params['order'];
$customer = $params['customer'];
$payload = [gestionar pinterest tag y api sin tocar el código core](https://mypresta.eu/es/modulos/publicidad-y-marketing/pinterest-tag-y-api-de-conversiones.html) y se encargan de toda la complejidad técnica, incluyendo la deduplicación, el hasheo de datos, las llamadas a la API y el soporte para diferentes eventos. Te ahorra mucho tiempo y futuros dolores de cabeza.

lorenaauto64

¡Muchas gracias, @Milo! Y también a @manueldeco y @inmasevilla por vuestros comentarios. Teníais toda la razón. Mi intento de código se quedaba muy corto y la complejidad de la API de Conversiones es enorme.

He estado revisando la opción del módulo que has mencionado y es justo lo que necesitaba. La verdad es que intentar replicar toda esa lógica a mano, incluyendo la deduplicación y el hasheo, era una locura. Ya lo tengo instalado y configurado, y parece que los eventos se envían correctamente sin duplicados.

Problema resuelto, ¡mil gracias por la ayuda!