Ana içeriğe atla

App Clip’ler için OneSignal desteği

OneSignal, iOS App Clip’lerine push bildirimleri göndermeyi destekler. App Clip’lerin ayrı bir paket tanımlayıcısı olduğu için, kendi push yapılandırmalarını gerektirir. App Clip’inizi OneSignal ile düzgün bir şekilde yapılandırmak ve mevcut sınırlamaları anlamak için aşağıdaki adımları izleyin.

Kurulum

1. App Clip’iniz için yeni bir uygulama oluşturun

OneSignal Kontrol Panelinde App Clip’iniz için ayrı bir uygulama oluşturmalısınız. Bunun nedeni:
  • App Clip’lerin ana uygulamadan farklı bir paket tanımlayıcısı kullanması.
  • Apple’ın her benzersiz paket kimliği için farklı bir APNs sertifikası veya Anahtarı gerektirmesi.
App Clip paket kimliğinizin Apple Developer Console’da yapılandırılmış kendi APNs kimlik doğrulamasına sahip olduğundan ve OneSignal’da bağlı olduğundan emin olun.

2. App Clip’inizde OneSignal’ı kurun

Standart OneSignal iOS SDK kurulum kılavuzu’nu izleyin, ancak Notification Service Extension adımını atlayın:
  • ✅ Yapın: OneSignal SDK’sını App Clip hedefinize ekleyin.
  • ❌ Atlayın: Notification Service Extension — App Clip’ler bu yeteneği desteklememektedir.

3. Geçici push iznini etkinleştirin

App Clip açıldığında otomatik olarak 8 saatlik push bildirimi izinlerini etkinleştirmek için App Clip’inizin Info.plist dosyasına aşağıdakileri ekleyin:
<key>NSAppClip</key>
<dict>
  <key>NSAppClipRequestEphemeralUserNotification</key>
  <true/>
</dict>

Geçici push bildirimi Info.plist ayarı

Bu geçici izin, kullanıcı daha önce devre dışı bırakmadıkça 8 saat sonra sona erer. Ayrıca, tam uygulamalara benzer şekilde, başlatma sırasında süresiz push izni talep edebilirsiniz. Tam rehberlik için Apple belgelerine başvurun.

4. Gelişmiş App Clip deneyimlerini destekleyin

Belirli App Clip deneyimlerini bildirimlerle hedeflemek için:
  1. OneSignal Kontrol Panelinde Ayarlar > iOS platform yapılandırması’nı açın.
  2. Target-Content-ID alanına bir değer ekleyin. Bu, App Store Connect’te yapılandırdığınız deneyim URL’si olmalıdır.

Target-Content-ID aracılığıyla belirli bir App Clip deneyimini hedefleme

Daha fazla bilgi için, İlişkili Alan Adları ve Target-Content-ID kullanımını kapsayan Apple’ın App Clip Oluşturma kılavuzuna bakın.

App Clip sınırlamaları

iOS platform kısıtlamaları nedeniyle, App Clip’lere aşağıdaki sınırlamalar uygulanır:
  • Geçici izin süresi: Yalnızca 8 saat sürer. Bunun ötesinde bildirim göndermek için tam push izni isteyin.
  • Notification Service Extension desteği yok:
    • ❌ Zengin medya yok (resim, video vb.)
    • ❌ Özel eylem düğmeleri yok (yalnızca önceden tanımlanmış kategorilere izin verilir)
  • Konum erişimi sınırlıdır:
    • App Clip’ler Her Zaman konum erişimi talep edemez.
    • Kullanım Sırasında talep edebilirler, bu da ertesi gün sabah 4:00’te sona erer.