Integración Reddit Pixel: configuración y ayuda

Sigue los pasos de Inicio rápido.

Configúralos en Módulos -> Reddit Pixel -> "Configure".

• "Enable Reddit Pixel". Activa o desactiva el seguimiento del Pixel en el navegador; predeterminado: 0.

• Pixel ID. Guarda tu ID de Reddit Pixel de "Reddit Ads Manager" -> "Events Manager"; predeterminado: "". Debe tener entre 4 y 128 caracteres, solo letras, números, guiones bajos y guiones.

• "Exclude employee browsing". Detiene el seguimiento cuando un empleado conectado al back office visita la tienda; predeterminado: 1.

• "Respect marketing consent". Carga el seguimiento de Reddit solo tras el consentimiento de marketing si está activo mprcookiesrevolution o mprcookiebanner; predeterminado: 1.

• "Track PageVisit". Envía un evento general de visita en las páginas de la tienda con seguimiento; predeterminado: 1.

• "Track ViewContent". Envía eventos de visualización en páginas de producto cuando hay datos del producto; predeterminado: 1.

• "Track AddToCart". Envía eventos de adición al carrito tras un aumento de cantidad correcto y confirmado; predeterminado: 1.

• "Track AddToWishlist". Envía eventos de adición a favoritos a partir de adiciones correctas y confirmadas; predeterminado: 1.

• "Track InitiateCheckout". Envía la entrada al pago como un evento personalizado de Reddit llamado InitiateCheckout; predeterminado: 1.

• "Track Search". Envía eventos de búsqueda en páginas relacionadas con búsquedas cuando hay una consulta; predeterminado: 1.

• "Track Purchase". Envía eventos de compra al confirmar el pedido con su valor, moneda, productos, ID de transacción e ID de conversión; predeterminado: 1.

• "Track SignUp". Envía un evento de registro en la siguiente carga de página tras crear una cuenta de cliente; predeterminado: 1.

• "Track custom events". Activa tus reglas JSON de eventos personalizados para el seguimiento del Pixel en el navegador; predeterminado: 0.

• Reglas de eventos personalizados. Guarda el array JSON usado para reglas de clic, URL, controlador y eventos DOM; predeterminado: "".

• "Enable Conversions API events". Encola eventos aptos en el servidor y los envía a Reddit con ID de conversión coincidentes cuando el transporte los admite; predeterminado: 0.

• Token de acceso de Conversions API. Guarda el token de Reddit Conversions API generado en "Reddit Ads Manager" -> "Events Manager"; predeterminado: "".

• "Events testing ID". Si se rellena, activa el modo de prueba de Reddit para las cargas CAPI; predeterminado: "".

• "Queue batch limit". Controla cuántos eventos de conversión de la cola se procesan por ejecución, de 1 a 100; predeterminado: 20.

• "Persist consent withdrawals". Predeterminado: 0. Activa un veto persistente para eventos de compra y formularios de contacto aceptados anteriormente. Actívalo si necesitas conservar las retiradas del consentimiento.

Haz clic en Guardar tras modificar el formulario.

El formulario actual también ofrece estos ajustes. Todos los interruptores de señales están en No de forma predeterminada. Activa solo las acciones que quieras observar.

Los umbrales compartidos son tres vistas de galería, un cambio de variante, un clic en detalles, 45 segundos de permanencia y un intervalo mínimo de 1500 ms para las opciones. Los recuentos de galería, variantes y detalles están limitados de 1 a 20. La permanencia está limitada de 5 a 600 segundos. El intervalo está limitado de 250 a 60000 ms. Por ejemplo:

{"min_gallery_views":3,"min_variant_changes":1,"min_detail_clicks":1,"dwell_seconds":45,"option_throttle_ms":1500}

También puedes proporcionar gallery_selectors, variant_selectors y detail_selectors. Mantén los valores predeterminados salvo que tu tema necesite otros selectores. Estas señales opcionales requieren comprobaciones de consentimiento, política de empleados y titularidad del seguimiento, como los eventos comerciales.

