Guía de uso

Si viene de la versión 1

Si su tienda usa Order Source Tracking 1.x, el nombre anterior de este módulo, lo actualiza sobre la instalación existente y conserva sus datos. El módulo tiene un nombre nuevo, un menú nuevo y una nueva forma de registrar las visitas, y su panel cuenta de otra manera. Este capítulo le dice qué esperar.

Cómo actualizar

Compruebe que su tienda usa PrestaShop 8.0 o posterior. La versión 2 no se instala en PrestaShop 1.7; una tienda así se queda en la versión 1.
Abra Módulos › Gestor de módulo, haga clic en Subir un módulo y seleccione el nuevo zip. PrestaShop ejecuta la actualización.
Abra Pedidos › Orígenes de pedidos › Ajustes y lea la Lista de comprobación.

No desinstale antes la versión 1. Si la actualización se detiene a medias, por ejemplo porque una tabla grande tarda demasiado, vuelva a subir el zip: la actualización continúa donde se detuvo.

Qué se conserva

Datos de la versión 1	Tras la actualización
Los orígenes de sus pedidos	Se conservan, para cada pedido que todavía existe. El origen y el medio están ahora en minúsculas, así que «Facebook» y «facebook» se han convertido en un mismo origen.
Visitas	Se conservan si tienen menos de 13 meses. Las visitas más antiguas no se trasladan. Una tabla grande se copia mes a mes, empezando por el más reciente; lo que la actualización no termina, lo termina la limpieza diaria. Las visitas copiadas no tienen página de destino, término, contenido ni tipo de clic en un anuncio: la versión 1 no los guardaba.
Sus ajustes	Se conservan: la ventana de atribución, sus reglas de referente, sus sitios excluidos, sus direcciones de prueba y los dos interruptores de las columnas del primer y del último contacto de la pestaña Pedidos del módulo.
Visitantes a mitad de camino	Un visitante que llegó antes de la actualización y hace el pedido después sigue recibiendo el primer y el último contacto correctos: el módulo lee una vez las cookies de la versión 1 y después las elimina.
Las tablas de la versión 1	La actualización no las toca. Se conservan durante 30 días como medida de seguridad y después la limpieza las elimina. Hasta entonces, la Lista de comprobación muestra una línea en ámbar que lo indica, y Datos y mantenimiento indica la fecha. Es información, no un problema.

Qué ha cambiado

Tema	Versión 1	Ahora
Nombre y menú	Order Source Tracking: tres entradas en Pedidos, y los ajustes en el Gestor de módulo	Order Source Pro: una entrada, Orígenes de pedidos, con las pestañas Panel, Pedidos, Visitas y Ajustes
Pedidos que el proveedor de pago confirma en segundo plano	No tenían origen	Reciben su origen: viaja con el carrito
Pedidos creados en el back office	Tomaban el origen de las propias visitas del empleado	No tienen origen, lo que se corresponde con la realidad
Reglas de referente y sitios excluidos	Se guardaban y nunca se usaban	Se aplican
Volver de una página de pago	Podía convertirse en el origen del pedido	Nunca cuenta; sus propios dominios y los proveedores de pago habituales están excluidos
Clics en anuncios sin parámetros UTM	No se reconocían	Se reconocen (Plataformas publicitarias: reconocidas sin parámetros UTM)
Lo que guarda una visita	Dirección IP, navegador, dispositivo y las páginas vistas	Nada de eso (Qué se guarda y qué no)
Ajustes	Una página en el Gestor de módulo	Una pestaña con secciones, con ajustes nuevos para la detección, el consentimiento, la conservación y la visualización. Empiezan con los mismos valores que tras una instalación nueva (Ajustes)

Pantallas que ya no existen

Las dos pantallas de importación de CSV, la pantalla de exportación de visitantes y la exportación por rango de fechas encima de la lista de pedidos. Las pestañas Pedidos y Visitas exportan con el botón de su lista.
La página de detalles de un visitante. Todo lo que contiene una visita está en la lista.
Los ajustes «Track First UTM» y «Track Last UTM». Nunca tuvieron efecto.

Las nuevas cifras del panel

