Telefonu Bildirime Kaydetme
Telefon anahtarını kaydetme, izin ve dokunulan bildirim
Bir senaryonun Uygulama bildirimi gönder adımı, alışverişçinin telefonuna sizin Firebase, Apple ya da Expo hesabınız üzerinden bildirim yollar. Uygulamanın işi üç çağrıdır: telefonun anahtarını kaydetmek, işletim sisteminin iznini bildirmek ve bildirime dokunulunca açılacak bağlantıyı Selwise'e okutmak. Panel tarafı ve sağlayıcı kurulumu: Uygulama Bildirimleri (panel).
Üç çağrı
import { Platform } from 'react-native';
import messaging from '@react-native-firebase/messaging';
// 1. İşletim sistemi bildirime izin veriyor mu?
const status = await messaging().hasPermission();
selwise.setPushPermission(
status === messaging.AuthorizationStatus.AUTHORIZED ? 'granted'
: status === messaging.AuthorizationStatus.DENIED ? 'denied'
: 'undetermined',
);
// 2. Anahtarı her açılışta ve kütüphane yenilediğinde kaydedin.
const platform = Platform.OS === 'ios' ? 'ios' : 'android';
await selwise.registerPushToken({ token: await messaging().getToken(), provider: 'fcm', platform });
messaging().onTokenRefresh((token) => selwise.registerPushToken({ token, provider: 'fcm', platform }));
// 3. Bildirime dokunulunca bağlantıyı açın.
messaging().onNotificationOpenedApp((message) => {
const link = selwise.trackPushOpen(message);
if (link) Linking.openURL(link);
});
registerPushToken kaydedildiğinde true, onay yokluğu ya da ağ hatası yüzünden gönderilemediğinde false döner ve uygulamaya hata fırlatmaz; yalnızca olamayacak bir çağrıda (anahtar yok, bilinmeyen sağlayıcı, platform yok) hata verir. unregisterPushToken() uygulamanın kendi "bildirimleri kapat" düğmesi içindir.
Hangi anahtar, hangi provider
Anahtarın ailesi, hangi sağlayıcınızın göndereceğini belirler; bu yüzden provider zorunludur.
| Bildirim kütüphaneniz | Anahtar | provider |
|---|---|---|
@react-native-firebase/messaging getToken() (Android ve Firebase üzerinden iOS) | FCM kayıt anahtarı | fcm |
expo-notifications getDevicePushTokenAsync(), Android | FCM kayıt anahtarı | fcm |
expo-notifications getDevicePushTokenAsync(), iOS ya da yerel APNs kaydı | APNs cihaz anahtarı | apns |
expo-notifications getExpoPushTokenAsync() | Expo push anahtarı | expo |
APNs anahtarı her zaman iOS'tur. FCM ve Expo anahtarlarında platform verin ya da init içinde belirtin. Android'de FCM, iOS'ta APNs kullanıyorsanız panelde iki sağlayıcıyı bağlarsınız ve senaryoda tek adım yazarsınız.
SDK sizin yerinize neye dikkat eder
- İzin kişinin cevabıdır. Bir telefona yalnızca
setPushPermission('granted')iken bildirim gider. İzin bildirilmeden kaydedilen anahtar undetermined tutulur ve hiç bildirim almaz; izin değiştiğinde (denied, sonradangranted) SDK yeni cevabı kayıtlı anahtar için yeniden yollar. - Önce onay. Telefonu kaydetmek bir pazarlama kararıdır (
setConsent). Onay yoksa anahtar gönderilmez; onay geri çekilirse telefon iptal edilir, uygulama kapalıyken geri çekilmişse bir sonraki açılışta. İptal edilmiş telefonu yalnızca yeni bir onay geri getirir: bildirim izni ya da yenilenen anahtar tek başına getirmez, çünkü SDK her kayıt isteğine pazarlama onayının açık olduğunu da yazar ve sunucu bunu yalnızca onay yüzünden iptal edilmiş telefon için arar. - Müşteri girişi izler.
identify()telefonu müşteriye bağlar (sunucu bağı yalnızca bu ziyaretçiyi o müşteriye bağlayabildiyse tutar),logout()çözer. Telefon bu kuruluma ait olarak ulaşılabilir kalır; giriş yapmış kişiyle başlayan bir senaryo, o kişinin telefonlarını bulur. - Yenilenen anahtar özel bir şey istemez. Yenisini kaydedin; kurulumun eski anahtarı sunucuda iptal edilir.
- Sağlayıcının artık yok dediği telefon (uygulama silinmiş) ulaşılamaz olur; kişi uygulamayı yeniden açıp kaydı yenilerse canlanır.
Bildirimin taşıdığı
Başlık, mesaj, isteğe bağlı görsel, sizin yazdığınız ek veri anahtarları ve sw_link: adımın işaret ettiği ekran ya da bağlantı. Bağlantıya senaryo kimliği (sw_sc) eklenmiştir; trackPushOpen bunu mesaj tıklaması olarak kaydeder ve ardından gelen sipariş, diğer mesaj kanallarında olduğu gibi o mesaja yazılır (Siparişler ve ciro atfı). Görseli uygulamanın kendisi çiziyorsa adresi sw_image anahtarında bulur. Selwise hiçbir zaman gezinmez: bağlantıyı açmak uygulamanın işidir.
Bağlantı, panelde seçilen bir uygulama ekranı (app://basket), uygulamanızın kendi derin bağlantısı ya da bir https:// adresi olabilir. app:// adresleri Selwise'in kendi ekran adlarıdır; yalnızca uygulamanız onları bir ekrana eşliyorsa açılır, aksi hâlde kendi derin bağlantı şemanızı kullanın.
Cihazda gerekenler
Android 13 ve üstünde işletim sistemi bildirimi göstermeden önce POST_NOTIFICATIONS çalışma zamanı izni ister. iOS izin isteğini (requestPermission) ister; görselli bildirim için bir bildirim servis uzantısı gerekir. Bunların hepsi uygulamanın işidir; Selwise yalnızca cevabı okur.
Akinon App Maker
App Maker'ın kendi bildirim eklentisi (akinon-firebase-messaging-service) FCM anahtarını başka eklentilerle paylaşmaz; bu yüzden uygulamanın kendi kodundan eklentiye Selwise.registerPushToken ve Selwise.setPushPermission çağırması gerekir. Bildirim App Maker'ın eklentisinden geçiyorsa o eklentinin notification.deepLink.integrationMaps.urlPath ayarını data.sw_link yapın: App Maker bağlantıya gider, Selwise eklentisi de App Maker'ın derin bağlantı servisini dinlediği için dokunuşu kaydeder. Ayrıntı: Akinon App Maker Eklentisi.
Son güncelleme: 17 Kasım 2026