Mantén activados los ajustes de consentimiento y exclusión de empleados durante la configuración inicial. Prueba desde un navegador de visitante normal sin marca de empleado. Una sesión conectada al back office, una regla de tráfico interno o la exclusión voluntaria del visitante puede impedir el seguimiento.

La capa de consentimiento compartida admite integraciones de MPR y adaptadores CMP adicionales. Debe obtener una decisión de marketing utilizable para el destino. Una decisión desconocida, caducada o negativa puede retener eventos. El módulo no proporciona un banner de cookies. Una preferencia de consentimiento antigua no anula una negativa actual de una CMP detectada.

El módulo debe ser titular del destino configurado en el coordinador de seguimiento compartido. Una titularidad ausente, ambigua o en conflicto puede retener los envíos del navegador y servidor. Elimina las etiquetas duplicadas del tema o resuelve la titularidad si otro módulo MPR gestiona la misma cuenta.

El envío en producción también sigue la política de salida. Un evento que se ve en la demo o la vista previa no llega necesariamente a tu cuenta publicitaria. Las compras y los eventos de formularios del servidor solo se envían con el consentimiento que el comprador dio en ese momento; una ejecución cron posterior no puede sustituirlo.

La cabecera de tu tienda proporciona una configuración compatible con la caché. El módulo carga https://www.redditstatic.com/ads/pixel.js tras superar las comprobaciones. No aparece un widget habitual en la tienda. El módulo admite displayHeader, displayOrderConfirmation, actionValidateOrder, actionCustomerAccountAdd, displayFooter y displayBeforeBodyClosingTag.

Con los interruptores correspondientes activados, las visitas envían PageVisit, las páginas de producto ViewContent y las páginas de consulta Search; las adiciones confirmadas al carrito y favoritos envían sus eventos correspondientes. La entrada al pago envía Reddit Custom con customEventName=InitiateCheckout. La creación de cuenta se marca para SignUp en la siguiente carga de página apta.

Las compras incluyen los artículos disponibles del pedido, cantidades, valor, moneda e ID de transacción y conversión. Las compras del servidor y del navegador comparten la misma identidad de compra cuando está disponible. Las adiciones al carrito y a la lista de deseos necesitan confirmación de una adición real; un evento del navegador por sí solo no basta.

Los eventos del servidor se envían al endpoint de Reddit https://ads-api.reddit.com/api/v2.0/conversions/events/PIXEL_ID con el Pixel ID configurado. Los datos de coincidencia que se envían dependen de la atribución original y del consentimiento del visitante. Las copias del navegador y del servidor comparten un ID de evento para la deduplicación cuando se envían ambas, pero no todos los eventos se envían por las dos vías.

Activa "Track custom events", pega un array JSON en Reglas de eventos personalizados y guarda. Adapta los selectores y las rutas a tu tienda. Usa activadores click, url, controller o event. Una regla de controlador también puede incluir una lista modules. Los nombres admiten letras, números, guiones bajos y guiones, hasta 64 caracteres. El límite es de 15 nombres distintos. once limita una regla durante la ejecución de la página actual.

[
  {
    "event": "GalleryBrowse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "params": {
      "property": "product_gallery"
    },
    "once": false,
    "capi": true
  },
  {
    "event": "LandingView",
    "trigger": "url",
    "contains": [
      "/special-offer"
    ],
    "params": {
      "property": "special_offer"
    },
    "once": true,
    "capi": true
  },
  {
    "event": "ContactView",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "params": {
      "property": "contact_page"
    },
    "once": true,
    "capi": true
  },
  {
    "event": "SizeGuideOpen",
    "trigger": "event",
    "dom_event": "mprreddit:sizeGuideOpen",
    "params": {
      "property": "size_guide"
    },
    "once": false,
    "capi": true
  }
]

Activa la regla DOM desde tu tema tras inicializar el seguimiento:

document.dispatchEvent(new CustomEvent('mprreddit:sizeGuideOpen'));

La marca capi de cada regla envía una copia de servidor a través del puente personalizado. El puente acepta Custom con customEventName, comprueba que la regla esté configurada y necesita un ID de evento y el consentimiento actual del visitante. Sin ellos, el evento se retiene.

