SocialHub.AI
Entwicklerzentrum · Web-Anmeldeformular

Sammeln Sie Anmeldungen über Ihre eigene Website.

Ihre QR-Codes im Geschäft erfassen bereits Mitglieder. Dasselbe gilt fürs Web: ein HTML-Formular zum Kopieren und Einfügen auf einer beliebigen Seite. Es sendet Daten an dieselbe Erfassungspipeline () – daher erhält eine Website-Registrierung die gleichen Einwilligungsdaten, den gleichen Willkommenscoupon, die gleichen Bot-Schutzmaßnahmen und die gleiche Verarbeitung (CCPA) wie ein QR-Scan. Kein Schlüssel, kein Backend (SDK).

01 — Wie es funktioniert

Ein Formular, das an einen Endpunkt gesendet wird

Das Formular POST sendet einen kleinen JSON-Body an den Erfassungsendpunkt Ihres Shops. Der Endpunkt ist CORS-fähig, sodass das Formular von Ihrer eigenen Domain aus funktioniert – ohne Proxy- oder Servercode Ihrerseits:

POST https://flash.socialhub.ai/api/flash/capture/YOUR_SHORT_CODE

Holen Sie sich Ihren Kurzcode

Jeder QR-Code eines Geschäfts hat einen Kurzcode (Geschäfte → Geschäft öffnen → QR-Codes). Verwenden Sie diesen in der Endpunkt-URL – er identifiziert Geschäft und Marke, kein Schlüssel erforderlich.

Fügen Sie das Formular ein

Fügen Sie den in sich geschlossenen Code-Schnipsel in eine beliebige Seite ein. Er rendert das Formular, integriert die Bot-Abwehr und sendet die Daten beim Absenden ab.

Flash erledigt den Rest

Ein einheitlicher Kontakt wird erstellt oder aktualisiert, die Einwilligung wird erfasst und – falls der QR-Code einen Willkommenscoupon enthält – dieser ausgestellt, genau wie bei der Erfassung im Geschäft.

02 – Installation

Setzen Sie YOUR_SHORT_CODE und fügen Sie es ein.

In sich abgeschlossen – keine externen Skripte oder Abhängigkeiten. Passen Sie es an Ihre Website an; behalten Sie den versteckten website Honeypot und den _t timestamp bei – sie dienen dem Schutz vor Bots. Sie können diesen Code-Schnipsel auch für einen bestimmten Shop unter Shops → QR-Codes → „Auf Ihrer Website einbetten“ generieren.

index.html
<!-- SocialHub signup form — paste anywhere in your site's HTML -->
<form class="flash-signup" style="max-width:340px;font-family:sans-serif">
  <input type="email" name="email" required placeholder="Email address"
    style="width:100%;padding:10px;margin-bottom:8px;border:1px solid #ccc;border-radius:6px" />
  <label style="display:block;font-size:13px;margin-bottom:8px">
    <input type="checkbox" name="opt_in" checked /> Send me offers and updates
  </label>
  <!-- honeypot: real people never fill this; bots do -->
  <input type="text" name="website" tabindex="-1" autocomplete="off"
    style="position:absolute;left:-9999px" aria-hidden="true" />
  <button type="submit" style="width:100%;padding:10px;border:0;border-radius:6px;background:#111;color:#fff;cursor:pointer">Sign up</button>
</form>
<script>
(function () {
  var f = document.currentScript.previousElementSibling;
  var t = Date.now();                                  // render time — the min-fill-time bot check
  f.addEventListener("submit", function (e) {
    e.preventDefault();
    fetch("https://flash.socialhub.ai/api/flash/capture/YOUR_SHORT_CODE", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        email: f.email.value,
        opt_in: f.opt_in.checked,
        _t: String(t),
        website: f.website.value                       // honeypot value
      })
    })
      .then(function (r) { return r.json(); })
      .then(function (d) { f.innerHTML = d && d.success ? "<p>Thanks — you're signed up!</p>" : "<p>Sorry, something went wrong.</p>"; })
      .catch(function () { f.innerHTML = "<p>Sorry, something went wrong.</p>"; });
  });
})();
</script>
03 — Vertragsanfrage

Der JSON-Body

Sende application/json. Die Antwort ist bei Annahme { success: true, couponCode?, couponExpiresAt?, isRepeat }, andernfalls success:false mit einem Fehlercode.

FeldTypNotizen
emailstringE-Mail-Adresse des Abonnenten. Erforderlich.
opt_inbooleanMarketing-Einwilligung aus Ihrem Kontrollkästchen. Mit der Aufnahme aufgenommen.
_tstringMillisekunden-Epoche, zu der das Formular gerendert wurde – steuert die Bot-Prüfung der minimalen Ausfüllzeit. Erforderlich.
websitestring?Honeypot-Feld. Lassen Sie es ausgeblendet und leer; ein ausgefüllter Wert wird als Bot interpretiert.
fpstring?Optionaler von Ihnen generierter Gerätefingerabdruck.
04 – Schutz

Integrierte Bot-Abwehr

Der Shortcode ist öffentlich (er befindet sich im Quelltext Ihrer Seite), sodass der Endpunkt serverseitig geschützt ist – mit denselben Sicherheitsvorkehrungen wie beim Erfassungsprozess im Geschäft:

Ratenbegrenzung · immer aktiviert

Der Endpunkt begrenzt die Anzahl der Anmeldungen, die eine Quelle senden kann, sodass ein kopierter Funktionscode Ihre Liste nicht überfluten kann.

Honeypot + Timing

Das versteckte Website-Feld und der _t render timestamp erfassen skriptgesteuerte Eingaben, die versteckte Felder ausfüllen oder sofort abgeschickt werden.

Wegwerf-E-Mail + doppelte Wachen

Wegwerfdomains werden abgelehnt, und wiederholte E-Mails an denselben Shop werden dedupliziert, aber nicht doppelt gezählt.

Ehrlich bezüglich der Grenzen

Diese legen die Messlatte für eine öffentliche Form höher; Für eine Aufnahme mit hoher Sensitivität senden Sie stattdessen Server-zu-Server über das authentifizierte API.

05 – Einwilligung und Datenschutz

Einwilligung einholen, nicht nur eine Adresse

Die Anmeldung wird protokolliert.

Der opt_in Die Checkbox wird zusammen mit dem Erfassungsdatensatz gespeichert, sodass nachfolgende Systeme eine Rückmeldung darüber senden, ob der Besucher der Marketingmaßnahme zugestimmt hat.

CCPA-bewusst

Gleiche Offenlegungsbehandlung wie beim QR-Code-Ablauf – Besucher aus Kalifornien erhalten den erforderlichen Hinweis serverseitig.

Keine Geheimnisse auf der Seite

Es wird lediglich der öffentliche Shortcode offengelegt. Es gibt keinen API-Schlüssel, der auf Ihrer Website preisgegeben werden könnte.

Ihre Einwilligung zuerst

Wenn Sie einen Einwilligungsmanager verwenden, schützen Sie das Formular damit, sodass Sie nur dort Daten erfassen, wo Sie dazu berechtigt sind.

Erfassen Sie Ihre Kunden überall.

Im Geschäft per QR und jetzt auf Ihrer Website – jede Anmeldung landet im selben einheitlichen Mitgliederprofil.