Bing UET Tag: configuración y ayuda

Sube el ZIP del módulo en Módulos > "Module Manager". Instálalo y abre "Configure" para Bing UET Tag + Conversions API.

Obtén el ID numérico de tu etiqueta UET desde tu cuenta de Microsoft Advertising. El módulo no crea etiquetas ni objetivos de conversión en esa cuenta. Selecciona la tienda deseada antes de guardar los ajustes.

Introduce ID de la etiqueta UET, activa Activa la etiqueta Bing UET, selecciona los eventos de navegador y guarda. El ID debe ser positivo. En una instalación nueva, el seguimiento de navegador está desactivado hasta que lo configures.

Todos estos campos están en la pantalla de configuración.

La integración de consentimiento admite módulos de consentimiento MPR y estados reconocidos de proveedores de consentimiento. No muestra su propio banner. Con Respeta el consentimiento de marketing activado, la ausencia de una decisión compatible no permite enviar.

El rastreador también comprueba la titularidad de la integración en la tienda y la política de seguimiento saliente. Las señales de empleado y de exclusión voluntaria pueden impedir el envío. No evalúes el seguimiento de clientes desde un navegador que el módulo reconozca como interno.

Estas opciones están desactivadas en instalaciones nuevas. Activa solo las señales que proporcione tu tienda.

Los ajustes validan umbrales de galería, variantes y detalles de 1 a 20, permanencia de 5 a 600 segundos y limitación de opciones de 250 a 60000 ms. Deja el JSON vacío para usar los valores predeterminados.

UET de navegador y Conversions API se activan por separado. Para usar compras de servidor:

1. Mantén Activa la etiqueta Bing UET y Registra las compras activados.
2. Activa "Capture durable buyer evidence" antes de hacer tu pedido de prueba.
3. Activa Activa la API de conversiones e introduce Token de la API de conversiones.
4. Guarda y revisa los paneles de preparación y de cola.
5. Configura la entrada cron generada por el módulo en el programador de tu alojamiento.
6. Acepta las cookies en una sesión normal del navegador, haz un pedido como cliente o como invitado y comprueba que la compra aparece en la cola.

Cuando se crea un pedido, el módulo comprueba la sesión de compra y el consentimiento del comprador antes de añadir la compra a la cola. Una compra sin datos del comprador guardados queda retenida, así que activar CAPI no envía todos los pedidos.

El patrón del endpoint es:

https://capi.uet.microsoft.com/v1/{TAG_ID}/events

La tarea instalada es send_bing_uet_conversions, programada cada 300 segundos. La instalación crea una entrada cron mediante el paquete cron compartido. Copia el token y el comando reales de tu módulo instalado. Un comando típico del servidor es:

* * * * * php /var/www/html/modules/mprbinguet/cron.php --token=YOUR_TOKEN --max-seconds=300

Sustituye la ruta PHP, la ruta de la tienda y el token. El programador invoca el ejecutor; las tareas pendientes usan su propia programación de cinco minutos.

El panel de cola muestra Pendiente, Enviando, Enviado, Fallido, "Held", "Terminal" y "Suppressed". Usa Reintentar eventos fallidos después de corregir el error indicado. Los eventos retenidos o suprimidos esperan datos del comprador que faltan o los detuvo el consentimiento o una regla; corrige esa causa en lugar de reenviar.

Enviar evento de prueba no envía nada por ahora: solo muestra un mensaje de que el modo de prueba de Microsoft no está disponible. Para comprobar el seguimiento, haz un pedido de prueba, revisa la cola y usa las herramientas de diagnóstico de tu cuenta de Microsoft Advertising.

Esta configuración es opcional y está en "Microsoft online refund and cancellation corrections".

Rellena "Microsoft customer ID", "Microsoft account ID", "Developer token", "OAuth client ID", "OAuth client secret", "OAuth refresh token" y "Exact purchase conversion goal name". Estos campos empiezan vacíos. "Use Microsoft adjustments sandbox" empieza desactivado.