Tras la actualización, el panel muestra un aviso: «Las cifras de esta página cambiaron en la versión 2.1. Solo cuentan los pedidos válidos, y los ingresos son lo pagado sin impuestos y sin envío, en su moneda predeterminada, como en la página Inicio de PrestaShop. Un pedido cuenta el día en que se realizó». Permanece hasta que hace clic en Cerrar. La Qué significa cada cifra explica el día en que cuenta un pedido, la única diferencia mantenida intencionadamente. Detrás del aviso:

Cifra	La versión 1 contaba	Ahora
Pedidos	Todos los pedidos, incluidos los cancelados y los no pagados	Solo los pedidos válidos, y todos ellos: los pedidos sin origen son la fila Sin seguimiento
Ingresos	Los totales de los pedidos, sin conversión entre monedas	Sin impuestos y sin envío, convertidos a su moneda predeterminada
Pedidos sin origen	«Unknown»	Sin seguimiento, con la cifra Pedidos con seguimiento para indicar cuántos tienen origen

Por eso los totales de un mes pasado pueden diferir de lo que mostraba la versión 1. No se ha perdido nada: los pedidos cancelados y no pagados ya no cuentan, y los ingresos dejan fuera los impuestos y el envío. Para informar con impuestos, cambie Ingresos en el panel a Con impuestos (Pedidos: dónde se muestra el origen). En una multitienda, las visitas antiguas que no condujeron a ningún pedido están todas en la tienda predeterminada (Visitas de la versión 1).

Preguntas y problemas

Empiece por la Lista de comprobación en Ajustes › Resumen: la mayoría de los problemas aparecen allí, con un enlace a la sección que los resuelve. Un fallo del módulo no detiene ninguna página de su tienda: en su lugar se escribe en Parámetros Avanzados › Registros/Logs, en una línea que empieza por pch_ordersource.

Problemas

No aparece ninguna visita

Haga una visita de prueba: abra su tienda en una ventana privada y añada ?utm_source=test a la dirección. Si el registro empieza Cuando el visitante acepta las cookies, acepte primero el banner de cookies en esa página. Abra la pestaña Visitas al cabo de un minuto.
Si no aparece y el registro espera al consentimiento, puede que su banner no comunique al módulo la respuesta del visitante: entonces no se registra absolutamente nada (Consentimiento: cuándo puede empezar el registro).
Mire Ajustes › Detección. Con Solo servidor y una caché de página, las páginas en caché no se registran. Elija Solo script, como explica el apartado Mi tienda usa una caché de página o una CDN.
Con Solo script, un navegador que bloquea los scripts, o una regla de un cortafuegos situado delante de su tienda, puede impedir la notificación del script. Pruebe con otro navegador sin extensiones.
¿Sigue sin aparecer nada? Active Registrar las decisiones en Ajustes › Datos y mantenimiento, repita la visita de prueba y lea Parámetros Avanzados › Registros/Logs: el módulo escribe lo que registró u omitió, y por qué, en líneas que empiezan por pch_ordersource. Después desactive el ajuste.

Algunas llegadas se omiten intencionadamente: los robots de los buscadores y las herramientas de monitorización, una página que el navegador solo carga por adelantado y la vuelta desde una página de pago.

Pedidos sin origen (Sin seguimiento)

Un pedido no tiene origen cuando el módulo no ha podido vincularlo a una visita. Los motivos habituales:

El pedido se creó en el back office o a través del webservice.
El pedido se realizó antes de instalar el módulo.
El navegador del visitante rechazó o eliminó la cookie, o el visitante no aceptó en su banner de cookies.
La propia visita no se registró, por uno de los motivos anteriores.

Es normal que una parte de los pedidos quede sin seguimiento. La cifra Pedidos con seguimiento del panel le indica su proporción. Si es baja, revise primero el ajuste de consentimiento: con Cuando el visitante acepta las cookies, todo visitante que no acepta queda sin seguimiento.

Las cifras difieren de las de Google Analytics

Diferirán, y ninguna de las dos herramientas se equivoca. Las dos cuentan cosas distintas:

