Integrationen · Website-Plattformen
Next.js: Root-Layout, Routenwechsel und Checkout.
Ein Tag in app/layout.tsx deckt jede Route ab, und clientseitige Navigation zählt als Seitenaufrufe. Ein Route Handler, der Stripe Checkout Sessions erstellt, übergibt die Besucher-ID in zwei Zeilen, und eine Middleware meldet KI-Crawler.
14 Tage kostenlos, ohne Kreditkarte.
01Was Tally erfasst
- Jede Route der App über das Root-Layout, clientseitige Navigationen als Seitenaufrufe gezählt.
- Aktive Zeit und Scrolltiefe pro Seite, Ziele und Klicks auf Links zu anderen Websites.
- KI-Crawler, wenn ein paar Zeilen in deiner Middleware sie melden: Die Seite „AI crawlers“ hat das Next.js-Snippet.
02Woher der Umsatz kommt
- Checkout aus einem Route HandlerLies das _tally_vid-Cookie mit await cookies() und übergib es als tally_visitor_id in den Metadaten der Session und in subscription_data.metadata. Die Seite „Coverage“ hat den Handler.
- ErfolgsseiteAuf einer Website ohne Cookies hängst du ?session_id={CHECKOUT_SESSION_ID} an die Erfolgs-URL, und die Seite, die sie anzeigt, verknüpft den Verkauf mit dem Besuch.
03Was es nicht lesen kann
- Serverseitig gerenderte Anfragen, die die Seite nie in einem Browser laden, etwa Prefetches, zählen nicht als Besuche.
- In-App-Käufe über einen App Store werden nicht gelesen; andere Zahlungen, die deine Route Handler annehmen, kannst du an die Payments API senden.
- Ohne die Middleware-Zeilen werden Crawler, die das Script nicht ausführen, nicht gesehen.
04Das Snippet einbauen
Wo es hinkommt: In app/layout.tsx, dem Root-Layout: innerhalb seines <head>.
<head>
<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>
</head>Das ist das Tag einer Beispiel-Website. Deins, mit der ID deiner Website, findest du beim Snippet-Schritt, wenn du eine Website hinzufügst, und auf ihrer Seite „Setup“.
- Füge das Tag in den Head von app/layout.tsx ein, wie es der Snippet-Schritt zeigt.
- Deploye die App und öffne die Website: Der Live-Check zeigt den ersten Besuch.
- Ergänze im Route Handler, der Checkout Sessions erstellt, die Besucher-ID in den Metadaten.
- Ergänze optional die Crawler-Meldung von der Seite „AI crawlers“ in deiner Middleware.
05Fragen
Zählt es clientseitige Navigation im App Router?
Ja. Das Tag achtet im Browser auf Routenwechsel, ein Seitenwechsel ohne Neuladen zählt also als Seitenaufruf.
Woher kommt die Besucher-ID auf dem Server?
Aus dem First-Party-Cookie _tally_vid, das das Tag im Cookie-Modus setzt, oder im Modus „Einwilligung zuerst“, sobald eingewilligt wurde. Ein Route Handler liest es mit await cookies().
Kann ich KI-Crawler aus Next.js melden?
Ja. Die Seite „AI crawlers“ liefert ein Middleware-Snippet, das die Anfragen bekannter Crawler an Tally meldet, da die meisten das Script der Seite nie ausführen.