El interruptor "Enable online corrections" solo aparece cuando "Capture durable buyer evidence" está activado, todas las credenciales de Microsoft y el nombre del objetivo de compra están rellenados y existe para la tienda un vínculo guardado entre tu cuenta de Microsoft, la etiqueta UET y el objetivo de compra. La pantalla de ajustes no tiene ningún campo para crear ese vínculo, así que en una instalación estándar el interruptor sigue oculto y los reembolsos y cancelaciones no se envían a Microsoft.

Activa Registra los eventos personalizados e introduce un array JSON en Reglas de eventos personalizados. Los nombres de evento admiten letras, números, guiones bajos y guiones, hasta 64 caracteres. Puedes usar hasta 15 nombres distintos y 30 parámetros configurados por regla. El módulo solo envía nombres de parámetros UET compatibles, incluidos event_category, event_label, event_value, value, currency y campos de artículos e-commerce.

Regla de clic:

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-images img, .images-container img","params":{"event_category":"Product","event_label":"Gallery browse"}}
]

Regla URL:

[
  {"event":"PromoPageView","trigger":"url","contains":["/promo/"],"params":{"event_category":"Campaign"}}
]

Regla de controlador:

[
  {"event":"CheckoutPageView","trigger":"controller","controllers":["order"],"params":{"event_category":"Checkout"}}
]

Regla de evento DOM:

[
  {"event":"QuoteRequest","trigger":"event","dom_event":"shop:quote-request","params":{"event_category":"Lead"}}
]

Tu tema puede emitir el evento correspondiente:

document.dispatchEvent(new CustomEvent('shop:quote-request', {
  detail: {params: {event_label: 'Product page quote button'}}
}));

Usa estas reglas configuradas para llamadas personalizadas. El módulo no proporciona el antiguo helper window.mprbinguetTrack ni lee los antiguos atributos data-mprbinguet-param-*. Las reglas URL, de controlador y DOM se ejecutan por defecto una vez por página; las de clic se repiten. Establece explícitamente once cuando sea necesario.

Revisa el panel de preparación después de cada cambio. Comprueba ID de etiqueta, seguimiento de navegador, consentimiento, reglas personalizadas y estado CAPI.

Usa un navegador de cliente separado. Concede el consentimiento necesario, abre un producto e inspecciona el registro de red para ver el script Microsoft UET en bat.bing.com/bat.js y los eventos seleccionados. Rechaza el consentimiento en una prueba nueva y confirma que el seguimiento se retiene con la protección activada.

Prueba una adición correcta al carrito y a la lista de deseos. Una acción fallida no debe convertirse en un evento e-commerce confirmado. Si tu tema o proceso de compra usa eventos personalizados, confirma que proporcione la señal de éxito compatible.

Para las compras, compara referencia de transacción, política de valor, moneda y artículos con el pedido. Revisa la cola del servidor y los registros, además de las solicitudes del navegador. Microsoft decide qué conversiones acepta y muestra en los informes, así que comprueba también los resultados en tu cuenta de Microsoft Advertising.

Si no carga ninguna etiqueta, comprueba activación general, ID numérico positivo, consentimiento, exclusión de empleados, estado de exclusión voluntaria y política de titularidad de la tienda. Después comprueba bloqueos de scripts y errores del navegador. Si CAPI sigue pendiente, revisa el ejecutor cron. Si está retenida, comprueba que el comprador dio su consentimiento y que se guardaron sus datos de compra. Si falla, revisa el token y la respuesta antes de reintentar.

Desactiva el seguimiento de navegador y servidor si solo quieres pausar la recopilación. Antes de desinstalar, guarda los ajustes y registros de envío necesarios. La desinstalación elimina el menú del módulo, su tarea programada y configuración. La tabla de cola de conversiones compartida solo se elimina cuando ningún otro módulo usa el paquete de conversiones; los datos pueden permanecer si otro usuario conserva la tabla compartida.

Requiere PrestaShop 1.6.0.0 o posterior y PHP 7.1 o posterior.