Kişiselleştirme nasıl çalışır
Liquid sözdizimini kullanarak mesajlara, şablonlara, Journey Webhook’larına ve Event Streams’e özel veriler ekleyebilirsiniz. Veriler şu kaynaklardan elde edilebilir:- Data feeds: API’lerinizden gerçek zamanlı veriler.
- Custom Events: Journey mesajlarını kişiselleştirmek için gerçek zamanlı kullanıcı olayları.
- Properties & Tags: Yerleşik kullanıcı, journey, mesaj, şablon, uygulama veya org değerleri.
- API:
custom_data: Create Message API’mize doğrudan ilettiğiniz özel veriler. - Dynamic content: Pano yüklemeleri yoluyla CSV tabanlı kişiselleştirme.
Temel hususlar
Kişiselleştirme, kullanıcıların uygulamanızla daha derin bağlantı kurmasına yardımcı olarak potansiyel olarak etkileşimi ve geliri artırır. Yaygın örnekler, kişinin adını veya belirli bilgileri (terk edilmiş sepet öğeleri gibi) bir mesaja koymaktır, ancak kullanım durumları sonsuzdur. Amaç nedir? Mesajda ne göndermek istiyorsunuz? Örnekler:- Ad veya ID gibi bir kullanıcı özelliği ekleyin
- Fatura veya OTP gösterin
- CSV’den dinamik içerik gönderin
- Veriler OneSignal’de bir özellik veya etiket olarak mı saklanıyor?
- Veriler kendi veritabanınızda mı saklanıyor?
- Backend’inizden OneSignal’e veri aktarmanız gerekiyor mu?
- Tek seferlik mesajlar: Mesajı sunucunuzdan mı yoksa OneSignal panosu üzerinden mi göndermek istiyorsunuz?
- Yinelenen mesajlar: Journeys veya diğer otomatik iş akışlarını mı kullanıyorsunuz?
- Amaç: Bir kullanıcının giriş yapmasına yardımcı olmak için bir kerelik şifre gönderin.
- Veriler:
- Backend’inizde saklanan OTP.
- OneSignal’de etiket olarak saklanan kullanıcı adı.
- OneSignal’de özellik olarak saklanan External ID.
- Gönder:
- REST API’mizi kullanarak sunucunuzdan.
- Journeys kullanarak otomatik iş akışından.
Bu örneğin ayrıntılı bir açıklaması Verification, Magic Link, & OTP örnek öğreticisi’nde mevcuttur.Aşağıda daha fazla Tutorial örneklerine bakın.
Veri kaynakları
Kişiselleştirme için mevcut seçenekler.Dinamik İçerik
Kişiselleştirme hakkındaki bu mevcut kılavuz, mesajlarınıza, şablonlarınıza, Journey’lerinize ve Event Streams’inize dinamik içerik eklemeyi açıklar. OneSignal ayrıca kendi veritabanınızdaki verilere dayalı olarak mesajları özelleştirmek için bir CSV verisi yükleme yöntemi sunar. Daha fazla ayrıntı için Dynamic Content’e bakın.Veri beslemeleri
Data Feeds, gönderim zamanında API’lerinizden doğrudan mesajlara gerçek zamanlı veri çekmenin bir yoludur. Sadece bir şablonu veri kaynağınıza bağlayın ve verileri sunucunuzdan çekip mesaja enjekte edeceğiz.Özel Olaylar
Journeys’de kullanılan Şablonlar içinde Custom Events’e referans verin. Journey yapılandırmasına bağlı olarak, kullanıcı adına bir veya daha fazla Custom Event saklayabilir. Bu saklanan olayların özelliklerini görüntülemek veya olaylara dayalı olarak mesajınızın bölümlerini koşullu olarak görüntülemek için Liquid sözdizimini kullanabilirsiniz.- Olay tetiklemeli Journey’ler, kullanıcının Journey’ye girmesine neden olan olayı saklayacaktır
- Wait Until düğümlerini kullanan herhangi bir Journey, bir koşulla eşleştiklerinde Custom Events’i saklayacaktır.
- Custom Event Özellikleri
- Örnek Custom Event Yapısı
- Şablonlarda Olayları Kullanma
journey.first_event
Olay tetiklemeli Journey’ler için bu, her zaman kullanıcının Journey’ye girmesine neden olan olay olacaktır.Journey’nin giriş kuralı olay tetiklemeli değilse, bu bir Wait Until koşulu tarafından eşleştirilen ilk olay olacaktır.
journey.last_event
Saklanan en son Custom Event. Sadece bir saklı custom event varsa,
first_event ve last_event aynı şeyi döndürecektir.journey.event.most_recent_event_name
Belirli bir ada sahip en son olay (
most_recent_event_name’i referans vermek istediğiniz olayın adıyla değiştirin). Aynı olay birden fazla kez kullanılırsa, bu en son örneği döndürecektir. Örnek: purchase.Özel karakterler için (örn. boşluklar), olay adı alfasayısal olmayan karakterler içeriyorsa hash notation kullanın. Örneğin, olay adı “order status” ise,
journey.event["order status"] ile referans verebilirsiniz.journey.all_events
Kullanıcı için bu Journey için saklanan tüm olayların bir dizisini, alındıkları sırayla sağlar. Bunların üzerinde yinelemek için for döngüleri kullanabilirsiniz.
first_event ve last_event, sırasıyla all_events[0] ve all_events[-1] için kısayoldur.Özellikler
OneSignal’de kaydedilen önceden tanımlanmış alanlar.Özellikler, Uygulama İçi Mesajlar veya Live Activities içinde değiştirmek için kullanılamaz.
Kullanıcı & Abonelik özellikleri
Verilere erişmeniz gereken yere göre sağlanan adımları izleyin.- Mesajlar ve şablonlarda mevcut özellikler
- Journey Webhook'larda ve Event Streams'de mevcut özellikler
Mesajlarda ve şablonlarda Subscription düzeyindeki özelliklere erişmek için Kullanıcı A için
subscription nesnesini kullanın. Etiketlere anahtar adı üzerinden doğrudan da erişilebilir. Örneğin:first_name: Jon ve level: 5, Kullanıcı B için first_name: Jeff ve level: 100 etiketleriniz varsa, her biri mesajda kendi adını ve seviyesini görecektir. Aksi takdirde varsayılan değerleri göreceklerdir.subscription.external_id
Subscription ile ilişkili External ID.
subscription.email
Mesajın gönderildiği e-posta Subscription’ının e-posta adresi.
subscription.phone_number
Mesajın gönderildiği SMS Subscription’ının telefon numarası.
subscription.language
Kullanıcının dil kodu.
subscription.unsubscribe_token
Unsubscribe email with token API ile kullanılan token.
liquid
Journey özellikleri
journey nesnesi, Journey adını izlemek veya Journeys’de kullanılan Şablonlar içinde Custom Events’e referans vermek için yararlıdır.
journey.name
Journey’nin adı.
JSON
Mesaj özellikleri
message nesnesi, backend’inizden gönderilen custom_data’ya erişmek veya Event Streams ile mesajın özelliklerini izlemek için yararlıdır.
message.id
OneSignal mesaj ID’si.
JSON
message.name
Mesajın adı.
JSON
message.template_id
OneSignal şablon ID’si.
JSON
Şablon özellikleri
template nesnesi, mesajı göndermek için kullanılan Template hakkındaki ayrıntılara erişmek için yararlıdır.
template.id
OneSignal şablon ID’si.
JSON
template.name
Şablonun adı.
JSON
OneSignal özellikleri
app ve org nesneleri, mesajı gönderen App ve Organization hakkındaki ayrıntılara erişmek için yararlıdır.
app.id
OneSignal App ID.
JSON
app.name
OneSignal App’in adı.
JSON
org.id
OneSignal Organization ID.
JSON
org.name
OneSignal Organization’ın adı.
JSON
API custom_data
Backend’inizden custom_data ve Create message API’mizi kullanarak doğrudan kişiselleştirme ekleyin.
Adımlar:
- Bir template oluşturun
{{ message.custom_data.key }}formatıyla Liquid Syntax kullanıncustom_datanesnesi vetemplate_idile API isteği gönderin
Örnek: Düz JSON
Template
API Request
Müşteri şunu görür:
- “Widget için faturanız hazır.”
- Son URL:
https://your-domain.com/invoice=463246732
Örnek: Dizi verileri
Template
API Request
Müşteri şunu görür:
- “Sweater’ınız sizi bekliyor!”
- Görsel:
https://.../sweater.png
Örnek: Toplu kişiselleştirme
Tek bir istekte birçok kullanıcı için tek bir mesajı kişiselleştirmek için:Template
API Request
Müşteri şunu görür:
- “Merhaba John, 150 puanınız var. Seviyeniz Gold.”
- “Merhaba Sarah, 200 puanınız var. Seviyeniz Platinum.”
Öğreticiler
Doğrulama, Magic Link ve OTP örnek öğreticisi
Doğrulama e-postaları, SMS ile magic link’ler, Tek Seferlik Şifreler veya özel URL’ler gönderin.
Terk edilmiş sepet içeriği
Terk edilmiş sepet veya lider tablosu gibi kullanıcılara veri listeleri gönderin.
İşlemsel mesajlar
Herhangi bir kanal üzerinden herhangi bir türde işlemsel mesaj gönderin.
Uygulama içi mesaj örnekleri
Etiketlere dayalı kişiselleştirilmiş uygulama içi mesajlar görüntüleyin.