PrestaShop

El módulo oficial de Reskyt para PrestaShop identifica qué carritos y qué pedidos llegan desde la app, los deja visibles dentro del Back Office y permite crear cupones que solo funcionan en la app.

Compatibilidad

PrestaShop 1.7.7.0 o superior, con PHP 7.2 o superior y MySQL 8.0 o superior.

Versión actual

1.8.3 · Descargar reskytmodule 1.8.3 (.zip)

Qué hace

Atribución de pedidos. Marca los pedidos que proceden de la app y añade al listado de pedidos una columna From Reskyt con filtro, en la posición que elijas. En la ficha del pedido y en la del carrito aparece además un distintivo From Reskyt App.

Cupones exclusivos de app. Permite marcar cualquier regla de carrito como “solo app”, con la opción de aplicarla automáticamente.

Pantalla de seguimiento. Bajo Marketing › Reskyt hay un listado de solo lectura con el recorrido completo de carrito a pedido, incluidos los carritos que nunca llegaron a convertirse.

Acceso por API. Expone el origen de cada pedido como recurso del webservice REST nativo de PrestaShop.

Cómo se decide que un pedido viene de la app

La señal es el User-Agent de la petición: si contiene rktwebview, el tráfico procede de la app.

Esa señal se captura durante toda la vida del carrito y nunca se pierde una vez detectada. Es intencionado: en un checkout que pasa por una pasarela de pago externa, no todas las peticiones conservan el User-Agent, y sin esa persistencia se perderían atribuciones legítimas.

Puedes elegir en qué momento se decide la atribución:

Modo	Cuándo marca el pedido
First touch (add to cart)	En cuanto la primera petición del carrito llega desde la app. Es el valor por defecto
Checkout start	Cuando el cliente llega al checkout desde la app

Cupones exclusivos de app

Los cupones se siguen creando donde siempre, en Catálogo › Reglas de carrito. El módulo añade dos casillas en la pestaña de condiciones:

Casilla	Qué hace
App only (Reskyt)	La regla solo se aplica en carritos que vienen de la app. Si alguien introduce el código fuera de la app, el módulo lo retira del carrito
Auto-apply on app carts	El módulo adjunta la regla automáticamente al carrito en cuanto detecta que viene de la app, sin que el cliente escriba nada

Instalación

Sube el módulo

En el Back Office, ve a Módulos › Gestor de módulos y pulsa Subir un módulo. Selecciona el zip.

Si prefieres hacerlo por fichero, copia la carpeta reskytmodule dentro del directorio modules/ de tu instalación y luego instálalo desde el Gestor de módulos.

Configura los tres ajustes

Entra en la configuración del módulo:

Ajuste	Qué hace
Enable app order flag	Activa o desactiva toda la funcionalidad del módulo
Attribution mode	First touch o Checkout start, según la tabla de arriba
Column Position	Dónde se coloca la columna Reskyt en el listado de pedidos

Habilita el webservice, si lo vas a usar

En Parámetros avanzados › Webservice, da acceso a tu clave API al recurso reskyt_orders. El recurso está pensado para lectura, así que basta con permiso de GET.
Comprueba el resultado

Haz un pedido de prueba desde la app y verifica que aparece marcado en Pedidos y que el recorrido se ve en Marketing › Reskyt.

Consultar la atribución por API

GET /api/reskyt_orders/{id_order}
GET /api/reskyt_orders?filter[is_reskyt_order]=1
GET /api/reskyt_orders?display=full

El identificador del recurso es el propio id_order.

Actualizar y desinstalar

El módulo trae sus propios scripts de actualización, así que puedes instalar una versión nueva encima de la anterior.

Al desinstalarlo se borran los tres ajustes de configuración, pero los datos de atribución ya registrados se conservan, de modo que una reinstalación recupera el histórico.

Si algo falla

Escribe a support@reskyt.com indicando tu versión de PrestaShop y la del módulo. Ver soporte.