Ana içeriğe atla
Kişiselleştirme, kullanıcının adı, sepet öğeleri, hesap bakiyesi, rezervasyon detayları veya tek kullanımlık şifre gibi dinamik veriler içeren mesajlar göndermenizi sağlar. Bu rehber, aşağıdaki kriterlere göre doğru kişiselleştirme yöntemini seçmenize yardımcı olur:
  • Verilerinizin nerede bulunduğu
  • Kalıcı olup olmaması gerektiği
  • Mesajın nasıl tetiklendiği

Kişiselleştirme nasıl çalışır

OneSignal’de kişiselleştirme iki bölümden oluşur:
  1. Liquid sözdizimi – değerlerin mesajınızda nasıl işleneceğini tanımlar
  2. Bir veri kaynağı – değerin nereden geldiğini belirler
Gönderim anında, OneSignal seçilen veri kaynağını kullanarak Liquid değişkenlerinizi çözümler.
Liquid, biçimlendirme ve mantığı kontrol eder (değişkenler, döngüler, koşullar). Veri kaynağı ise hangi değerlerin kullanılabilir olduğunu belirler.
Örnek:
Liquid
Hi {{ user.tags.first_name }},

Your verification code is {{ message.custom_data.otp }}.
  • user.tags.first_name saklanan bir property’dir
  • message.custom_data.otp API custom_data alanı üzerinden iletilir

Veri kaynağı karşılaştırması

Eğer ihtiyacınız olan şey…
  • Saklanan kullanıcı verilerini yeniden kullanmak → Properties
  • Davranışa dayalı olarak Journey içinde kişiselleştirme → Custom Events
  • Tek seferlik veya hassas değerler göndermek → API custom_data
  • Teslimat anında canlı backend verisi çekmek → Data Feeds
  • Pano üzerinden toplu kişiselleştirme yüklemek → Dynamic Content CSV
Kaçınılması gereken yaygın hatalar
  • OTP’ler veya doğrulama kodları gibi tek seferlik değerler için Properties (Tags) kullanmak
  • custom_data’nın Journeys’de veya gelecekteki mesajlarda kullanılabilir olmasını beklemek
  • Custom Event özelliklerinin, olay tetiklemeli Journey girişi veya Wait Until adımı dışında kullanılabilir olduğunu varsaymak
  • Nadiren değişen statik veriler için Data Feeds kullanmak

Veri kaynakları

Data Feeds

Data Feeds, gönderim anında API’nizi çağırır ve yanıtı mesajınıza enjekte eder. Data Feeds ne zaman kullanılmalı:
  • Teslimat anında en güncel değere ihtiyacınız olduğunda
  • Veriler backend’inizde bulunduğunda
  • Değer gönderimler arasında değişebileceğinde

Data Feeds

Gönderim anında mesajlara gerçek zamanlı backend verisi çekin.

Custom Events

Custom Events, olay özelliklerini kullanarak Journeys içindeki mesajları kişiselleştirebilir. Bir olay Journey’yi başlattığında veya Wait Until koşuluyla eşleştiğinde, OneSignal bu olayı saklar ve özellikleri Liquid kullanılarak mesaj şablonlarında referans alınabilir. Custom Events ne zaman kullanılmalı:
  • Journeys ile olay tetiklemeli mesajlarda
  • Mesajın olaya özgü verileri yansıtması gerektiğinde
Yalnızca Journey girişini veya Wait Until adımını tetikleyen olaylar kişiselleştirme için saklanır. Bu anların dışında gönderilen olaylar Journey mesajlarında kullanılamaz.

Custom Event kişiselleştirme

Journeys’de olay özelliklerini kullanma rehberi.

Properties

Properties; kullanıcı Tag’leri, External ID, abonelik verileri ve uygulama düzeyindeki alanları içerir. Bunlar: Properties ne zaman kullanılmalı:
  • Değer OneSignal’de mevcut olduğunda
  • Değer kalıcı olduğunda
  • Kampanyalar genelinde yeniden kullandığınızda

Properties ile kişiselleştirme

Saklanan kalıcı property verilerine nasıl referans verileceğini öğrenin.

API custom_data

Create Message API’deki custom_data alanı, backend’inizden mesaja özel değerler göndermenizi sağlar. Bu veriler:
  • Yalnızca geçerli istek için var olur
  • OneSignal’de saklanmaz
  • Journeys’de kullanılamaz
custom_data ne zaman kullanılmalı:
  • Tek seferlik veya hassas değerler gönderirken (OTP, güvenli bağlantılar)
  • Diziler iletirken (sepet öğeleri, sipariş satırları, skor tablosu puanları)
  • İşlemsel veya API ile tetiklenen mesajlar gönderirken

API custom_data ile kişiselleştirme

Geçici kişiselleştirme verilerini nasıl ileteceğinizi öğrenin.

Dynamic Content CSV

OneSignal panosuna bir CSV dosyası yükleyin ve değerlerini Liquid kullanarak referans verin. CSV ne zaman kullanılmalı:
  • Toplu kampanyanın farklı bölümlerini her alıcı için özelleştirirken
  • Her alıcı için çeviriler veya özel veriler CSV dosyasına aktarılabilir olduğunda
  • API kullanmak istemediğinizde

Dynamic Content CSV

CSV yüklemeleri ile pano kampanyalarını kişiselleştirin.

Ayrıntılı rehberler

Adım adım uygulama detayları ve ileri düzey örnekler için aşağıdaki rehberleri kullanın.

Öğreticiler

Bu rehberler, kişiselleştirmenin pratikte nasıl uygulanacağını gösterir.