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. Bu kılavuzdaki mesajların çoğu backend tarafından, her seferinde tek bir istekle gönderilir. Bir Journey farklıdır. OneSignal kontrol panelinde oluşturulan ve kime, ne zaman mesaj gönderileceğine ve sonra ne olacağına kendisi karar veren bir dizidir. Clean Beans, saatler veya günler boyunca ilerleyen her şey ve yeni sürüm yayınlamadan değiştirilebilmesi gereken metinler ve zamanlamalar için Journeys kullanır. Clean Beans yedi Journey çalıştırır. Sonuncusunun sonundaki webhook dışında hiçbirinin kendine ait backend kodu yoktur. Uygulamanın görevi, Journeys’e üzerinde çalışabilecekleri bir şey vermektir.

Uygulamanın bir Journey’ye sağladıkları \

Bir Journey bir kişi hakkında üç şey görebilir: gönderdiği özel olaylar, etiketleri ve ait olduğu segmentler. Veritabanınızı okuyamaz. Bir Journey’nin tepki vermesi gereken her şey bu biçimlerden biriyle gelmelidir. Oturum olayları Etiketler, özel olaylar ve Conversion Metrics sayfasında ele alınır. Diğer iki olay yalnızca bir Journey başlatmak için vardır. signed_up her hesap için bir kez tetiklenir. Önce hesabın yaşı kontrol edilir, böylece uygulamayı yeni bir telefona yükleyen biri ikinci kez onboarding’den geçmez.
src/lib/onesignalSync.ts
streak_milestone, mesajın gösterebilmesi için seri uzunluğunu bir sayı olarak taşır.
src/lib/onesignalSync.ts
Bir Journey başlatan olayı yalnızca OneSignal.login() çağrıldıktan sonra gönderin. Oturum açmadan önce gönderilen bir olay, oturum açmak üzere olan kişiye değil, anonim bir kullanıcıya kaydedilir. Clean Beans, trackSignedUpOnce() fonksiyonunu aynı effect içinde login()’in hemen ardından çağırır. Bkz. SDK kurulumu ve kullanıcı kimliği.

Onboarding: hedefi olan bir dizi \

Onboarding Journey’sinin tek bir amacı vardır: yeni bir üyeyi ilk temizlik oturumuna ulaştırmak. Bu gerçekleştiği anda içindeki her şey durur.
1

Uygulama signed_up gönderir

Üye Journey’ye girer. Her üye Journey’den bir kez geçer.
2

Hoş geldin e-postası ve uygulama içi tanıtım hemen gönderilir

E-posta, başlamak için üç adımı listeler. Uygulama içi mesaj, üye uygulamayı bir sonraki açışında gösterilir.
3

1., 3. ve 6. günlerde üç push gelir

Her biri, üyenin kendi saat diliminde 10:00 ile 19:00 arasındaki zaman penceresini bekler.
4

Tamamlanan bir oturum Journey'yi bitirir

Journey’nin çıkış kuralı cleaning_session_completed olayıdır. Kimse zaten yaptığı bir şey için dürtülmez.
Kontrol paneli kurulumu. Journey’yi giriş kuralı olarak Custom Event ve olay olarak signed_up ile oluşturun. Çıkış kurallarında, bir özel olay gerçekleştiğinde çıkmayı seçin ve cleaning_session_completed olayını seçin. 03:00’te biten bir bekleme 03:00’te gönderim yapmasın diye her push’tan önce bir Time Window adımı koyun.
Önce hedefi seçin ve onu çıkış kuralı yapın. Hedefi olmayan bir dizi, istediği şeyi zaten yapmış kişilerle konuşmaya devam eder.

Oturum hatırlatma: bir olayla başla, başka bir olayla iptal et \

Biri bir temizlik oturumu başlatır ve hiç bitirmezse, yaptığı iş kaydedilmez. Bu Journey cleaning_session_started ile başlar, üç saat bekler ve bir hatırlatma gönderir. Çıkış kuralı cleaning_session_completed olduğundan, oturumu bitirmek hatırlatmayı iptal eder. Bu başlat ve iptal et ikilisi, var olan en basit kullanışlı Journey’dir. Aynı yapı terk edilmiş bir sepete, bitirilmemiş bir kayıt formuna veya hiç gönderilmemiş bir taslağa da uyar.
Zaman penceresinin sınırını kontrol edin. Pencere başlangıçta 18:00’de kapanıyordu. 16:00’da başlatılan bir oturum beklemesinin sonuna 19:00’da ulaşıyor, pencereyi kapalı buluyor ve ertesi sabah 08:00’de “you didn’t finish” mesajını alıyordu. Pencere artık 21:00’de kapanıyor. Bir mesaj yalnızca aynı gün anlamlıysa, pencere kapandıktan hemen sonra gelen birine ne olduğunu kontrol edin.

Oturum tamamlandı: olaydan kişiselleştirme \

