Sign-ups in deiner App tracken (inkl. Google & Microsoft SSO)

Wenn die Aktion, die dich interessiert, in deiner eigenen Software passiert – jemand erstellt ein Konto – willst du in der Regel ein Lead-Event an LeadJourney senden, mit Name und E-Mail des neuen Users, zugeordnet zum Werbe-Klick, der ihn gebracht hat. Diese Anleitung zeigt genau wie – inklusive Registrierung über Google und Microsoft, die der automatische Form-Listener allein nicht erfassen kann.

Warum der automatische Form-Listener nicht reicht

Das LeadJourney-Script feuert automatisch ein Lead, wenn es einen normalen <form>-Submit sieht. Das deckt dein einfaches E-Mail/Passwort-Formular ab. Es deckt nicht die Registrierung über Google oder Microsoft ab, denn dieser Ablauf sendet auf deiner Seite nie ein Formular:

• Der Besucher verlässt deine Seite Richtung accounts.google.com / login.microsoftonline.com, bestätigt dort und wird zurück zu deinem Callback geleitet. Es gibt keinen <form>-Submit, den das Script erfassen könnte.
• Das Konto wird oft serverseitig in diesem Callback erstellt – wo es gar keinen Browser zum Auslesen gibt.
• Ein Klick auf den SSO-Button ist mehrdeutig – es könnte ein Login sein, keine neue Registrierung. Du willst das Event nur bei einem neuen Konto.

Für Sign-ups sendest du das Lead-Event also selbst, genau einmal, in dem Moment, in dem ein neues Konto erstellt wird. Das sind drei kleine Teile: eine Server-Route, die deinen Secret hält, ein Aufruf nach erfolgreicher Registrierung und – bei SSO – das Durchreichen der Click-ID über den OAuth-state-Parameter.

Woher deine App die Click-ID bekommt

Es gibt zwei Setups, je nachdem, wo das Tracking-Script läuft. Prüfe zuerst, welches deins ist – jeder Codeschnipsel in dieser Anleitung geht davon aus, dass die Click-ID am Ende im localStorage liegt.

Option 1: Das Script läuft auch auf deiner App-Domain

Ist das Tracking-Script auch auf der App-Domain installiert (z. B. app.deinebrand.de), legt das Script die Click-ID direkt dort ab. Du liest sie einfach aus – nichts weiter vorzubereiten:

const clickId = localStorage.getItem("clickId");

Option 2: Das Script läuft nur auf deiner Root-Domain

Ist das Script nur auf deiner Marketing-Seite (deinebrand.de) installiert und nicht in der App, ist der localStorage der App-Domain leer – Browser teilen den Speicher nicht zwischen (Sub-)Domains. Stattdessen wird die Click-ID per URL an die App übergeben: Wenn der Besucher von deiner Seite in die App wechselt, reist sie als click_id-Parameter mit:

https://app.deinebrand.de/signup?click_id=8f3c…

In der App liest du die ID also aus der URL statt aus dem localStorage – einmal, auf der ersten Seite, auf der der Besucher landet – und hebst sie auf, bis die Registrierung abgeschlossen ist:

// Einmal beim Seitenaufruf in deiner App ausführen
const fromUrl = new URLSearchParams(window.location.search).get("click_id");
if (fromUrl) localStorage.setItem("clickId", fromUrl);

Danach funktioniert localStorage.getItem('clickId') genau wie in Option 1, und der Rest dieser Anleitung gilt unverändert für beide Setups.

Bevor du startest

Hol dir deine Conversion-API-Zugangsdaten unter Settings → Events → Conversion API:

• Deine Postback-URL – sieht aus wie https://api.leadjourney.io/api/v1/postback/<deine-id>.
• Dein Postback-Secret – beginnt mit pb_…. Behandle ihn wie ein Passwort; er bleibt auf deinem Server und wird nie im Browser sichtbar.

Stell sicher, dass im Events Manager ein Lead-Event existiert – jeder Workspace hat standardmäßig eins.

Schritt für Schritt

// app/api/lead/route.js
export async function POST(req) {
  const d = await req.json();

  await fetch(
    "https://api.leadjourney.io/api/v1/postback/YOUR-POSTBACK-ID",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_POSTBACK_SECRET",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        type: "Lead",
        click_id: d.click_id,
        tag: d.tag,
        firstname: d.firstname,
        lastname: d.lastname,
        email: d.email,
      }),
    }
  );

  return Response.json({ ok: true });
}

fetch("/api/lead", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    click_id: localStorage.getItem("clickId"),
    tag: "app_signup",          // dein Kampagnen-/Quellen-Tag – ein festes Wort genügt
    firstname: /* siehe Tabelle unten */,
    lastname:  /* siehe Tabelle unten */,
    email:     /* siehe Tabelle unten */,
  }),
});

Die Click-ID durch Google / Microsoft SSO durchreichen

Bei SSO gibt es eine Sache extra zu lösen: die Click-ID von vor dem Redirect zu deinem Callback danach zu bringen. localStorage ist eventuell weg, wenn das Konto erstellt wird – der Callback kann serverseitig laufen oder auf einer anderen Subdomain landen.

1. Wenn der User auf „Mit Google / Microsoft fortfahren" klickt, pack die Click-ID in state:

const clickId = localStorage.getItem("clickId") || "";

// Pack die Click-ID in `state`. Füge hier auch dein CSRF-Token hinzu, falls du eins nutzt.
const state = btoa(JSON.stringify({ clickId, csrf: yourCsrfToken }));

// Google – Microsoft ist dieselbe Idee mit login.microsoftonline.com/common/oauth2/v2.0/authorize
const url = new URL("https://accounts.google.com/o/oauth2/v2/auth");
url.searchParams.set("client_id", GOOGLE_CLIENT_ID);
url.searchParams.set("redirect_uri", REDIRECT_URI);
url.searchParams.set("response_type", "code");
url.searchParams.set("scope", "openid email profile");
url.searchParams.set("state", state);

window.location.href = url.toString();

2. Im Callback – nachdem das Konto erstellt wurde – state dekodieren und den Lead senden:

// `state` kommt exakt so zurück, wie du es gesendet hast
const { clickId } = JSON.parse(atob(stateFromCallback));

await fetch("https://deine-app.de/api/lead", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    click_id: clickId,
    tag: "app_signup",
    firstname: profile.given_name,   // Microsoft: profile.givenName
    lastname:  profile.family_name,  // Microsoft: profile.surname
    email:     profile.email,        // Microsoft: profile.mail
  }),
});

Prüfen, ob es funktioniert

1. Öffne deine App über einen getrackten Link (einen mit lj_*-Parametern, z. B. eine Test- Anzeigen-URL oder ein mit dem UTM Builder gebauter Link), damit eine Click-ID gespeichert wird. Bei Option 2 (Script nur auf der Root-Domain) landest du über den getrackten Link zuerst auf deiner Marketing-Seite, klickst dann in die App weiter – und prüfst, dass der click_id-Parameter beim Ankommen in der App-URL steht.
2. Erstelle ein Testkonto – einmal über das Formular, einmal mit Google, einmal mit Microsoft.
3. Unter Settings → Events steigt der Total-Zähler des Lead-Events und sein Status wechselt auf Active.
4. Um einen einzelnen Aufruf zu prüfen (Statuscode, Payload, ob die Click-ID gematcht hat), öffne das API-Postbacks-Log.

FAQ

Verwandte Artikel