Kurulum
Paket kurulumu ve başlatma
SDK'yı kurmak ve başlatmak.
Kurulum
Paketi projenize ekleyin:
npm install @selwise/react-native
API anahtarı
Mobil kurulumun en kritik adımıdır ve en sık burada hata yapılır.
Native fetch, tarayıcının aksine Origin başlığı göndermez. Sunucu bu durumda API anahtarı doğrulamasına düşer. Anahtarı panelden Sites → API Keys altından oluşturursunuz.
Anahtar iki scope da taşımalı
Anahtarınız hem mobile_read hem mobile_write scope'unu taşımalıdır.
Sebep ince ama kesin: öneri ürünleri uç noktası bir POST isteğidir (ziyaretçi bağlamını gövdede taşır) ve sunucu gerekli scope'u HTTP metodundan türetir — GET için mobile_read, diğer her şey için mobile_write.
Yalnızca mobile_read taşıyan bir anahtarla her şey çalışır, sadece öneriler 403 döner. Başka hiçbir yerde hata görmediğiniz için sorunu bulmak zaman alır.
Anahtar uygulama içinde taşınır
Anahtar uygulama paketinin içindedir ve çıkarılabilir. Bu kabul edilebilir bir risktir: scope'lar yalnızca public okuma ile olay ve sipariş yazmayı kapsar; panel erişimi vermez.
Anahtar sızdığında panelden yenileyin.
Başlatma
Uygulama açılışında bir kez başlatın:
await selwise.init({
siteKey: 'SITE_KEY',
apiKey: 'SELWISE_API_KEY',
});
init() iki iş yapar: kimliği çözer ve önceki oturumdan kalan olay kuyruğunu yeniden gönderir. Bu yüzden mümkün olduğunca erken çağırın.
Onay
Kullanıcı takibi reddettiyse SDK'yı onaysız başlatın:
await selwise.init({
siteKey: 'SITE_KEY',
apiKey: 'SELWISE_API_KEY',
consent: { granted: false },
});
Bu durumda olaylar toplanmaz. Kullanıcı sonradan onay verirse onay durumunu güncelleyebilirsiniz.
Doğrulama
Kurulumun çalıştığını doğrulamak için:
- Uygulamayı açın ve birkaç ekran gezin.
- Panelde Analytics sayfasında ziyaretçi sayısının arttığını görün.
- Bir test siparişi gönderin ve panele düştüğünü kontrol edin.
Sırada ne var
Son güncelleme: 9 Eylül 2026