Ana içeriğe atla

iOS'ta eylem düğmelerini gösteren görsel

Bu kılavuz yalnızca push bildirimleri için geçerlidir. Uygulama içi mesajlar için Uygulama İçi Mesajlar: Tıklama Eylemleri Nasıl Eklenir bölümüne bakın.
Eylem Düğmeleri, tek bir push bildirimine birden fazla, etiketli eylem eklemenize olanak tanır, böylece kullanıcılar önce uygulamanızı veya sitenizi açmadan yanıt verebilir. İşletim sistemi ve cihaza bağlı olarak, kullanıcılar bildirimi genişleterek düğmeleri ortaya çıkarır (uzun basma, kaydırma + Görüntüle veya bir genişletme özelliği).

​
Eylem Düğmeleri Ekleme

Eylem Düğmelerini Şablonlar’da, kontrol panelinde mesaj oluştururken doğrudan veya API aracılığıyla yapılandırabilirsiniz.

​
Kontrol Paneli ve Şablon Kurulumu

Bir push oluştururken, Gelişmiş Seçenekler > Eylem Düğmeleri’ni açın.

iOS ve Android için eklenecek eylem düğmelerini gösteren görsel

​
API Kurulumu

  • Mobil Uygulamalar: buttons parametresini kullanın. id, text ve icon ile en fazla 3 nesne dizisi iletin.
  • Web (Chrome): web_buttons kullanın, id, text, icon ve url ile en fazla 2 nesne iletin.

​
Eylem Düğmesi Özellikleri

  • Eylem Kimliği: Belirli düğme eylemi için benzersiz bir tanımlayıcı. Tıklanan düğmenin kimliği size iletilir, böylece hangi düğmeye tıklandığını belirleyebilirsiniz. (örn. ‘accept-button’)
    • Her düğme için benzersiz olmalıdır.
    • OSNotification Payload’unda mevcuttur ve SDK Bildirim Açıldı Olay İşleyicisi içinde erişilebilir.
    • API: id özelliği
  • Etiket: Düğmenin kullanıcılarınıza göstermesi gereken metin. (örn. ‘Kabul Et’)
    • API: text özelliği
  • Simge: Düğme etiketiyle birlikte görüntülenen isteğe bağlı simge. Tüm platformlarda ve işletim sistemlerinde mevcut değildir. Ayrıntılar için aşağıdaki SSS bölümüne bakın.
    • Mobil uygulamalar, düğmeyi görüntü kaynakları içinde içermelidir. Ayrıntılar için aşağıdaki Eylem Düğmesi Simgeleri’ne bakın.
    • Web siteleri, bir simgeye geçerli, herkese açık erişilebilir bir URL kullanabilir. Her bildirim görüntülemesinde indirildiği için bunu küçük tutun. (örn. http://site.com/icon.png)
    • API: icon özelliği
  • Düğme URL’si: Bildirime tıklandığında açılacak URL. Herhangi bir URL açılmasını önlemek için 'do_not_open' iletin. (örn. ‘do_not_open’)
    • Yalnızca Web
    • API: url özelliği

​
Eylem Düğmesi Simgeleri

  • iOS, iOS 15+ için eylem düğmesi simgelerini destekler
  • Android, Android N (AKA 7) için eylem düğmesi simgelerini desteklemeyi durdurdu

​
Eylem Düğmesi Tıklamalarını İşleme

Bir kullanıcı bir düğmeye dokunduğunda, OneSignal Eylem Kimliğini uygulamanıza/sitenize iletir. Varsayılan davranışı (uygulamanızı/sitenizi açma) kullanabilir veya geçersiz kılabilirsiniz.

​
Varsayılan Davranış (Uygulama/Siteyi Aç, Ardından İşle)

  1. Uygulama/site açılır (veya web’de odaklanır).
  2. Tıklama/açma dinleyiciniz olayı Eylem Kimliğiyle alır. (Tıklama dinleyicisi ayrıntıları için mobil SDK referansı veya web SDK referansı’na bakın.)

​
Eylem Düğmesi Tıklamalarından Uygulama Başlatmayı Engelleme

​
Desteklenen Platformlar ve Sınırlar

PlatformDesteklenen DüğmelerNotlar
iOS4’e kadariOS 15+‘ta simgeler. Arka plan işleme için kategoriler gerektirir.
Android / Amazon / Huawei3’e kadarAndroid 7+‘dan itibaren düğme simgesi yok.
Web – Chrome2’ye kadarDüğmeler ve simgeler desteklenir. _osp=do_not_open desteklenir.
Web – FirefoxDüğme yok_osp=do_not_open yalnızca başlatma URL’si için çalışır.
Web – SafariDüğme yok_osp=do_not_open desteklenmez. Gerçek bir URL sağlayın.
Kullanıcıların genellikle düğmeleri görmek için bildirimi genişletmesi gerekir (örn. iOS’ta uzun basma, bazı Android OEM’lerinde kaydırma + Görüntüle).

​
Sorun Giderme

​
Düğmeler görünmüyor

  • Bildirimi genişletin (uzun basma, kaydırma + Görüntüle veya genişletme).
  • Her düğme için Eylem Kimliği ve Etiket eklediğinizi doğrulayın.
  • Platform sınırlarını kontrol edin (örn. Chrome’da yalnızca 2 düğme).

​
Bir düğmeye tıklamak mobil web’de tarayıcıyı açmıyor

Tarayıcı arka plandaysa veya tamamen kapalıysa, çoğu mobil tarayıcı (Chrome dahil) ön plana gelmez veya URL’yi açmaz, tıklama olayları hizmet çalışanında hala tetiklense bile. Bu, arka plan uygulamalarının kullanıcıyı kesintiye uğratmasını önlemek için kasıtlı tarayıcı davranışıdır.
  • Çoğu mobil tarayıcı, bir arka plan hizmet çalışanından kendini ön plana çıkarmaz. Tıklamalar hala çalışanda tetiklenir, ancak sekme açılmaz. Bu kasıtlıdır.
  • Yeni bir sekme açmak yerine sekmenin odaklanmasını bekliyorsanız, başlatma URL’sinin ve düğme URL’sinin tamamen aynı olduğundan emin olun (sondaki eğik çizgiler dahil).

​
Simgeler görünmüyor

  • Düğme simgeleri için iOS 15+ olmalıdır.
  • Android 7+ eylem düğmesi simgelerini oluşturmaz.
  • Web’de, simge URL’sinin herkese açık erişilebilir ve küçük (hızlı indirilebilir) olduğunu onaylayın.

​
Neden kapatma eylem düğmesi var?

Varsayılan olarak Windows 10’daki web push bildirimleri Kapatma düğmesini içerir. Ancak, kendi eylem düğmenizi eklerseniz, bu kapatma düğmesi kaldırılır. Yani her iki durumda da bildirim, kullanıcı onunla etkileşime girene kadar ekranda kalacaktır. Bu, kullanıcılara bildiriyle etkileşime girme şansı vermek için Google tarafından tasarlanmıştır.
Need help?Chat with our Support team or email support@onesignal.comPlease include:
  • Details of the issue you’re experiencing and steps to reproduce if available
  • Your OneSignal App ID
  • The External ID or Subscription ID if applicable
  • The URL to the message you tested in the OneSignal Dashboard if applicable
  • Any relevant logs or error messages
We’re happy to help!