SocialHub.AI
リソース · 開発者センター

ロケーションと店舗のマーケティング

エンゲージメントを実店舗に結び付ける — メンバーに基づいて実際の来店を測定し、店舗または地域ごとにターゲットを絞り、(ロードマップ上で) 店舗の近くに来たメンバーを再エンゲージします。プライバシーを第一に構築: 同意 + グローバル プライバシー コントロール、フェールクローズ、生の座標は保存されません。

バッジを正確に読み取ります。確定的な来店はライブです。ジオフェンス エンドポイントはサーバーで構築され、呼び出し可能です。近接オーディエンスを完了するデバイス上の検出は開発中です。

ライブの内容、今後の予定

決定的な来店ライブ

QR チェックインまたは店舗での引き換えにより、メンバーキー、DB 重複排除された来店イベントが発生します。デバイスの場所は必要ありません。ランダム化されたホールドアウトを使用すると、真の増分リフトを測定できます。

店舗/地域ターゲティングライブ

位置情報に関連したオファーについて、属性のある店舗または地域に基づいてメンバーをターゲットにします。ファーストパーティ、デバイス追跡なし。 (地域セグメントの展開。)

ジオフェンス エンドポイント + トリガーサーバー構築済み

Near-stores + geofence-event はライブで呼び出し可能であり、同意 + 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 さらに、グローバルプライバシー制御シグナルの欠如も確認済みで、両方ともフェイルクローズです。

派生した開始/滞留イベントのみが保存されます。未処理のデバイス座標は永続化されません。近くの店舗に送信する緯度/経度は、店舗をランク付けするために一時的に使用され、破棄されます。

同意はペナルティなしでワンタップで撤回できます。撤回は次の呼び出しで直ちに有効になります。

店舗主導のキャンペーンを計画していますか?

決定的な来店、ホールドアウトリフト、店舗/地域のターゲティング、またはジオフェンスのロードマップについてエンジニアに相談してください。

エンジニアリングに相談する