资源 · 开发者中心
位置和门店营销
将用户互动与实体店关联——衡量会员输入的真实到店访问量，按门店或地区进行精准营销，并（在规划中）重新吸引曾到过门店的会员。隐私至上：用户同意 + 全局隐私控制，失败自动关闭，不存储原始坐标。
请仔细阅读徽章信息：确定性门店访问数据已上线 (live)；地理围栏端点由服务器构建并可调用 (live)；用于完善邻近受众定位的设备端检测功能正在开发中 (live)。
正在直播什么，即将发生什么
确定性的商店访问实时
二维码签入或店内兑换会触发会员密钥、数据库重复数据删除的商店访问事件。无需设备位置。通过随机保留，您可以测量真正的增量升力。
商店/区域定位实时
按会员所属商店或区域定位会员，获取与位置相关的优惠——第一方，无设备跟踪。 （区域部分推出。）
地理围栏端点+触发器服务器已搭建
附近商店 + 地理围栏事件是实时且可调用的，并已连接同意 + 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` 和全局隐私控制信号的缺失共同控制——两者都已检查，失败则关闭。
仅存储派生的进入/停留事件。原始设备坐标永远不会被持久化；您发送到附近商店的纬度/经度会暂时用于对商店进行排名并被丢弃。
只需轻点一下即可撤回同意，无需支付任何费用；撤回将在下次调用时立即生效。