SocialHub.AI
Geliştirici Merkezi · Web Kayıt Formu

Kayıtları kendi web sitenizden toplayın.

Mağaza içi QR kodlarınız zaten üyeleri yakalıyor. Web için de aynı şey geçerli: herhangi bir sayfaya bırakabileceğiniz kopyala-yapıştır bir HTML formu. Aynı yakalama hattına gönderiliyor — böylece bir web sitesi kaydı, QR taramasıyla aynı onay kaydını, hoş geldin kuponunu, bot savunmalarını ve CCPA işlemeyi alıyor. Anahtar yok, SDK yok, arka uç yok.

01 — Nasıl çalışır?

Tek bir form, tek bir uç noktaya gönderim

Form POST, mağazanızın yakalama uç noktasına küçük bir JSON gövdesi gönderir. Uç nokta CORS özelliklidir, bu nedenle form kendi alan adınızdan çalışır — sizin tarafınızda proxy veya sunucu kodu gerekmez:

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

Kısa kodunuzu alın

Her mağaza QR kodunun kısa bir kodu vardır (Mağazalar → bir mağaza açın → QR kodları). Bunu uç nokta URL'sinde kullanın; mağazayı ve markayı tanımlar, anahtar gerekmez.

Formu yapıştırın

Bağımsız kod parçasını herhangi bir sayfaya bırakın. Formu oluşturur, bot savunmalarını taşır ve gönderildiğinde yayınlar.

Flash gerisini halleder

Birleşik bir kişi oluşturulur veya güncellenir, onay kaydedilir ve QR kodunun bir hoş geldiniz kuponu varsa, tıpkı mağaza içi yakalama gibi verilir.

02 — Kurulum

YOUR_SHORT_CODE'ı ayarlayın ve yapıştırın.

Bağımsızdır — harici bir komut dosyası veya bağımlılık gerektirmez. Sitenize uyacak şekilde stil verin; gizli website tuzak kodunu ve _t timestamp kodunu koruyun — bunlar bot savunmalarıdır. Ayrıca bu kod parçasını Mağazalar → QR kodları → "Web sitenize yerleştirin" bölümünden belirli bir mağaza için de oluşturabilirsiniz.

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 — Sözleşme talebi

JSON Gövdesi

application/json gönderin. Kabul edildiğinde yanıt { success: true, couponCode?, couponExpiresAt?, isRepeat }, aksi takdirde hata kodu içeren bir success:false olur.

AlanTürNotlar
emailstringAbonenin e-postası. Gerekli.
opt_inbooleanOnay kutunuzdan pazarlama onayı. Yakalama ile kaydedildi.
_tstringFormun oluşturulduğu milisaniye cinsinden zaman dilimi — minimum doldurma süresi bot kontrolünü sağlar. Gerekli.
websitestring?Tuzak alanı. Gizli ve boş bırakın; doldurulmuş bir değer bot olarak algılanır.
fpstring?Oluşturduğunuz isteğe bağlı cihaz parmak izi.
04 — Koruma

Yerleşik bot savunmaları

Kısa kod herkese açık (sayfa kaynağınızda), bu nedenle uç nokta kendini sunucu tarafında koruyor — mağaza içi yakalama akışıyla aynı korumalar:

Hız sınırlama · her zaman açık

Uç nokta, bir kaynağın gönderebileceği kayıt sayısını sınırlar, böylece kopyalanan bir kısa kod listenizi dolduramaz.

Balık tuzağı + zamanlama

Gizli web sitesi alanı ve _t render timestamp, gizli alanları dolduran veya anında gönderen komut dosyası tabanlı gönderimleri yakalar.

Tek kullanımlık e-posta + yinelenen korumalar

Tek kullanımlık alan adları reddedilir ve aynı mağazadaki tekrarlanan e-postalar çift sayılmak yerine yinelenenlerden arındırılır.

Sınırlar konusunda dürüst

Bunlar kamusal bir form için çıtayı yükseltiyor; yüksek hassasiyetli alım için bunun yerine kimliği doğrulanmış API aracılığıyla sunucudan sunucuya gönderim yapın.

05 — Rıza ve gizlilik

Sadece adres değil, onay da alın

Katılım kaydı yapılır

O opt_in Onay kutusu yakalama işlemiyle birlikte saklanır, böylece sonraki işlemler ziyaretçinin pazarlamaya onay verip vermediğine göre hareket eder.

CCPA-farkında

QR akışıyla aynı açıklama işleme — Kaliforniya ziyaretçileri gerekli bildirimi sunucu tarafında alırlar.

Sayfada sır yok

Sadece genel kısa kod açığa çıkarılmıştır. Sitenizde sızdırılacak bir API anahtarı yoktur.

Önce onay banner'ınız

Eğer bir onay yöneticisi kullanıyorsanız, formu onun arkasına kilitleyin, böylece yalnızca hakkınız olan yerlerde veri toplarsınız.

Müşterilerinizin olduğu her yeri yakalayın

Mağazada QR aracılığıyla ve artık web sitenizde; her kayıt aynı birleştirilmiş üye profiline ulaşır.