SocialHub.AI
Recursos · Centro para desarrolladores

Marketing de ubicación y tienda

Vincular la interacción con la tienda física: medir las visitas reales a la tienda, con clave de miembro; segmentar por tienda o región; y (en la hoja de ruta) volver a interactuar con los miembros que estuvieron cerca de una tienda. Diseñado priorizando la privacidad: consentimiento + Control de privacidad global, cierre de seguridad en caso de fallo, sin almacenar coordenadas sin procesar.

Lea atentamente las insignias: las visitas deterministas a las tiendas están en vivo; los puntos finales de geocerca están construidos en el servidor y son invocables; la detección en el dispositivo que completa la audiencia de proximidad está en desarrollo.

Que hay en vivo, que viene

Visita determinista a la tiendaEn vivo

Un registro QR o un canje en la tienda activa un evento de visita a la tienda con clave de miembro y deduplicación de base de datos. No se necesita ubicación del dispositivo. Con una resistencia aleatoria, se mide el verdadero incremento incremental.

Orientación por tienda/regiónEn vivo

Diríjase a los miembros por su tienda o región atribuida para obtener ofertas relevantes para la ubicación: propias, sin seguimiento de dispositivos. (Se está implementando el segmento de región).

Puntos finales de geovalla + activadoresServidor creado

Las tiendas cercanas + el evento de geofence están activos y se pueden llamar, con consentimiento + GPC cerrado por falla y activadores de automatización near_store / store_dwell conectados.

Detección de proximidad en el dispositivoEn desarrollo

Geovallado en segundo plano dentro del paquete FlashLocation (CoreLocation / Play Services). En desarrollo activo y aún no validado en dispositivos, por lo que la función de seguimiento de extremo a extremo de "cerca de una tienda recientemente" aún no está disponible.

Empieza aquí: visitas deterministas a tiendas En vivo

// 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.

Puntos finales de geocerca Servidor creado

Estas funciones están disponibles y se pueden activar desde una sesión de miembro con sesión iniciada. El componente del dispositivo que las activa —la monitorización de geovalla en segundo plano— se incluye en el paquete FlashLocation, que aún está en desarrollo; hasta entonces, la audiencia de proximidad de extremo a extremo no está disponible.

1. Obtén las geocercas de las tiendas más cercanas para monitorear

// 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. Informe de una transición de geocerca.

// 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.

Privacidad por diseño

La ubicación precisa está sujeta a restricciones explícitas. precise_location_consent Y la ausencia de una señal de Control de Privacidad Global: ambas comprobadas, fallo cerrado.

Sólo se almacenan los eventos de entrada/permanencia derivados. Las coordenadas sin procesar del dispositivo nunca se conservan; el lat/lng que envías a las tiendas cercanas se usa transitoriamente para clasificar las tiendas y se descarta.

El consentimiento se puede revocar con un solo toque sin penalización; la revocación surte efecto inmediatamente en la siguiente llamada.

¿Planificando campañas impulsadas por la tienda?

Habla con un ingeniero sobre visitas deterministas a tiendas, aumento de la retención, segmentación por tienda/región o la hoja de ruta de geocercas.

hablar con ingenieria