
Haftalık rapor: hane toplamları, sizin haftanız ve liderlik tablosu.
Hane başına bir istek, kişi başına kişiselleştirme \
Fonksiyon hane başına bir istek gönderir. External ID ile anahtarlanmış birusers nesnesi de dahil olmak üzere tüm verileri custom_data içinde iletir. Şablon daha sonra işlediği kişi için doğru girişi seçer.
supabase/functions/weekly-report/index.ts
email-templates/weekly-report.html
user bu kişinin istatistiklerini tutar ve doğrudan message.custom_data içinden okunan her şey hane tarafından paylaşılır.
email-templates/weekly-report.html
İkinci Liquid örneği, mantığı tablo işaretlemesi olmadan göstermek için şablondan sadeleştirilmiştir.
Boyut sınırı içinde kalın \
E-posta içincustom_data 10 KB ile sınırlıdır. Büyük bir hane bunu aşabilir, bu yüzden fonksiyon yükü ölçer ve gerekirse liderlik tablosunu kısaltır.
supabase/functions/weekly-report/index.ts
Zamanlama ve tercihler \
Haftalık bir zamanlama, push hatırlatıcılarıyla aynıpg_cron kalıbını 0 9 * * 0 ifadesiyle kullanarak fonksiyonu her pazar 09:00 UTC’de çağırır. Yalnızca Weekly Email Summary seçeneğini açmış kullanıcılar dahil edilir.
Kontrol paneli kurulumu. Messages > Templates bölümünde bir e-posta şablonu oluşturun, HTML’yi yapıştırın ve şablon kimliğini backend’inizin gizli anahtarlarına kopyalayın. custom_data yalnızca bir şablonla çalışır, bu yüzden template_id zorunludur.
Alternatif: Data Feeds \
Kişiye özel verileri bir e-postaya almanın ikinci bir yolu vardır ve Clean Beans bunu kullanmamayı seçti. Bazı uygulamalar için daha uygun olduğundan bu yöntemi anlamak faydalıdır.custom_data ile backend’iniz gönderim yaparken verileri OneSignal’a iter. Bir Data Feed ile OneSignal, her e-posta gönderildiği anda verileri API’nizden çeker. Gönderimin kendisini backend’iniz değil bir Journey başlatır.
Bu alt bölümdeki örnekler açıklama amaçlıdır. Haftalık raporun bir Data Feed ile nasıl oluşturulacağını gösterirler. Uygulamadan alınmamıştır.
1
Bir kişinin haftasını döndüren bir uç nokta açın
Bir backend fonksiyonu bir kullanıcı kimliği alır ve o kullanıcının istatistiklerini ve hanesinin liderlik tablosunu JSON olarak döndürür.
Response from your API
2
Data Feed'i kontrol panelinde oluşturun
Settings > Data feeds bölümünde feed’e bir takma ad verin ve onu uç noktaya yönlendirin. URL ve başlıklar Liquid kabul eder, böylece alıcının External ID’si iletilebilir.
Data Feed configuration
3
Feed'i e-posta şablonuna bağlayın ve ondan okuyun
Şablonda değerler
data_feed ve ardından takma addan gelir.Email template
4
Yinelenen bir Journey'den gönderin
İlk adımı pazar sabahı zaman aralığı olan ve bir yeniden giriş kuralına sahip bir Journey, şablonu her hafta gönderir. Backend’inizde hiçbir zamanlama veya gönderim kodu bulunmaz.
Hangisi kullanılmalı \
Gönderme kararını zaten backend’iniz veriyorsa
custom_data seçin. Haftalık raporda durum budur. Backend bir zamanlamayla çalışır, hangi hanelerin izin verdiğini bilir ve tüm rakamlar elindedir, bu yüzden verileri iletmenin ek bir maliyeti yoktur. Tek istek tüm haneyi kapsar, korunacak bir uç nokta yoktur ve bir hata kendi günlüklerinizde görünür. Bunun bedeli, zamanlama ve kitlenin kodda yaşaması ve yükün sabit bir boyut sınırı olmasıdır.
Gönderim bir Journey’ye aitse Data Feed seçin. Bir Journey, birine ne zaman mesaj göndereceğine kendisi karar verir: bir olaydan günler sonra veya bir bekleme koşulu karşılandığında. Backend’iniz o anda veri sağlamak için orada değildir. Data Feed bu boşluğu doldurur ve mesajlaşmayı yöneten kişilerin dağıtım yapmadan zamanlamayı değiştirmesine, bir dal eklemesine veya varyantları test etmesine olanak tanır. Bunun bedeli, API’nizin alıcı başına bir kez çağrılması ve yaklaşık çeyrek saniyede yanıt vermesi gerekmesi, her şablonun yalnızca bir feed kullanabilmesi ve başarısız bir çağrının o kişinin sessizce hiçbir şey almaması anlamına gelmesidir.
Clean Beans için belirleyici etkenler basitti. Backend’de veriler ve zamanlama zaten vardı, liderlik tablosu hane tarafından paylaşıldığından tek bir istek kişi başına bir çağrıdan çok daha ucuzdu ve tercihler uygulamanın veritabanında saklandığından backend bunları doğrudan kontrol edebiliyordu.
custom_data ile kişiselleştirme
Boyut sınırları ve Liquid erişim kalıpları.
Data feeds
Journey e-postalarına ve SMS’lerine canlı veri çekin.
Liquid söz dizimini kullanma
Filtreler, döngüler ve koşullar.