WSelwise

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.

Uygulamanız Selwise'te bir uygulama kanalıdır — doğrulanacak bir alan adı, dolayısıyla Origin başlığının kanıtlayabileceği bir şey yoktur. Bu yüzden uygulama kanalının her isteği koşulsuz olarak API anahtarıyla kimlik doğrular. (Native fetch zaten Origin göndermez; uygulama kanalında başlık gönderilse bile anahtar zorunludur, böylece uygulama içindeki bir WebView de yanındaki native kodla aynı yoldan geçer.) Bkz. Uygulama Kanalları. Anahtarı panelden Kanallar ekranında kanalınızın satırındaki ⋮ menüsünden API anahtarları'nı açarak oluşturursunuz; Kullanım amacı olarak Mobil uygulama seçin.

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

Paket bir sınıf verir, hazır nesne vermez. Uygulama başına bir örnek oluşturup açılışta bir kez başlatın:

import AsyncStorage from '@react-native-async-storage/async-storage';
import { Selwise } from '@selwise/react-native';

export const selwise = new Selwise();

await selwise.init({
  channelKey: 'CHANNEL_KEY',
  apiKey: 'SELWISE_API_KEY',
  storage: AsyncStorage,
});

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.

storage geçmezseniz her açılış yeni ziyaretçi olur

storage verilmezse SDK hafızada tutar. Uygulama her kapandığında ziyaretçi kimliği, giriş yapmış kullanıcı ve çevrimdışı kuyruk kaybolur — yani her açılış yeni bir ziyaretçi gibi görünür ve çevrimdışı toplanan olaylar hiç gönderilmez. Bu durum yalnızca debug: true iken günlüğe düşer.

Kendi sunucunuzu gösterme

apiUrl sürüm önekini de içerir. Varsayılan https://api.selwise.com/api/v1; yerel bir kuruluma bağlanıyorsanız http://localhost:3001/api/v1 yazın. Öneki atlarsanız her çağrı 404 döner ve boş katalog gibi görünür.

Onay

Kullanıcı takibi reddettiyse SDK'yı onaysız başlatın:

await selwise.init({
  channelKey: 'CHANNEL_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:

  1. Uygulamayı açın ve birkaç ekran gezin.
  2. Panelde Analytics sayfasında ziyaretçi sayısının arttığını görün.
  3. Bir test siparişi gönderin ve panele düştüğünü kontrol edin.

Sırada ne var

Son güncelleme: 9 Ekim 2026