Bir oturum bittiğinde, temizlik yapan kişi odanın adını içeren kısa bir onay alır. Oda bir etiket değildir. Journey’yi başlatan olaydan gelir.
Push template: Cleaning Session Completed
journey.first_event.properties, giriş olayının bir özelliğini okur. Tek başına user_name bir etiketi okur ve default filtresi etiketi olmayan herkesi kapsar. Bu Journey tek adımlıdır. Backend’inizden push gönderme sayfasında ev arkadaşlarına aynı oturumu bildiren push gibi bir backend gönderimi de olabilirdi. Journey olmasının nedeni, metnin böylece kontrol panelinde değiştirilebilmesi, test edilebilmesi veya kapatılabilmesidir.
Event Stream, bir Journey mesajını içindeki Liquid hâlâ duruyorken yazıldığı haliyle bildirir. Clean Beans gelen kutusu, webhook onu işlemeyi öğrenene kadar {{ journey.first_event.properties.room_name }} cleaned gösteriyordu. Bkz. Liquid’i saklamadan önce işleyin.

Odaya göre promosyonlar: bir olay özelliğine göre dallanma \

Bu Journey, hangi odanın temizlendiğine bağlı olarak farklı bir mesaj gönderir. İki şeyi gösterir: kişileri bir olay gerçekleşene kadar bekletmek ve o olayın bir özelliğine göre dallanmak. Üyeler, son yedi günde etkin olan kişilerden oluşan bir segmentten girer. İlk adım üç dallı bir Wait Until adımıdır. Her dal, belirli bir room_name ile cleaning_session_completed olayını bekler. Başka bir odadaki oturum hiçbir dalla eşleşmez ve üye beklemeye devam eder. Yeniden girişe 30 dakika sonra izin verilir, böylece Journey her yeni oturuma yanıt verir.
Bu Journey’deki push’lar uydurma temizlik ürünlerinin reklamını yapar. Yalnızca kalıbı göstermek için oradadırlar. Aynı zamanda uygulamanın bildirim ayarlarının kapsamadığı pazarlama mesajlarıdır ve gerçek bir uygulamada bunu tasarıma dahil etmek gerekir. Bkz. Journeys’in göremedikleri.

Seri dönüm noktası: sayı içeren bir olay \

Bir serinin ne zaman bir dönüm noktasına ulaştığına uygulama karar verir, çünkü yeni seriyi az önce kaydetmiştir. Uzunlukla birlikte streak_milestone gönderir ve gerisini Journey halleder.
Push template: Streak - Milestone reached
İki Journey, tek an. Bir dönüm noktası her zaman bir oturumun sonunda gerçekleşir. Bu, oturum tamamlandı Journey’sinin de gönderim yaptığı andır. Bir dakikalık bekleme olmasaydı iki push birlikte gelirdi. Birden fazla Journey aynı kullanıcı eylemiyle başlıyorsa, onları yan yana inceleyin.

Seri bozulmak üzere: zamanlama, segment kontrolü ve değişen metin \

Bir seri, oturum yapılmayan herhangi bir günün gece yarısında sona erer. Bu Journey üyeyi o akşam uyarır. Yedisi arasında en kapsamlısıdır ve her adımı ayrı bir sorunu çözer. Doğru akşama denk getirmek. Uyarı, son oturum hangi saatte olursa olsun, ondan sonraki akşama aittir. 22 saatlik bir beklemenin ardından gelen 18:00 ile 22:00 arası bir pencere her zaman oraya denk gelir. 08:00’deki bir oturum pencere adımına ertesi gün 06:00’da ulaşır ve 18:00’e kadar bekletilir. 23:00’teki bir oturum oraya ertesi gün 21:00’de ulaşır ve hemen gönderilir. Journey’nin göremediği bir ayara uymak. Clean Beans’in bildirim ayarlarında, veritabanında saklanan bir “Streak reminders” anahtarı vardır. Uygulama bunu bir etiket olarak yansıtır.
src/lib/onesignalSync.ts
Segment, streak_count değerinin 1’den büyük ve streak_reminders değerinin on olmasını gerektirir. Eski bir sürümü kullanan bir üyenin streak_reminders etiketi hiç yoktur, bu yüzden segmentin dışında kalır ve uyarıyı almaz. Metni çeşitlendirmek. Her akşam aynı cümleyi görmek, onu fark etmemeyi kolaylaştırır. Split adımı her kişiyi beş daldan birine rastgele gönderir ve her dalın kendi şablonu vardır. Dal, biri her girdiğinde yeniden seçilir, böylece bir üye farklı akşamlarda farklı ifadeler görür.
Clean Beans, Live Activities sayfasında açıklanan bir Live Activity olarak da seri uyarısı gösterir. Live Activities’i açık olan bir üye ikisini de alır. Push, Android’i ve Live Activities’i kapatmış herkesi kapsar.

Yeniden etkileşim ve Journey webhook’u \

