Referencia del fragmento

Al instalar el fragmento, tu web gana un objeto alloop con unas cuantas funciones. En una instalación normal no necesitas llamar a ninguna: el fragmento mide las visitas, los vídeos y las compras por su cuenta. Esta página es la referencia para cuando integras a mano o tienes un flujo propio.

Identificar y captar

Medir acciones tuyas

Cobrar

alloop.checkout(precio, opciones)

Abre el pago de Stripe con la atribución ya puesta, para que la venta llegue a tu panel unida al anuncio que la trajo.

alloop.checkout('price_1234', {
  successUrl: 'https://tuweb.com/gracias/',
  cancelUrl:  'https://tuweb.com/oferta/',
  coupon:     'BLACKFRIDAY'      // solo si está en tus cupones permitidos
});

Antes de abrir el pago marca «empezó compra», que es el paso previo a comprar en tu embudo. Si el cupón no está en tu lista permitida, se ignora y se cobra el precio completo — es la protección contra un cupón que se filtra.

Devuelve una promesa: si algo falla, puedes avisar en tu página en vez de dejar el botón colgado.

alloop.upsell(opciones) y alloop.upsellDecline()

Para ofrecer un plan mejor justo después de comprar, cobrando sobre la tarjeta que la persona acaba de usar, sin volver a pedírsela:

alloop.upsell({ sessionId: new URLSearchParams(location.search).get('session_id') })
  .then(r => { if (r.ok) mostrarGracias(); });

Si el banco pide confirmación (o rechaza el cobro de un clic), la persona va al pago normal de Stripe para terminar — no se le crea una segunda suscripción, se cambia la que ya tenía. Si la llamada se repite por un doble clic, la segunda no cobra otra vez.

alloop.upsellDecline({ sessionId }) no cobra nada: solo registra que dijo que no, para que sepas tu tasa real de aceptación. Sin esto solo verías los «sí».

alloop.purchase(importe, divisa, id) y alloop.trackPurchase()

Solo para webs que no usan alloop.checkout(). trackPurchase() ya se llama solo al cargar tu página de gracias; purchase() es el disparo manual para integraciones propias.

Medir vídeos

alloop.video() mide YouTube, Bunny.net y Video.js:

alloop.video({ youtube: 'mi-iframe', id: 'vsl-principal' });   // el iframe necesita ?enablejsapi=1
alloop.video({ bunnyIframe: '#mi-video', id: 'vsl-principal' });

Qué registra:

Excluir tu propio tráfico

Visita cualquier página tuya con ?alloop_optout=1 al final y ese navegador deja de contar para siempre: ni visitas, ni conversiones, ni leads. Se revierte con ?alloop_optout=0.

Úsalo antes de probar tu propia landing. Sin ello, un formulario de prueba entra en tu lista de correo real y dispara el WhatsApp automático a un contacto que no existe.

Es por navegador: si pruebas desde el móvil, también hay que marcarlo ahí.

Tu página, disponible para agentes de IA

alloop.registerAgentTools() se activa sola: expone tu página a los asistentes de IA que navegan (Chrome 149+), de forma que puedan leerla y rellenar tus formularios por el usuario.

Está construido para no mentir: si la validación de tu formulario bloquea el envío, el agente responde que no pudo enviarlo, en vez de decir que sí. Y nunca rellena el campo trampa anti-robots, que descartaría el lead en silencio.

Para desactivarlo: window.ALLOOP = { agentTools: false } antes del fragmento. Para excluir un formulario concreto: <form data-alloop-agent="off">.

Cómo sabes que funciona

Abre tu web, escribe alloop en la consola del navegador y pulsa Enter: debe salir el objeto con todas estas funciones. Si sale undefined, el fragmento no está cargando en esa página.

La parte incómoda

Casi nada de esto hace falta. La instalación normal —fragmento, pasarela y enlaces marcados— cubre a la mayoría de academias. Llamar a estas funciones a mano añade sitios donde equivocarse: si tu caso se resuelve con alloop.form() y un enlace marcado, quédate ahí.

¿Te atascas? Pregúntale a tu IA

Siguiente paso

Si lo que quieres es medir un paso propio de tu negocio, empieza por tus propios eventos.