Ana içeriğe atla
Bu sayfa, gerçek bir uygulamayı baştan sona takip eden Örnek uygulama: eksiksiz bir OneSignal entegrasyonu kılavuzunun bir parçasıdır. Uygulama, ortak yaşanan evler için bir temizlik nöbet çizelgesi olan Clean Beans’tir ve Expo (React Native) ile bir Supabase backend’i kullanılarak geliştirilmiştir. Uygulama içi mesajlar, biri uygulamayı kullanırken görünür. İçerikleri, kitleleri ve zamanlamaları OneSignal kontrol panelinde bulunur, bu yüzden yeni sürüm yayınlamadan değişebilirler. Clean Beans bunları beş iş için kullanır.

Tetikleyiciler: anı uygulamanın belirlemesine izin verin \

Tetikleyici, uygulamanın ayarladığı bir anahtar ve değerdir. Onunla eşleşecek şekilde yapılandırılmış her uygulama içi mesaj gösterilir. Her Clean Beans ekranının başlığında, değeri ekranın adı olan bir tetikleyici ayarlayan bir yardım düğmesi vardır.
src/components/HelpButton.tsx
app/(tabs)/_layout.tsx
Tek bir tetikleyici anahtarı on üç ekrana hizmet eder. Yeni bir ekran için yardım eklemek, yeni bir değere sahip bir düğme eklemek ve kontrol panelinde bir mesaj oluşturmak demektir.
Kontrol panelinin üzerinde gösterilen bir yardım katmanı uygulama içi mesajı

Kontrol panelindeki yardım düğmesine dokunmak bir yardım katmanı gösterir.

Kontrol paneli kurulumu. Messages > In-App bölümünde, tetikleyicisi help_topic is dashboard olan bir mesaj oluşturun ve bunu her ekran için tekrarlayın. Çok adımlı tanıtım turları aynı tetikleyiciyi bir karusel düzeniyle kullanır.
Kaydırılabilir kartlardan oluşan bir tanıtım turu uygulama içi mesajı

Kartlardan oluşan bir karusel olarak hazırlanmış çok adımlı bir tanıtım turu.

Özel HTML mesajları \

Yardım katmanları HTML ile yazılmıştır, bu yüzden uygulamanın tasarımıyla tam olarak eşleşir. Bir HTML uygulama içi mesajı, SDK ile OneSignalIamApi nesnesi aracılığıyla iletişim kurar. Tıklanabilir her öğe için iki kural geçerlidir:
  • Tıklamaların doğru izlenmesi için ona benzersiz bir data-onesignal-unique-label verin.
  • Bir OneSignalIamApi yöntemini çağıran bir dinleyici ekleyin. Düz bağlantılar izlenmez.
docs/iam-html/help-dashboard.html

Push izni ön istemi \

Sistem izin iletişim kutusu yalnızca bir kez gösterilebilir. Önce gösterilen bir uygulama içi mesaj, kullanıcının ne alacağını açıklayabilir ve yalnızca Enable notifications düğmesine dokunanlar sistem iletişim kutusunu görür.
Bildirimleri etkinleştirmenin faydalarını açıklayan bir uygulama içi mesaj

Bir ön istem, sistem iletişim kutusu görünmeden önce faydayı açıklar.

docs/iam-html/push-permission-prompt.html
Bir ön istem kullanıyorsanız, uygulama başlangıcındaki requestPermission() çağrısını kaldırın. Aksi halde sistem iletişim kutusu önce görünür ve ön istemin soracak bir şeyi kalmaz.

Uygulama güncelleme istemi \

Yeni bir sürüm yayınlandığında, eski sürümdeki kişiler güncelleme istemi görür. Bu mesaj uygulamada hiçbir kod gerektirmez. Kitlesi, eski bir uygulama sürümündeki kullanıcılardan oluşan bir segmenttir.
Kullanıcıdan uygulamayı güncellemesini isteyen bir uygulama içi mesaj

Yalnızca eski sürümdeki kişilere gösterilen güncelleme istemi.

Tek bir mesaj her iki platforma da hizmet eder. Komut dosyası mağazayı cihaza göre seçer ve openUrl tıklamayı izler, mağazayı açar ve mesajı kapatır.
docs/iam-html/app-update-prompt.html
Selamlama bir etiket kullanır ve etiketi olmayan kullanıcılar için bir yedek değer içerir.
docs/iam-html/app-update-prompt.html
Kontrol paneli kurulumu. App version değeri mevcut sürümünüzden küçük olan bir filtreyle bir segment oluşturun ve bunu mesajın kitlesi olarak kullanın. Her yeni sürümde filtreyi güncelleyin.
Etiket değiştirme, bir HTML uygulama içi mesajının metninde ve özniteliklerinde çalışır, ancak script etiketlerinin içinde çalışmaz.

Değerlendirme istemi: bir tıklamayı uygulamaya geri iletin \

Uygulama mağazası puanı istemek için iyi bir an, bir şey iyi gittikten hemen sonrasıdır. Clean Beans, bir temizlik oturumu bir seriyi yedi günün katına ulaştırdığında bunu ister. Bu, bir dokunuşun uygulamada kod çalıştırması gereken tek uygulama içi mesajdır, çünkü yerel puanlama sayfasını yalnızca uygulamanın kendisi açabilir.
1

Uygulama bir seri dönüm noktasında bir tetikleyici ayarlar

İstemin temizliği asla bölmemesi için oturum ekranının kapanmasını bekler ve en son hangi dönüm noktasında sorduğunu hatırlar.
src/lib/reviewPrompt.ts
2

Mesaj uygulamaya bir tıklama adı gönderir

addClickName, uygulamanın tıklama dinleyicisine bir ad iletir. Mesajı kapatmaz, bu yüzden komut dosyası mesajı hemen ardından kapatır.
docs/iam-html/review-prompt.html
3

Uygulama yerel puanlama sayfasını açar

Tıklama dinleyicisi adı kontrol eder ve sistemden sayfayı göstermesini ister.
src/lib/reviewPrompt.ts
app/_layout.tsx
Bir değerlendirme istemi uygulama içi mesajı

Değerlendirme istemi uygulama içi mesajı.

Kontrol paneli kurulumu. Tetikleyicisi ask_for_review is show olan bir HTML uygulama içi mesajı oluşturun. En fazla 17 haftada bir gösterilecek şekilde zamanlayın.
Apple puanlama sayfasını bir kullanıcıya yılda en fazla üç kez gösterir ve Google’ın da kendi sınırı vardır, bu yüzden düğmeye dokunmak bir şey gösterileceğini garanti etmez. Sayfa TestFlight derlemelerinde asla görünmez. Bu akışı bir App Store derlemesiyle test edin.

Uygulama içi tetikleyiciler

Tetikleyici türleri ve nasıl birleştikleri.

HTML uygulama içi mesajlar

Kendi HTML’nizle mesaj tasarlayın.

Uygulama içi JavaScript API'si

Tüm OneSignalIamApi yöntemleri.