資源 · 開發者中心
地點和門市行銷
將使用者互動與實體店面關聯－衡量會員輸入的真實到店訪問量，按門市或地區進行精準行銷，並（在規劃中）重新吸引曾到過門市的會員。隱私至上：使用者同意 + 全域隱私控制，失敗自動關閉，不儲存原始座標。
仔細閱讀徽章：確定性商店訪問已上線；地理圍欄端點已伺服器構建且可調用；完善鄰近受眾的設備端檢測功能正在開發中。
正在直播什麼，即將發生什麼
確定性門市訪問即時
二維碼簽到或店內兌換會觸發由會員輸入、資料庫去重的門市存取事件。無需設備位置資訊。透過隨機保留，您可以衡量 true 的增量提升。
商店/區域定位即時
根據會員所屬門市或地區，提供與地點相關的優惠－第一方數據，無需設備追蹤。 （地區細分功能正在推出。）
地理圍籬端點+觸發器伺服器已搭建
附近商店 + 地理圍欄事件已啟用且可調用，需獲得用戶許可 + GPC 失敗關閉 near_store / store_dwell 自動化觸發器已內建。
設備上的接近檢測開發中
FlashLocation 套件（CoreLocation / Play Services）中的後台地理圍籬功能。目前仍在積極開發中，尚未經過設備驗證——因此「最近在商店附近」的端到端受眾功能尚未上線。
從這裡開始：確定性門市訪問 即時
// 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.地理圍籬端點 伺服器已搭建
這些功能目前已上線，可透過已登入會員會話呼叫。呼叫這些功能的裝置端元件－後台地理圍籬監控－隨FlashLocation軟體包一同提供，該軟體包目前仍在開發中；在此之前，端到端的近距離受眾功能尚未上線。
1. 取得最近的門市地理圍籬進行監控
// 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. 報告地理圍籬變更
// 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.建構隱私保護
精確位置由明確的 `precise_location_consent` 和全域隱私控制訊號的缺失共同決定－兩項皆已檢查，失敗則關閉。
僅儲存派生的進入/停留事件。原始設備座標永遠不會持久化；您發送到附近商店的緯度/經度會暫時用於對商店進行排名並被丟棄。
只需輕按一下即可撤回同意，無需支付任何費用；撤回將在下次呼叫時立即生效。