Konum tabanlı hedefleme

Kullanıcının izniyle cihaz konumunu alıp "şu noktanın X km yakınındakiler" segmentleri oluşturabilirsiniz (docs/adr/0025-hms-flutter-web-catalyst-konum.md).

İlkeler (KVKK)Bağlantıyı kopyala

• Konum yalnızca uygulama ön plandayken, işletim sistemi izni verildikten ve uygulamanız Location.setShared(true) çağırdıktan sonra gönderilir. Arka plan konumu toplanmaz.
• İlk paylaşım anı açık rıza kaydı olarak saklanır (location_consent_at).
• Location.setShared(false) çağrıldığında konum ve rıza kaydı sunucuda hemen silinir.
• Koordinatlar 5 ondalığa (≈1 m) yuvarlanır; SDK en sık 5 dakikada bir günceller.
• İzin isteminden önce kullanıcıya konumun neden istendiğini anlatan bir açıklama gösterin (SDK requestPermission isteğe bağlı açıklama metni alır).

SDKBağlantıyı kopyala

Pushizo.Location.requestPermission(activity, rationale = "Yakınınızdaki mağaza kampanyaları için")
Pushizo.Location.setShared(true)

Pushizo.Location.requestPermission()
Pushizo.Location.setShared(true)

await Pushizo.Location.requestPermission();
Pushizo.Location.setShared(true);

Ayrıntılar ve diğer platformlar: Android, iOS, Flutter, Web SDK ve köprü README'leri. iOS'ta Info.plist içine NSLocationWhenInUseUsageDescription ekleyin.

SegmentBağlantıyı kopyala

Segmentler → Yeni → Koşul ekle → Konum:

API tanımı:

{ "all": [{ "field": "location", "op": "within_radius", "lat": 41.0082, "lng": 28.9784, "radius_km": 5, "days": 7 }] }

days isteğe bağlıdır: yalnızca son N günde güncellenen konumları sayar. Konum paylaşmayan kullanıcılar bu koşulla hiçbir zaman eşleşmez.

Sunucu tarafıBağlantıyı kopyala

Konum, SDK'nın abonelik güncellemesiyle gelir (PATCH /sdk/v1/apps/{appId}/subscriptions/{id}, location: { lat, lng, accuracy_m } | null). Dashboard'da kullanıcı detayındaki abonelik satırında yaklaşık konum ve güncelleme zamanı görünür; public API'nin abonelik yanıtları location alanını içerir.