Integraciones · Plataformas web

Next.js: el layout raíz, los cambios de ruta y el checkout.

Una etiqueta en app/layout.tsx cubre todas las rutas, y la navegación del lado del cliente cuenta como vistas de página. Un route handler que crea Checkout Sessions de Stripe pasa el ID del visitante en dos líneas, y un middleware registra los rastreadores de IA.

Empieza gratis

14 días gratis, sin tarjeta.

01Lo que mide Tally

  • Cada ruta de la app desde el layout raíz, con las navegaciones del lado del cliente contadas como vistas de página.
  • Tiempo activo y profundidad de scroll por página, objetivos y clics en enlaces a otros sitios.
  • Rastreadores de IA, cuando unas pocas líneas en tu middleware los registran: la página Crawlers tiene el snippet de Next.js.

02De dónde vienen los ingresos

  • Checkout desde un route handlerLee la cookie _tally_vid con await cookies() y pásala como tally_visitor_id en los metadatos de la sesión y en subscription_data.metadata. La página Coverage tiene el handler.
  • Página de éxitoEn un sitio sin cookies, pon ?session_id={CHECKOUT_SESSION_ID} en la URL de éxito y la página que lo muestra vincula la venta con la visita.

03Lo que no puede leer

  • Las solicitudes renderizadas en el servidor que nunca cargan la página en un navegador, como los prefetch, no cuentan como visitas.
  • Las compras dentro de la app a través de una tienda de apps no se leen; otros pagos que cobren tus route handlers pueden enviarse a la Payments API.
  • Sin las líneas del middleware, los rastreadores que no ejecutan el script no se ven.

04Añadir el snippet

Dónde va: En app/layout.tsx, el layout raíz: dentro de su <head>.

<head>
  <script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>
</head>

Esta es la etiqueta de un sitio de ejemplo. La tuya, con el ID de tu sitio, está en el paso del snippet al añadir un sitio y en su página Setup.

  1. Pega la etiqueta dentro del head de app/layout.tsx, como muestra el paso del snippet.
  2. Despliega y abre el sitio: la comprobación en directo muestra la primera visita.
  3. En el route handler que crea las Checkout Sessions, añade el ID del visitante a los metadatos.
  4. Si quieres, añade a tu middleware el registro de rastreadores, desde la página Crawlers.

05Preguntas

  • ¿Cuenta la navegación del lado del cliente en el App Router?

    Sí. La etiqueta escucha los cambios de ruta en el navegador, así que pasar de una página a otra sin recargar cuenta como vista de página.

  • ¿De dónde sale el ID del visitante en el servidor?

    De la cookie propia _tally_vid, que la etiqueta pone en modo con cookie, o en el modo «primero el consentimiento» una vez dado el consentimiento. Un route handler la lee con await cookies().

  • ¿Puedo registrar rastreadores de IA desde Next.js?

    Sí. La página Crawlers da un snippet de middleware que envía a Tally las solicitudes de los rastreadores conocidos, ya que la mayoría nunca ejecuta el script de la página.