SocialHub.AI
Sumber Daya · Pusat Pengembang

Pemasaran Lokasi & Toko

Mengaitkan keterlibatan dengan toko fisik — mengukur kunjungan toko nyata yang dikunci oleh anggota, menargetkan berdasarkan toko atau wilayah, dan (dalam rencana pengembangan) melibatkan kembali anggota yang datang di dekat toko. Dibangun dengan mengutamakan privasi: persetujuan + Kontrol Privasi Global, ditutup jika gagal, tidak ada koordinat mentah yang disimpan.

Baca lencana dengan tepat: kunjungan toko deterministik adalah langsung; Titik akhir geofence adalah dibangun oleh server dan dapat dipanggil; deteksi pada perangkat yang melengkapi audiens kedekatan adalah dalam pengembangan.

Yang sedang tayang, yang akan datang

Kunjungan toko yang deterministikLangsung

Check-in QR atau penukaran di toko memicu peristiwa kunjungan toko yang diinput oleh anggota dan telah dideduplikasi oleh basis data. Tidak diperlukan lokasi perangkat. Dengan pengujian acak, Anda mengukur peningkatan inkremental true.

Penargetan toko/wilayahLangsung

Menargetkan anggota berdasarkan toko atau wilayah yang dikaitkan dengan mereka untuk penawaran yang relevan dengan lokasi — pihak pertama, tanpa pelacakan perangkat. (Segmen wilayah sedang diluncurkan.)

Titik akhir Geofence + pemicuServer dibangun

nearby-stores + geofence-event are live and callable, with consent + GPC fail-closed and near_store / store_dwell Pemicu otomatisasi terpasang.

Deteksi kedekatan pada perangkatDalam pengembangan

Geofencing latar belakang di dalam paket FlashLocation (CoreLocation / Play Services). Dalam pengembangan aktif dan belum divalidasi perangkat — jadi audiens "dekat toko baru-baru ini" ujung ke ujung belum aktif.

Mulailah di sini: kunjungan toko deterministik Langsung

// LIVE TODAY — no device location required. A QR check-in or an in-store coupon
// redeem fires a member-keyed store-visit event, deduplicated at the database.
// This is the cleaner, privacy-safe signal for store-driven campaigns, and the one
// to build on now while the on-device proximity detection is finished.
//
//   QR check-in / in-store redeem  →  store_visit_event (member-keyed, DB-deduped)
//
// Pair it with a randomized holdout to measure INCREMENTAL visits your campaign
// actually caused — not self-reported footfall.

Titik akhir geofence Server dibangun

Ini aktif dan dapat diakses dari sesi anggota yang masuk hari ini. Bagian di perangkat yang memanggilnya — pemantauan geofence latar belakang — disertakan dengan paket FlashLocation, yang masih dalam pengembangan; sampai saat itu, audiens kedekatan ujung-ke-ujung belum aktif.

1. Dapatkan geofence toko terdekat untuk dipantau

// The device reports its current location; the server returns the ≤20 NEAREST store
// geofences for it to monitor (server-curated to fit iOS's 20-region limit). The
// lat/lng is used transiently to rank stores and is NOT persisted.
POST https://flash.socialhub.ai/api/v2/lbs/nearby-stores
Content-Type: application/json
{ "lat": 40.71, "lng": -74.00, "limit": 20 }
// → 200  { "geofences": [
//           { "storeId": "…", "name": "…", "lat": …, "lng": …, "distanceMeters": … }
//         ] }
//
// FAIL-CLOSED: no precise_location_consent, or a Global Privacy Control signal
// present  →  { "geofences": [] }  (empty set, no error).

2. Laporkan transisi geofence

// When the device crosses a monitored geofence, report the transition. This fires
// the near_store / store_dwell automation triggers server-side.
POST https://flash.socialhub.ai/api/v2/lbs/geofence-event
Content-Type: application/json
{ "storeId": "<uuid>", "eventType": "enter" }   // "enter" | "dwell"
// → 200  { "recorded": true }
//
// FAIL-CLOSED privacy gate:
//   GPC signal present              → { "recorded": false, "reason": "gpc" }
//   no precise_location_consent     → { "recorded": false, "reason": "no_consent" }
// Only the derived enter/dwell event is recorded — never the device's coordinates.

Privasi berdasarkan konstruksi

Lokasi yang tepat dibatasi oleh ketentuan eksplisit. precise_location_consent DAN tidak adanya sinyal Kontrol Privasi Global — keduanya diperiksa, dan dinyatakan gagal.

Hanya peristiwa masuk/berdiam yang diturunkan yang disimpan. Koordinat perangkat mentah tidak pernah disimpan; lintang/bujur yang Anda kirim ke toko terdekat digunakan sementara untuk memberi peringkat toko dan kemudian dibuang.

Persetujuan dapat ditarik dengan sekali ketuk tanpa penalti; penarikan berlaku segera pada panggilan berikutnya.

Merencanakan kampanye berbasis toko?

Bicaralah dengan seorang insinyur tentang kunjungan toko deterministik, pencabutan penangguhan, penargetan toko/wilayah, atau peta jalan geofence.

Bicara dengan bagian teknik