Skip to main content

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.
Sonunda sahip olacağınız:
  • İ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
Bu rehber OneSignal yapılandırmasına odaklanır. Rezervasyon sisteminiz ve arka ucunuz herhangi bir dil veya çerçevede uygulanabilir.

Kurulum akışı

  1. Uygulamanız bir booking_started özel etkinlik izler.
  2. Bu, kullanıcıyı bir Journey’ye dahil eder.
  3. Journey bir booking_complete etkinliği bekler ve zamanında alınmazsa takip hatırlatıcıları gönderir.
  4. 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.
  5. 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ığında
  • booking_complete — rezervasyon başarıyla tamamlandığında
Uygulama/web sitenizden doğrudan özel etkinlikler göndermek için Mobil SDK ve/veya Web SDK’deki trackEvent() yöntemini kullanın.
Örnek
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
Örnek yanıt:
JSON
Kupon Veri Beslemesi (isteğe bağlı): Kurtarma e-postanıza bir kupon kodu eklemek istiyorsanız bu isteğe bağlı beslemeyi kullanın.
  • Takma ad: coupon
  • Yöntem: GET
  • URL:
Uç nokta örneği
Örnek yanıt:
JSON
Veri Beslemesi uç noktalarınızı güvenceye alın. Üretimde, URL’ye sır gömmek yerine istek başlıklarında bir API anahtarı (örneğin x-api-key) gönderin ve bu başlığı Ayarlar > Veri Beslemeleri’nde yapılandırın.

3. E-posta şablonları oluşturma

Rezervasyon onay e-postası:

Konu:
Gövde:

Rezervasyon kurtarma e-postası

Konu:
Gövde:
Veri Beslemesi alanı eksikse boş içeriği önlemek için Liquid’de her zaman default filtreleri dahil edin.

4. Journey’yi oluşturma

  1. OneSignal’da Mesajlar > Journeys > Journey Oluştur’a gidin
  2. Giriş Tetikleyicisi’ni şu şekilde ayarlayın:
    • Özel Etkinlik: booking_started
  3. 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
  4. Dalları yapılandırın:
    • Tamamlandı: Rezervasyon onay e-postası gönder
      • Veri Beslemesi: booking_data
    • Süresi doldu: Kurtarma e-postası gönder
      • Veri Beslemesi: coupon
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_started etkinlikleri görünür
  • Harici ID’niz için booking_complete etkinlikleri 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ı

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_complete etkinliğ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