Instalar con código a mano (HTML)

Pega el código

1. En el panel, abre Instalación y copia tu código. Ya trae tu clave pública (empieza con «alb_pub_»).
2. Pégalo dentro del encabezado (<head>) de todas las páginas públicas de tu tienda, lo más arriba posible.
3. Revisa que el dominio de tu tienda esté en Ajustes › Dominios del panel. Albunea solo acepta datos que vienen de esos dominios; «*.tutienda.mx» incluye los subdominios.
4. Abre tu tienda en otra pestaña y navega un poco. En el panel, en Instalación, verás «Última señal» con la página que acabas de abrir, normalmente en segundos.

<script async src="https://www.getalbunea.com/s.js" data-sitio="alb_pub_XXXXXXXX"></script>
<script>window.albunea=window.albunea||function(){(albunea.q=albunea.q||[]).push(arguments)}</script>

La primera línea carga el script en segundo plano: no bloquea tu página ni tu pago. La segunda crea una cola para que puedas llamar a albunea(…) aunque el script aún no termine de cargar.

Qué se mide solo

• Cada página vista, también en los cambios de página de una tienda de una sola página (Angular, Vue, React y rutas con #).
• Los eventos de comercio que tu tienda ya manda a Google Tag Manager o a Google Analytics 4 (por dataLayer o por gtag): ver producto, agregar o quitar del carrito, iniciar el pago, compra, inicio de sesión, registro y otros.

Si ya mides comercio en GA4, no tienes que programar nada más.

Si tu tienda tiene una CSP estricta

Agrega el origen de Albunea a tu política de seguridad de contenido:

script-src 'self' https://www.getalbunea.com;
connect-src 'self' https://www.getalbunea.com;

La cola es un script en línea. Ponle tu nonce o guárdala en un archivo propio de tu tienda y cárgalo antes del script de Albunea:

<script src="/js/albunea-cola.js"></script>
<script async src="https://www.getalbunea.com/s.js" data-sitio="alb_pub_XXXXXXXX"></script>

window.albunea=window.albunea||function(){(albunea.q=albunea.q||[]).push(arguments)}

Eventos propios

Si tu tienda no usa GA4, manda los eventos tú. Pon siempre la moneda (currency):

albunea('evento', 'add_to_cart', {
  currency: 'MXN', value: 360,
  items: [{ item_id: 'v1', item_name: 'Vela de soya', price: 180, quantity: 2 }]
});
albunea('evento', 'solicitud_mayoreo');   // evento propio: minúsculas, números y guion bajo

Un evento propio puede disparar una alerta con la regla «Evento propio». El mismo evento con los mismos datos en menos de 1.5 segundos se cuenta una vez, así que no se duplica si lo mandas por dos caminos.

Opciones del código

Si tu plataforma no te deja poner atributos, pasa la configuración en la dirección del script: «s.js?k=alb_pub_XXXXXXXX&consentimiento=expreso».

Si no llegan las visitas

• El dominio no está en Ajustes › Dominios: Albunea descarta los datos de dominios que no conoce. Agrégalo, con y sin «www» si usas ambos.
• Tu plan está esperando el pago o venció: mientras no hay un pago confirmado, Albunea no mide. Revisa la franja de arriba del panel o Plan y pagos.
• Tu sitio está en consentimiento expreso y tu aviso de cookies no llama a albunea('consentimiento', true): nadie queda medido hasta que lo llame.
• Tu navegador manda «Global Privacy Control» o ya dijiste que no en esa tienda: Albunea respeta esa decisión. Prueba en otra ventana o en otro navegador.
• Tu CSP bloquea el script: abre la consola del navegador y busca un error de Content-Security-Policy.
• Llegaste al límite de visitas de tu plan y pasaste el margen del 10 %: la medición se pausa hasta el siguiente mes o hasta que subas de plan.

Si nada de esto lo resuelve, escríbenos a [email protected] con la dirección de tu tienda.