Diferencia	Order Source Pro	Un servicio de analítica
Pedidos	Los pedidos reales de su tienda, cuando son válidos, incluidos los que el proveedor de pago confirma en segundo plano.	Los pedidos que su script vio en la página de confirmación.
Ingresos	Sin envío, sin impuestos salvo que haya elegido otra cosa, en su moneda predeterminada.	Lo que envía el código de seguimiento de su tienda, a menudo con impuestos y envío.
Qué visita se queda con el pedido	El primer contacto, o el último contacto no directo, dentro de su ventana de atribución.	Su propio modelo y su propia ventana.
Una visita	Una llegada; 30 minutos sin ver ninguna página la terminan.	Una sesión, según sus propias reglas.
A quién se cuenta	Depende de sus ajustes de Detección y Consentimiento.	Depende de sus propios ajustes de consentimiento y de los bloqueadores de scripts.

Compare más bien con la página Inicio de PrestaShop: cuenta los pedidos y las ventas con las mismas reglas. La Qué significa cada cifra indica lo único que difiere intencionadamente: el día en que se cuenta un pedido.

Mi tienda usa una caché de página o una CDN

Elija Solo script en Ajustes › Detección, como aconseja la ayuda del campo. Es la opción que debe usar cuando la caché o la CDN elimina las cookies de las páginas que almacena. Nunca Solo servidor: una página en caché se envía sin consultar a la tienda. La Lista de comprobación le avisa cuando encuentra un módulo de caché de página junto con Solo servidor. Si su caché está configurada fuera de PrestaShop, por ejemplo en su proveedor de alojamiento, la lista de comprobación no puede verla: elija usted mismo el ajuste.

Mi tienda tiene un banner de cookies

Decida si sus visitantes deben dar su consentimiento antes de que se registren sus visitas; es una cuestión jurídica (Consentimiento: cuándo puede empezar el registro). Si es así, elija Cuando el visitante acepta las cookies y asegúrese de que su banner comunica la respuesta: un banner con Google Consent Mode lo hace por sí solo, cualquier otro banner necesita una llamada. Después pruébelo: en una ventana privada, una visita solo debe aparecer en la pestaña Visitas después de que haya aceptado.

Un proveedor de pago aparece entre mis orígenes

Añada su dominio en Ajustes › Sitios excluidos (Sitios excluidos: páginas desde las que un cliente solo vuelve). Las visitas ya registradas conservan su origen; las nuevas ya no lo reciben.

El sitio de un socio aparece con su dominio, o se cuentan mis propias visitas

Un sitio sin regla se registra con su dominio, como sitio referente: asígnele el origen que quiera en Ajustes › Reglas de referente (Reglas de referente: el origen que usted elija para un sitio). Para dejar sus propias visitas fuera del panel, añada su dirección en Direcciones IP de prueba, en Ajustes › Atribución.

La lista de comprobación dice que la limpieza no se ha ejecutado

La limpieza se ejecuta cuando alguien abre el back office. Haga clic en Ejecutar ahora en Ajustes › Datos y mantenimiento. Para una tienda cuyo back office no se abre todos los días, haga que una tarea programada llame a la Dirección de mantenimiento una vez al día (La dirección de mantenimiento).

Faltan visitas de una oficina o de una red

Para frenar las avalanchas, el módulo registra como máximo 30 visitas nuevas por minuto desde una misma dirección. Los visitantes reales nunca llegan a esa cifra, salvo que su tienda esté detrás de un proxy o de una CDN que muestre a la tienda una única dirección para todos. Su proveedor de alojamiento puede configurar el servidor para que la tienda vea la dirección real de cada visitante.

Un empleado no puede abrir las pestañas del módulo

Las cuatro pestañas son páginas del menú del back office. Dé al perfil del empleado el permiso para verlas en Parámetros Avanzados › Equipo › Permisos. La columna Origen y la tarjeta Origen del pedido no necesitan ningún permiso propio.

Límites conocidos

