Genel Bakış
Bu eğitimde, yaygın bir rezervasyon iş akışı kuracaksınız:- Bir kullanıcı rezervasyon tamamladıktan sonra rezervasyon onay e-postası gönderin.
- Bir kullanıcı rezervasyon başlattı ancak zamanında tamamlamadıysa kurtarma e-postası gönderin.
- İki Özel Etkinlik (
booking_started,booking_complete) - Tamamlama karşı terke göre dallanan bir Journey
- Onay ayrıntıları için bir rezervasyon Veri Beslemesi
- Kurtarma teşvikleri için isteğe bağlı kupon Veri Beslemesi
Kurulum akışı
- Uygulamanız bir
booking_startedözel etkinlik izler. - Bu, kullanıcıyı bir Journey’ye dahil eder.
- Journey bir
booking_completeetkinliği bekler ve zamanında alınmazsa takip hatırlatıcıları gönderir. - Rezervasyon tamamlanırsa, OneSignal gönderim anında bir rezervasyon Veri Beslemesi çağırır ve en güncel rezervasyon ayrıntılarıyla bir onay e-postası gönderir.
- Rezervasyon bekleme penceresi içinde tamamlanmazsa, Journey son kullanma yolunu izler ve bir kurtarma e-postası gönderir.
Kurulum
Önkoşullar
Başlamadan önce sahip olduğunuzdan emin olun:- E-posta kanalı etkinleştirilmiş bir OneSignal uygulaması
- Rezervasyon ve/veya kupon verilerini JSON olarak döndürebilen bir arka uç uç noktası
- Uygulamanız, arka ucunuz ve OneSignal Harici ID arasında paylaşılan kararlı bir kullanıcı tanımlayıcısı
- Özel Etkinlikler erişimi
1. Rezervasyon etkinliklerini izleme
Aşağıdaki Özel Etkinlikleri izleyin. Bunlar uygulamanızdan (SDK’mızı kullanarak) veya arka ucunuzdan (REST API’mizi kullanarak) gelebilir. Etkinlik adları:booking_started— kullanıcı rezervasyon akışını başlattığındabooking_complete— rezervasyon başarıyla tamamlandığında
- Uygulama - Mobil ve Web
- Sunucu Tarafı
Etkinlikleri izlerken ve arka ucunuzdan veri döndürürken aynı kullanıcı kimliğini kullanın. Eşleşmeyen ID’ler, eksik kişiselleştirmenin en yaygın nedenidir.
2. Veri Beslemesi takma adları oluşturma
OneSignal’da Ayarlar > Veri Beslemeleri’ne gidin ve aşağıdaki takma adları oluşturun. Rezervasyon Veri Beslemesi: Gönderim anında en güncel rezervasyon ayrıntılarını çekmek için bu beslemeyi kullanın.- Takma ad:
booking_data - Yöntem: GET
- URL:
Uç nokta örneği
JSON
- Takma ad:
coupon - Yöntem: GET
- URL:
Uç nokta örneği
JSON
3. E-posta şablonları oluşturma
Rezervasyon onay e-postası:
Konu:Rezervasyon kurtarma e-postası
Konu:- Kupon Veri Beslemesi Kullanarak
- Kupon Veri Beslemesi Olmadan
Veri Beslemesi alanı eksikse boş içeriği önlemek için Liquid’de her zaman
default filtreleri dahil edin.4. Journey’yi oluşturma
- OneSignal’da Mesajlar > Journeys > Journey Oluştur’a gidin
-
Giriş Tetikleyicisi’ni şu şekilde ayarlayın:
- Özel Etkinlik:
booking_started
- Özel Etkinlik:
-
Bir Şu Ana Kadar Bekle adımı ekleyin:
- Koşul: Özel Etkinlik gerçekleşir
- Etkinlik adı:
booking_complete - Maksimum bekleme süresi: 10 dakika
- Sona erme yolunu etkinleştirin
-
Dalları yapılandırın:
- Tamamlandı: Rezervasyon onay e-postası gönder
- Veri Beslemesi:
booking_data
- Veri Beslemesi:
- Süresi doldu: Kurtarma e-postası gönder
- Veri Beslemesi:
coupon
- Veri Beslemesi:
- Tamamlandı: Rezervasyon onay e-postası gönder
Sona erme dalı, uygulamanızda ek mantık olmadan terk etmeyi ele almanızı sağlar. Bakın:
- Journey ayarları - Özel Etkinlik giriş ve çıkış kuralları hakkında ayrıntılar
- Journeys eylemleri - Şu Ana Kadar Bekle adımları ve sona erme dalları hakkında ayrıntılar
5. Test etme ve doğrulama
Etkinlikleri doğrulama
Uygulamanızdan veya arka ucunuzdan özel etkinlikleri tetikleyin ve onaylayın. OneSignal’da Analytics > Özel Etkinlikler’e gidin ve şunları gördüğünüzü onaylayın:- Harici ID’niz için
booking_startedetkinlikleri görünür - Harici ID’niz için
booking_completeetkinlikleri görünür
Veri Beslemelerini doğrulama
Bilinen bir kullanıcı ID’si kullanarak Veri Beslemesi uç noktalarınızı manuel olarak çağırın ve onaylayın:- 200 yanıtı döndürülür
- Tüm beklenen alanlar mevcut
E-postaları doğrulama
Journey editöründen test mesajları gönderin ve onaylayın:- Rezervasyon e-postaları gerçek rezervasyon ayrıntıları içerir
- Kurtarma e-postaları geçerli bir kupon içerir
- Hiçbir Liquid değişkeni boş işlenmez
Kişiselleştirme eksikse, Veri Beslemesi isteğindeki kullanıcı ID’sinin Journey’yi tetikleyen kullanıcıyla eşleştiğini onaylayın.
Örnek: Veri Beslemesi uygulaması
Örnek Node.js Veri Beslemesi uç noktaları
Örnek Node.js Veri Beslemesi uç noktaları
Bu örnek, rezervasyon onayı ve kurtarma Veri Beslemeleri için minimal bir Express uygulaması gösterir. JSON yanıt şekli e-posta şablonlarınızla eşleştikçe arka uç diliniz, çerçeveniz ve veri kaynağınız farklılık gösterebilir.
Rezervasyon Veri Beslemesi örneği
Kupon Veri Beslemesi örneği
Uygulama yönergeleri
- Yanıtları hızlı tutun (Veri Beslemeleri gönderim anında çağrılır)
- Her zaman öngörülebilir bir JSON yapısı döndürün
- Veri mevcut olmadığında 404 kullanın
- İstek başlıkları aracılığıyla gönderilen API anahtarıyla uç noktaları güvenceye alın
Yaygın sorunlar
E-posta boş değerler gösteriyor
- Veri Beslemesi 404 döndürdü
- JSON yanıtında alan adları değişti
- Kullanıcı kimliği uyumsuzluğu
Journey dallanmıyor
booking_completeetkinliği izlenmedi- Etkinlik adı uyumsuzluğu (büyük/küçük harf duyarlı)
- Etkinlik bekleme penceresi dışında gerçekleşti
Veri Beslemesi 401 veya 403 döndürüyor
- Eksik veya geçersiz API anahtarı
- Veri Beslemesi ayarlarında başlık yapılandırılmadı
Sonraki adımlar
- Daha gelişmiş Journey koşulları için etkinlik özellikleri (hizmet türü, fiyat) ekleyin
- Push veya SMS hatırlatıcıları gibi ek kurtarma adımları ekleyin
- Tekrarlanan kurtarma mesajlarını önlemek için Journey çıkış kuralları kullanın