En la regla de clic, los atributos de datos admitidos pueden sustituir value, currency, num_items y event_id, por ejemplo:

<button class="track-reddit-demo" data-reddit-param-value="12.50"
        data-mprreddit-param-currency="EUR">Track custom action</button>

Usa un selector de clic coincidente en tu regla. El runtime actual no utiliza el ejemplo antiguo de atributos product_id y product_category. Un evento DOM puede proporcionar valores comerciales admitidos en detail.params. Coloca los parámetros descriptivos estáticos en la propia regla.

La tarea send_reddit_conversions está registrada con la programación every:300. Vence cada cinco minutos. Tu ejecutor cron MPR compartido debe ejecutar las tareas pendientes; la declaración por sí sola no inicia un proceso de trabajo. El límite de lote acota las filas de la cola por ejecución de 1 a 100, con 20 de forma predeterminada.

El módulo no incluye un punto de entrada independiente cron.php. Usa el planificador compartido ya configurado para tu tienda. Confirma allí la ejecución de tareas y comprueba las marcas de tiempo y el estado de la cola en la página de configuración del módulo.

El diagnóstico incluye comprobaciones de preparación, contadores de cola, filas recientes, Enviar prueba API y Reintentar eventos fallidos. Resuelve la causa del fallo antes de reintentar. Devolver filas fallidas al estado pendiente no omite las comprobaciones actuales de consentimiento, política de empleados, titularidad de cuenta o destino.

Para Enviar prueba API, introduce un "Events testing ID" y ten un evento real pendiente de un comprador que dio su consentimiento. Sin ID de prueba, consentimiento actual o un evento utilizable en la cola, la prueba se rechaza; nunca crea una compra ficticia. Vacía "Events testing ID" cuando estés listo para los eventos de producción.

1. Comprueba los avisos de configuración necesaria, la titularidad del seguimiento y el banner de integridad.
2. Usa un navegador de visitante normal y concede el consentimiento de marketing mediante tu CMP configurada.
3. Abre un producto, realiza una búsqueda y completa una adición correcta al carrito. Comprueba la carga del SDK y las solicitudes de eventos correspondientes en el panel de red del navegador.
4. Consulta el diagnóstico de eventos de Reddit o Pixel Helper, si está disponible en tu entorno de pruebas.
5. Para las compras, usa un flujo de prueba autorizado e inspecciona el evento del navegador, el ID de conversión y la fila de la cola.
6. Para el envío del servidor, ejecuta el planificador configurado y comprueba el resultado de la cola. Una llamada del navegador aceptada por tu tienda no ha llegado necesariamente a Reddit.

Si no carga ningún script, comprueba "Enable Reddit Pixel", la sintaxis de Pixel ID, el consentimiento, las marcas de empleados, la titularidad, la política de salida y los bloqueadores de scripts. Si faltan eventos de carrito o favoritos, inspecciona las señales de operación correcta y los datos del producto. Un clic solo no basta. Usa reglas personalizadas para interacciones separadas sin etiquetar un clic como compra o adición al carrito demostrada.

Si las filas CAPI fallan o siguen retenidas, comprueba el token, el destino del Pixel, el consentimiento guardado, el esquema de la cola y la ejecución cron. Las reglas personalizadas necesitan JSON y selectores válidos. Esta versión no ofrece el antiguo ayudante window.mprredditTrack.

Desactiva los interruptores del navegador y servidor y guarda para detener el seguimiento conservando la configuración. Desinstala desde "Module Manager" para eliminar los ajustes del módulo, las entradas de menú y las tareas registradas.

La desinstalación invoca la limpieza compartida de la cola de conversiones. La tabla compartida se conserva mientras otro módulo de conversiones la use y puede eliminarse al quitar el último usuario. Exporta el diagnóstico que necesites antes de desinstalar. No supongas que la desinstalación elimina eventos ya enviados a la plataforma publicitaria ni borra todo el almacenamiento de atribución del navegador.

Requiere PrestaShop 1.6.0.0 o posterior y PHP 7.1 o posterior.