Límite	Qué significa (una propiedad de la forma en que funciona el módulo, no un fallo)
Un navegador es un visitante	Una persona que hace clic en un anuncio en el móvil y compra en el portátil cuenta como dos visitantes. El pedido recibe el origen con el que llegó el portátil.
Pedidos creados en el back office	No tienen origen: ninguna visita del cliente lleva a ellos. Lo mismo vale para los pedidos que llegan a través del webservice.
Visitantes que rechazan la cookie	No se registran, y sus pedidos no tienen origen. Con Cuando el visitante acepta las cookies, son todos los visitantes que no aceptan. Un navegador que no conserva cookies parece nuevo en cada página; el límite contra avalanchas evita que llene sus listas.
Consentimiento tardío	Con Cuando el visitante acepta las cookies, un visitante que acepta solo después de salir de la primera página se registra como directo.
Un proxy que oculta las direcciones de los visitantes	El límite contra avalanchas cuenta entonces a todos juntos (véase más arriba).
Varias tiendas	Una tienda en una carpeta de otra tienda comparte sus visitantes con ella. Las visitas de la versión 1 que no condujeron a ningún pedido están en la tienda predeterminada (Varias tiendas).
Solo primer y último contacto	El módulo no reparte un pedido entre varios orígenes y no importa el coste publicitario. Un pedido recibe su origen una sola vez: un ajuste o una regla que cambie después no reescribe los pedidos ni las visitas ya guardados.
PrestaShop 1.7	La versión 2 no es compatible con PrestaShop 1.7.

Preguntas frecuentes

¿Qué ven mis clientes?

Nada: ninguna ventana emergente y ningún banner. Según Detección, se carga un pequeño script después de la página. Envía una breve notificación por visita, a su propia tienda.

¿Por qué pesa tanto «directo»?

Directo incluye todas las visitas que no dicen nada sobre su procedencia: direcciones escritas y marcadores, y también enlaces en aplicaciones, en programas de correo electrónico y en mensajes que no llevan parámetros. Etiquete con parámetros UTM los enlaces que publica (Crear enlaces de campaña) y esa parte se reducirá.

Soporte

PrestaChamps desarrolla este módulo y le da soporte. Inicie sesión en addons.prestashop.com, abra su pedido de Order Source Pro y escriba al desarrollador con el formulario de contacto. Indíquenos sus versiones de PrestaShop, PHP y del módulo, lo que esperaba y lo que ocurre en su lugar, con una captura de pantalla de la Lista de comprobación. Si faltan visitas u orígenes, active Registrar las decisiones, reproduzca el problema y envíenos las líneas del módulo de Parámetros Avanzados › Registros/Logs. No envíe nunca su propia contraseña: si necesitamos ver su back office, le pediremos una cuenta de empleado temporal.

Para desarrolladores

Este capítulo es para la persona que configura su banner de cookies, su servidor o sus informes: las llamadas de JavaScript para un banner de cookies, la dirección para una tarea programada y las tablas que hay detrás de las listas.

Las llamadas de JavaScript para un banner de cookies

Solo importan cuando Cuándo empieza el registro está en Cuando el visitante acepta las cookies (Consentimiento: cuándo puede empezar el registro). El script del módulo no guarda entonces nada ni instala ninguna cookie hasta que sabe que el visitante ha dado su consentimiento.

Google Consent Mode

No hay nada que añadir. El script lee las entradas de consentimiento que su banner envía a window.dataLayer:

Una entrada que pone analytics_storage en granted inicia el registro, tanto si es una entrada default como update.
Una entrada update que lo pone en denied retira el consentimiento.
Una entrada default con denied es el estado inicial del banner: no cambia nada.

Cualquier otro banner

window.pchOrderSource.grantConsent();    // el visitante aceptó las cookies de estadísticas
window.pchOrderSource.revokeConsent();   // el visitante retiró su consentimiento, o rechazó las cookies tras haberlas aceptado

Un banner que conoce pronto la respuesta guardada puede establecer en su lugar un indicador, antes de que se ejecute el script del módulo: window.pchOrderSourceConsent = 'granted', o 'denied'.

