PushizoDocs

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.Delivery API'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_OPTIMIZATIONS iznini 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ı
RiskAnlamı
NONEBilinen bir engel yok
ELEVATEDBildirimler gecikebilir: saldırgan pil yönetimi olan üretici ve pil muafiyeti yok, seyrek kullanım kovası ya da veri tasarrufu açık
HIGHBildirimler 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.
ÖneriNe zaman çıkarNe yapmalı
SDK güncellemesiCihazların yarısından azı teşhis bildiriyorUygulamadaki Android SDK'yı güncelleyin
Üretici yönlendirmesiSaldırgan pil yönetimli üreticilerde teslim oranı diğerlerinden en az 5 puan düşükshowGuidance 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 muafiyetiSaldırgan üretici cihazlarının en az %80'inde pil optimizasyonu açıkKritik 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 izniCihazları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, brandxiaomi, redmi
rom, rom_versionhyperos, 1.0.2.0
delivery.battery_optimization_exemptfalse
delivery.background_restrictedfalse
delivery.standby_bucketactive, working_set, frequent, rare, restricted
delivery.power_save_mode, delivery.data_saver, delivery.channel_blockedfalse

Ü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.

Bu sayfada