Son Journey, uygulamayı açmayı bırakan üyelerle ilgilenir. Yalnızca bir segmentten giren tek Journey ve backend’i çağıran tek Journey budur. Yeniden girişe 30 gün sonra izin verilir. Giriş, Journey başladıktan sonra segmente katılan kişilerle sınırlıdır. Bu olmasaydı, Journey açıldığı gün zaten etkin olmayan herkes ilk push’u hemen alırdı.

Dizi bittiğinde backend’inize haber verin \

Temizlik yapmadan sona ulaşan bir üye dört mesaja yanıt vermemiştir. Beşincinin işe yaraması pek olası değildir. Clean Beans bunun yerine haneye haber verir. Bir Webhook adımı bir backend fonksiyonunu çağırır. Fonksiyon üyeyi etkin değil olarak işaretler ve hanenin sahiplerine ve yöneticilerine bildirim gönderir. Kontrol paneli kurulumu. Bu ayarlarla bir Journey webhook’u oluşturun ve Journey’nin son adımında seçin.
Journey webhook
Fonksiyon her şeyden önce gizli anahtarı kontrol eder. OneSignal bir Supabase token’ı göndermediği için fonksiyon Supabase’in token kontrolü olmadan dağıtılır. Bu yüzden endpoint ile genel internet arasındaki tek engel paylaşılan gizli anahtardır.
supabase/functions/journey-webhook/index.ts
Ardından iddiayı kendisi kontrol eder. Journey üyenin etkin olmadığını söyler, ancak Journey yalnızca uygulama oturumlarını ve olayları bilir. Üyenin temizlik yapıp yapmadığını veritabanı bilir.
supabase/functions/journey-webhook/index.ts
Ancak bundan sonra üyeyi işaretler ve bu konuda bir şey yapabilecek kişilere tek bir push gönderir.
supabase/functions/journey-webhook/index.ts
İşaret kendiliğinden temizlenir. Bir veritabanı trigger’ı, üye bir sonraki oturumunu tamamladığında işareti kaldırır, böylece uygulamanın bunu hatırlaması gerekmez.
Bir webhook adımı, bir mesaj adımının yapamadığı her şeyi yapabilir: bir kaydı güncellemek, bir destek talebi açmak, birini başka bir sistemdeki listeye eklemek. İsteği dışarıdan gelen diğer her çağrı gibi ele alın. Bir gizli anahtarı kontrol edin, bilgileri doğrulayın ve tekrarlanan bir isteği zararsız hale getirin.

Journeys’in göremedikleri \

Bu kılavuzdaki her backend gönderimi, göndermeden önce üyenin bildirim ayarlarını kontrol eder. Ayarlar uygulamanın veritabanında olduğu için bir Journey bunu yapamaz. Yansıtılmış bir ayarı olan tek şey seri uyarısıdır. Diğer Journey push’ları, uygulama için push bildirimlerini açmış herkese gider. Uygulamanızda türe göre bildirim ayarları varsa, bir Journey’nin uyması gereken her birini yansıtın.

Bilinmesi gerekenler \

  • Aynı kitleyi paylaşan Journeys’e dikkat edin. Clean Beans’te kısa bir süre aynı segment üzerinde iki yeniden etkileşim Journey’si yayındaydı ve bu, etkin olmayan her üyeyi iki dizi için de sıraya soktu. Bir segment üzerinde ikinci bir Journey’yi açmak kolay, fark etmek zordur.
  • Journey push’larına bir URL ve bir data.type verin. Kontrol panelinde oluşturulan şablonlarda varsayılan olarak ikisi de yoktur, bu yüzden bir dokunuş yalnızca uygulamayı açar. Clean Beans her Journey şablonunda ikisini de ayarlar, böylece backend’in push’ları gibi yönlendirilirler. Bkz. Derin bağlantılar ve bildirim tıklamaları.
  • Etkin bir Journey düzenlenebilir ve düzenleme, içindeki kişileri etkileyebilir. Clean Beans, çalışan Journeys’te bir zaman penceresini değiştirdi ve bir bekleme ekledi. Bu tür değişiklikleri bilinçli olarak yapın.
  • Journey mesajları gelen kutusunda yer alır. Diğer tüm push’larla aynı Event Stream üzerinden, Liquid’leri işlenmemiş halde gelirler.
  • Düğmesi bir Universal Link olan e-postada tıklama izlemeyi kapatın. İzleme, bağlantıları bir izleme alan adından geçecek şekilde yeniden yazar ve yeniden yazılmış bir bağlantı artık uygulamayı açmaz. Bkz. Uygulamayı sıradan web bağlantılarından açın.

Journeys'e genel bakış

Giriş kuralları, adımlar ve bir Journey’nin nasıl çalıştığı.

Journey ayarları

Kimin girdiği, çıktığı ve yeniden girdiği.

Journey eylemleri

Wait, Wait Until, Yes/No, Split ve Time Window.

Journey webhook'ları

Bir Journey adımından kendi sunucunuzu çağırın.

Özel olaylarla kişiselleştirme

Journey mesajlarında olay özelliklerini kullanın.

Olay odaklı Journeys

Davranışa yanıt veren Journeys tasarlayın.