Android teslimat güçlendirme
Bazı Android üreticilerinde bildirimler geç gelir ya da hiç gelmez. Bu rehber nedenini, Pushizo'nun bunu nasıl ölçtüğünü ve uygulamanızda kullanıcıyı doğru ayar ekranına nasıl götüreceğinizi anlatır. Karar kaydı:…
Bazı Android üreticilerinde bildirimler geç gelir ya da hiç gelmez. Bu rehber nedenini, Pushizo'nun bunu nasıl ölçtüğünü ve uygulamanızda kullanıcıyı doğru ayar ekranına nasıl götüreceğinizi anlatır. Karar kaydı: docs/adr/0092-android-teslimat-guclendirme.md.
Sorun
Xiaomi, Redmi, POCO, Huawei, Honor, Oppo, Realme, OnePlus, Vivo, iQOO, Samsung, Meizu, Asus, Tecno ve Infinix cihazlarında üreticinin kendi pil ve otomatik başlatma yöneticisi arka plandaki uygulamaları durdurur. FCM mesajı cihaza ulaşsa bile uygulama başlatılmaz ve bildirim gösterilmez. FCM bu durumu bildirmez; sunucu tarafında mesaj "gönderildi" görünür.
Pushizo iki şey yapar:
- Ölçer. Cihazdaki SDK her mesaj için teslim alındısı gönderir. Panel bu alındıları üretici ve Android arayüzüne (ROM) göre gruplar.
- Yönlendirir. SDK cihazdaki kısıtları okur ve kullanıcıyı ilgili ayar ekranına götüren bir API sunar.
Gereksinimler
- Android SDK'nın
Pushizo.DeliveryAPI'sini içeren sürümü. Önceki sürümler de raporda görünür (üretici, cihaz modelinden çıkarılır), fakat kısıt özeti güncel SDK ister. - Ek izin gerekmez. SDK
REQUEST_IGNORE_BATTERY_OPTIMIZATIONSiznini eklemez; Google Play bu izni yalnızca belirli uygulama türlerinde kabul eder.
Cihaz durumunu okuma
val status = Pushizo.Delivery.status() ?: return
status.vendor // HsDeviceVendor.XIAOMI, HUAWEI, OPPO, VIVO, SAMSUNG … OTHER
status.rom // "hyperos", "miui", "emui", "coloros", "oneui" …
status.batteryOptimizationExempt // uygulama pil optimizasyonundan muaf mı
status.backgroundRestricted // kullanıcı arka plan etkinliğini kısıtladı mı
status.standbyBucket // ACTIVE, WORKING_SET, FREQUENT, RARE, RESTRICTED
status.risk // NONE, ELEVATED, HIGH
status.recommendedSettings // açılması önerilen ayar ekranları| Risk | Anlamı |
|---|---|
NONE | Bilinen bir engel yok |
ELEVATED | Bildirimler gecikebilir: saldırgan pil yönetimi olan üretici ve pil muafiyeti yok, seyrek kullanım kovası ya da veri tasarrufu açık |
HIGH | Bildirimler büyük olasılıkla gelmiyor: bildirim izni ya da kanalı kapalı, arka plan etkinliği kısıtlı |
Otomatik başlatma izninin açık olup olmadığı Android'de okunamaz. Bu yüzden SDK saldırgan üreticilerde pil muafiyeti yoksa riski ELEVATED sayar.
Kullanıcıyı ayar ekranına götürme
Hazır diyaloğu kullanın. Metin 22 dilde gelir; kullanıcı kabul ederse ilgili ayar ekranı açılır.
if (Pushizo.Delivery.shouldShowGuidance()) {
Pushizo.Delivery.showGuidance(activity) { opened ->
// opened: ayar ekranı açıldı mı
}
}shouldShowGuidance() risk varsa ve diyalog son 14 günde gösterilmediyse true döner. Aralığı shouldShowGuidance(minIntervalDays = 30) ile değiştirebilirsiniz. SDK diyaloğu kendiliğinden göstermez; uygun anı siz seçersiniz. Öneri: kullanıcı bildirimlerden yararlanacağı bir işlemi (sipariş, rezervasyon, takip) tamamladıktan hemen sonra.
Kendi arayüzünüzü kullanıyorsanız ekranı doğrudan açın:
Pushizo.Delivery.openSettings(context) // duruma en uygun ekran
Pushizo.Delivery.openSettings(context, HsDeliverySetting.AUTO_START) // otomatik başlatma yöneticisi
Pushizo.Delivery.openSettings(context, HsDeliverySetting.BATTERY_OPTIMIZATION) // pil ayarı
Pushizo.Delivery.openSettings(context, HsDeliverySetting.NOTIFICATIONS) // bildirim ayarı
Pushizo.Delivery.openSettings(context, HsDeliverySetting.APP_DETAILS) // uygulama ayrıntılarıopenSettings önce üreticinin kendi ekranını dener. Ekran cihazda yoksa ya da açılmasına izin verilmiyorsa standart Android ekranına düşer: pil optimizasyonu listesi, sonra uygulama ayrıntıları, sonra ayarlar. Bir ekran açıldıysa true döner; hiçbir durumda istisna atmaz.
Diyalog metinlerini uygulamanızın strings.xml dosyasında aynı adlarla ezebilirsiniz: hs_delivery_title, hs_delivery_message, hs_delivery_message_vendor, hs_delivery_open_settings.
Panelde teslimat sağlığı
Analitik → Android sekmesi şunları gösterir:
- Teslim oranı (teslim alındı / gönderildi) ve gönderimden cihaza ulaşmaya kadar geçen süre (ortanca ve 90. yüzdelik).
- Üretici tablosu: cihaz, kısıtlı cihaz, gönderildi, teslim alındı, açılma oranı, gecikme, önceliği düşürülen mesaj.
- Cihaz kısıtları: arka planı kısıtlı, pil optimizasyonu açık, seyrek kullanım kovasında, pil ya da veri tasarrufu açık, bildirim kanalı ya da izni kapalı.
- Android arayüzüne (MIUI, HyperOS, EMUI, ColorOS, One UI …) göre kırılım.
- Öneriler: verinize göre atmanız gereken adım.
| Öneri | Ne zaman çıkar | Ne yapmalı |
|---|---|---|
| SDK güncellemesi | Cihazların yarısından azı teşhis bildiriyor | Uygulamadaki Android SDK'yı güncelleyin |
| Üretici yönlendirmesi | Saldırgan pil yönetimli üreticilerde teslim oranı diğerlerinden en az 5 puan düşük | showGuidance ile kullanıcıyı ayarlara götürün |
| Arka plan kısıtı | Teşhisli cihazların en az %10'u kısıtlı | Bu kullanıcılara uygulama içi mesajla kısıtı kaldırmalarını önerin |
| Pil muafiyeti | Saldırgan üretici cihazlarının en az %80'inde pil optimizasyonu açık | Kritik bildirimler için pil kısıtlamasının kaldırılmasını isteyin |
| Öncelik düşüşü | Teslim alınan mesajların en az %5'inde FCM önceliği düşürdü | Yüksek önceliği yalnızca görünen bildirimlerde kullanın |
| Bildirim izni | Cihazların en az %30'unda izin kapalı | İzni uygun anda ve ön açıklamayla isteyin |
Küçük örneklemde (10 cihazdan ya da 20 gönderimden az) öneri üretilmez.
API
Aynı rapor public API'den alınır (analytics:read kapsamı). from ve to verilmezse son 30 gün; compare=true önceki dönemi de döner; format=csv üretici tablosunu CSV olarak indirir.
curl "https://api.pushizo.com/v1/apps/$APP_ID/analytics/android-delivery?compare=true" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"{
"devices": { "total": 1840, "reporting": 1512, "restricted": 131, "restricted_rate": 0.0866, "aggressive_vendor": 1204 },
"totals": { "sent": 52310, "delivered": 44102, "delivery_rate": 0.8431, "median_delay_seconds": 4, "p90_delay_seconds": 310 },
"aggressive": { "sent": 33120, "delivered": 26010, "delivery_rate": 0.7853 },
"others": { "sent": 19190, "delivered": 18092, "delivery_rate": 0.9428 },
"vendors": [
{ "vendor": "xiaomi", "aggressive": true, "devices": 612, "sent": 17400, "delivered": 12870, "delivery_rate": 0.7397, "median_delay_seconds": 9 }
],
"recommendations": ["vendor_guidance", "battery_exemption"]
}SDK neyi bildirir
Abonelik kaydıyla birlikte yalnızca şu alanlar gider; kişisel veri içermez ve gizlilik onayı beklenirken gönderilmez:
| Alan | Örnek |
|---|---|
manufacturer, brand | xiaomi, redmi |
rom, rom_version | hyperos, 1.0.2.0 |
delivery.battery_optimization_exempt | false |
delivery.background_restricted | false |
delivery.standby_bucket | active, working_set, frequent, rare, restricted |
delivery.power_save_mode, delivery.data_saver, delivery.channel_blocked | false |
Üretici, ROM, pil muafiyeti ve arka plan kısıtı değişince sunucu hemen güncellenir. Kova ve tasarruf kipleri en sık günde bir yazılır.
Teslim alındısı da güçlendirildi: uygulama arka plandayken alındı kalıcı kuyruğa yazılır ve ayrıca planlanmış bir işle gönderilir, yani süreç durdurulsa da ulaşır. Alındı cihazın mesajı aldığı anı taşır; gecikme bu ana göre hesaplanır.
Sınırlar
- Otomatik başlatma izninin durumu okunamaz. Kullanıcının ayarı yaptığı, teslim oranındaki iyileşmeden anlaşılır.
- Üretici ekranları belgelenmemiştir ve sürümden sürüme değişir. Eskiyen ekran zarar vermez; SDK standart ekrana düşer.
- Köprü SDK'lar (Flutter, React Native, Capacitor, Cordova, Unity, .NET MAUI, Kotlin Multiplatform) yerel Android SDK'yı kullanır. Teşhis ve alındı güçlendirmesi yerel sürüm yükseltilince kendiliğinden gelir.
Pushizo.Deliveryçağrıları (durum,openSettings,showGuidance,shouldShowGuidance) köprülerde de vardır; kullanım her köprünün SDK sayfasındaki "Android teslimat güçlendirme" bölümündedir. iOS'ta ve diğer platformlarda çağrılar zararsızdır: durum "desteklenmiyor / risk yok" döner, ayar ekranı ve diyalog açılmaz. - Rapor yalnızca Android kanallarını (FCM, Huawei HMS, Amazon ADM) kapsar.