Qué ocurre	Efecto
Se concede el consentimiento en la página a la que llegó el visitante	La visita se registra con su origen real. Las páginas siguientes de la misma visita no necesitan una nueva señal.
Se concede el consentimiento en una página posterior	La visita se registra como directa: la campaña de la llegada ya no se conoce.
Se retira el consentimiento	El script elimina el marcador de la visita y la tienda elimina las dos cookies. Las visitas ya guardadas no se eliminan (Exportar y borrar los datos de un cliente).

Para comprobar su configuración, abra la tienda en una ventana privada: antes de aceptar no debe existir ninguna cookie llamada pch_os_v o pch_os_s; después de aceptar existen las dos, y la visita está en la pestaña Visitas.

La dirección de mantenimiento

La limpieza se inicia cuando alguien abre el back office. Si el suyo permanece cerrado durante días, haga que una tarea programada (una tarea cron) llame a la dirección de mantenimiento una vez al día.

Abra Ajustes › Datos y mantenimiento y haga clic en Copiar junto a Dirección de mantenimiento.
En el panel de control de su alojamiento, cree una tarea programada que llame a esta dirección una vez al día, a una hora tranquila. La mayoría de los paneles tienen un campo para una dirección; en un servidor con línea de comandos, basta con una línea como esta:

# todos los días a las 03:15; pegue entre las comillas la dirección que ha copiado
15 3 * * * curl -fsS "PASTE-THE-MAINTENANCE-ADDRESS-HERE" > /dev/null

Una llamada que ha funcionado responde con OK y lo que ha eliminado, por ejemplo OK visits=0 cart_links=0 legacy_tables=0. La dirección contiene una clave secreta: trátela como una contraseña. Una llamada sin la clave correcta se rechaza y no hace nada. Es la misma dirección para todas las tiendas de una multitienda.

Las tablas

El módulo guarda sus datos en cuatro tablas, precedidas del prefijo de tablas de su tienda (ps_ en la mayoría de las tiendas). Léalas para sus propios informes; no escriba en ellas.

Tabla	Una fila es
`pch_ordersource_visit`	Una visita: `visitor_key`, `id_shop`, `date_add`, `source`, `medium`, `campaign`, `term`, `content`, `click_id_type`, `landing_path`, `referrer_host`, `id_order`, `is_test`, `origin`.
`pch_ordersource_order`	El origen de un pedido: `id_order`, `id_shop`, después `first_source`, `first_medium`, `first_campaign`, `first_term`, `first_content`, `first_click_id_type`, `first_landing_path`, `first_date`, y las mismas ocho columnas con `last_`.
`pch_ordersource_cart`	El vínculo entre un carrito y su visitante: `id_cart`, `visitor_key`, `date_add`.
`pch_ordersource_guard`	El contador del límite contra avalanchas. La limpieza diaria elimina sus filas.

Valores que conviene conocer

Una visita directa se guarda con el origen (direct) y el medio (none). Un enlace con utm_source y sin utm_medium tiene el medio (not set).
click_id_type está vacío o es uno de google, microsoft, tiktok, meta.
origin indica cómo se registró la visita: 0 por la tienda, 1 por el script, 2 copiada de la versión 1, 3 leída de una cookie de la versión 1. Las filas con 3 solo existen para la atribución; déjelas fuera cuando cuente visitas, como hace el panel.
El panel cuenta los pedidos con valid = 1 por date_add y suma (total_paid_tax_excl - total_shipping_tax_excl) / conversion_rate (con impuestos: las dos columnas _tax_incl). Un pedido sin fila en pch_ordersource_order no tiene seguimiento.

Cómo se conecta el módulo a su tienda

La notificación del script. Una breve petición por visita a /module/pch_ordersource/beacon de su propia tienda, que solo acepta peticiones de las páginas de su tienda. Un cortafuegos situado delante de su tienda tiene que dejarla pasar.
El pedido. El módulo vincula un carrito con su visitante cuando el carrito se guarda en la parte pública de la tienda, y anota el origen cuando PrestaShop valida el pedido. En ese momento no lee ninguna cookie, así que un pedido confirmado por el servidor de un proveedor de pago también recibe su origen. Los carritos creados en el back office o a través del webservice no se vinculan.

↑

Si viene de la versión 1 — Order Source Pro