Mobil SDK’ya Genel Bakış

Selwise'in React Native SDK'sı (@selwise/react-native), mobil uygulamanızı web sitenizle aynı Selwise hesabına bağlar: aynı müşteri profili, aynı öneriler, aynı kampanyalar, aynı ciro raporu. Bu bölüm, yalnızca bu sayfaları okuyan bir geliştiricinin SDK'yı kurup kullanabilmesi için yazıldı; panel tarafındaki karşılığı Uygulama Kanalları sayfasındadır.

SDK ne yapar, ne yapmaz

SDK size veri verir, arayüz vermez. Hangi kampanyanın bu ekranda gösterilmeye hakkı olduğunu, bir öneri şeridinin hangi ürünleri taşıdığını, bir hedef çubuğunun ne yazması gerektiğini hesaplar; çizimi uygulamanızın kendi bileşenleri yapar. Selwise'in çizdiği bir banner uygulamanızın yanında yabancı görünürdü. Akinon App Maker kullanıyorsanız çizimi eklenti sizin yerinize yapar.

SDK saf JavaScript'tir: native modül, pod install ya da Gradle değişikliği gerektirmez. Çalışma zamanı bağımlılığı yoktur; react yalnızca hook'lar için isteğe bağlı eş bağımlılıktır.

Web'den üç fark

1. URL yok. Web'de sayfa hedefleme, huni ve yolculuklar URL'e dayanır. Uygulamada her ekran için sentetik bir ad (app://home, app://product) kullanırsınız ve panelde hedeflemeyi bu değerlere göre yaparsınız. Ayrıntı: Event Takibi.

2. Origin başlığı yok. Web'de her public istek Origin başlığıyla doğrulanır. Native fetch bu başlığı göndermez, uygulama kanalının doğrulanacak bir alan adı da yoktur; bu yüzden uygulama kanalı her zaman x-selwise-api-key başlığıyla kimlik doğrular. Ayrıntı: Kurulum.

3. Çevrimdışı kuyruk. Ağ yokken olaylar kalıcı bir kuyruğa yazılır ve bağlantı gelince gönderilir. Ayrıntı: Kimlik, Onay ve Kuyruk.

Ne çalışır

Özellik	Mobilde	Sayfa
Olay takibi, ekran takibi	Var	Event Takibi
Kimliklendirme, onay, çıkış	Var	Kimlik, Onay ve Kuyruk
Sipariş ve ciro atfı	Var	Event Takibi
Kampanya ve widget kararı	Var; segment, deney, sıklık sınırı, çatışma çözümü dahil	Kampanya ve Widget
Koşullu içerik, sepet ve ürün değerleri, hedef çubuğu, geri sayım	Var; sepeti ve ürünü uygulama bildirir	Sepet ve Dinamik İçerik
Custom widget (HTML/CSS/JS)	Var; izole WebView içinde	Özel Widget
Senaryonun "Sitede göster" adımı	Var; uygulama açılınca teslim alınır	Senaryo Gelen Kutusu
Öneriler	Var; hook ve doğrudan çağrı, A/B deneyleriyle	Öneriler
Arama	Var; yönlendirme kuralları dahil	Arama
Ürün zenginleştirme	Var; yuva adıyla	Zenginleştirme: uygulama
WebView checkout ölçümü	Var; köprüyle	WebView Köprüsü
Marka teması, takip ayarları	Var	Özel Widget

Uygulama kanalında olmayanlar: sayfa deneyleri (DOM'u değiştiren deneyler), sekme mesajı (tab_talk), özel script'ler, veri katmanı ve zenginleştirmede sunucu taraflı render. Varlık deneyleri (kampanya, widget ve öneri şeridi üzerinde A/B) çalışır.

SDK'da olmayan çağrılar

Web widget'ındaki bazı çağrıların karşılığı yoktur; bunları aramayın:

Web	Mobilde
setTraits	Yok. Özellikleri identify(id, traits) ile gönderin.
endJourney	Yok. Çıkışta logout() yeni oturum başlatır.
pushDataLayer, grantConsent, revokeConsent	Yok. Onay için setConsent().

Sırada ne var

1. Kurulum ve API anahtarı
2. Event Takibi
3. Kampanya ve Widget
4. Sorun çıkarsa Sorun Giderme; tüm imzalar için API Referansı