- Canlı verileri kullanarak kişiselleştirilmiş, zamana duyarlı mesajlar gönderin
- Sistemler arasında kullanıcı özniteliklerini ve mesaj verilerini senkronize edin
- Sisteminizdeki kullanıcı eylemlerinden otomatik Journeys tetikleyin
- OneSignal’ın mesajlaşma altyapısından yararlanırken dahili sisteminizi gerçek kaynağı olarak kullanın

Entegrasyon kılavuzu
OneSignal, birçok popüler platformla doğrudan entegrasyonlara sahiptir. Platformunuzun desteklenip desteklenmediğini görmek için entegrasyonlar sayfasını inceleyin — destekleniyorsa, o kurulum kılavuzunu izleyin.Entegrasyonlar
CRM’ler, veri ambarları, analitik araçlar ve daha fazlasıyla tüm mevcut OneSignal entegrasyonlarına göz atın.
Adım 1: External ID ile kullanıcıları tanımlayın
OneSignal’ınexternal_id’si, OneSignal ile veritabanınız arasındaki temel bağlantıdır. OneSignal’daki her kullanıcının external_id’sini veritabanınızdaki kullanıcı kimliğiyle eşleşecek şekilde ayarlayın. Bu, zaten sahip olduğunuz tanımlayıcıları kullanarak kullanıcıları hedeflemenize, verileri senkronize etmenize ve mesajları tetiklemenize olanak tanır.
Birden fazla OneSignal uygulaması kullanıyorsanız (örneğin, iOS, Android ve web için ayrı uygulamalar), tüm uygulamalarda aynı external_id’yi ayarlamak, platformlar genelinde aynı kullanıcıyı tanımlar.
Anonim kullanıcılarınız varsa veya sistemler arasında kullanıcıları takip etmek için kararlı bir kullanıcı kimliğiniz yoksa, OneSignal’ın onesignal_id’sini veya subscription_id’sini kullanabilirsiniz. Ancak, kullanıcı kararlı ve tanımlanabilir olduğunda external_id ayarlamanızı öneririz.
onesignal_id ve/veya subscription_id, Create user API yanıtında ve Observer yöntemleri kullanılarak mobil ve web SDK’larımız aracılığıyla erişilebilir.
Yalnızca API kurulumu
OneSignal’ı yalnızca e-posta ve SMS/RCS için kullanıyorsanız (mobil uygulama veya web sitesi olmadan), kullanıcıları tamamen REST API aracılığıyla yönetebilirsiniz:- Create user —
external_id, e-posta adresi ve/veya telefon numarasıyla kullanıcı oluşturun - Update user — Kullanıcı özelliklerini ve abonelikleri güncelleyin
external_id’yi ayarlamak için OneSignal’ın frontend SDK’larını kullanın:
- Platformunuz için OneSignal SDK’yı yükleyin.
- Kullanıcı uygulamanızda kimlik doğruladıktan sonra kullanıcının
external_id’siylelogin’i çağırın. - SDK, push tokenını otomatik olarak yakalar ve kullanıcıya bağlar.
Adım 2: Kullanıcı verilerini ve olayları senkronize edin
Kullanıcı kimliği kurulduktan sonra, sisteminizden OneSignal’a iki tür veri senkronize edebilirsiniz: Etiketler — kalıcı kullanıcı özellikleri Etiketler, segmentasyon ve mesaj kişiselleştirme için OneSignal’da kullanıcı özniteliklerini saklar. Plan türü, tercih edilen dil veya kayıt tarihi gibi bir kullanıcının kim olduğunu açıklayan veriler için kullanın.- Update user API’si veya frontend SDK’larımız aracılığıyla etiketleri ayarlayın
- Etiketler, siz güncelleyene veya kaldırana kadar kullanıcıda kalır
- Segmentler oluşturmak ve mesaj içeriğini kişiselleştirmek için etiketleri kullanın
completed_purchase, viewed_page veya subscription_expired gibi bir kullanıcının gerçekleştirdiği eylemleri temsil eder. Otomatik Journeys’leri tetiklemek için kullanın.
- API’miz veya frontend SDK’larımız aracılığıyla Özel Etkinlikler gönderin
- Özel Etkinlikler etiketler gibi kalıcı değildir, ancak Journeys ve mesaj kişiselleştirmeyi tetiklemek için kullanılabilirler
Adım 3: Mesaj ve etkileşim verilerini dışa aktarın
Teslimat ve etkileşim verilerini sistemlerinize geri senkronize etmek için:- Event Streams — (Önerilen) Mesaj olaylarının (gönderildi, iletildi, tıklandı vb.) gerçek zamanlı webhook teslimatı. Olaylar gerçekleştikçe veritabanınızı senkronize tutmak için en iyisi.
- Export subscriptions CSV — Periyodik senkronizasyon veya geçişler için abonelik verilerinin toplu dışa aktarımı.
- View messages API — Mesaj geçmişini ve teslimat istatistiklerini programlı olarak sorgulayın.
Mimari öneriler
- Veritabanınızı gerçek kaynağı olarak tutun. OneSignal’ı mesajlaşma katmanı olarak ele alın — kullanıcı verilerini ve olayları OneSignal’a gönderin ve teslimat/etkileşim verilerini geri alın.
- Gerçek zamanlı güncellemeler için API’yi kullanın. Bir kullanıcı bir eylem gerçekleştirdiğinde (örneğin, bir satın alma tamamladığında), etiketi güncellemek veya özel bir etkinlik göndermek için hemen OneSignal API’sini çağırın.
- Toplu işlemler için CSV içe aktarımını kullanın. İlk ekleme veya büyük geçişler için binlerce ayrı API çağrısı yapmak yerine CSV içe aktarımını kullanın.
- Hız sınırlarına saygı gösterin. Yüksek hacimli güncellemeler için mümkün olduğunca istekleri toplu hale getirin ve üstel geri çekilme ile yeniden deneme mantığı uygulayın.
- Dönüş yolu için Event Streams kullanın. Teslimat verileri için OneSignal API’sini yoklamak yerine, mesaj olayları için gerçek zamanlı webhook’lar almak üzere Event Streams’i ayarlayın.
Veritabanınızdan mesajları tetikleme
Kullanım senaryonuza göre iki yaklaşımdan birini veya her ikisini seçerek mesajları tetikleyebilirsiniz.- API
- Etiketler ve Journeys
- Özel Etkinlikler ve Journeys
Anlık, işlemsel mesajlaşma için Create message API’sini kullanın.Kullanıcıları şu yollarla hedefleyin:
external_id- Takma adlar (örneğin,
crm_id) - E-posta veya telefon numarası
- İşlemsel mesajlar (örneğin, makbuzlar, uyarılar)
- Zamana duyarlı veya kişiselleştirilmiş bildirimler
- Bireyleri veya grupları hedefleme (çağrı başına 20.000’e kadar kullanıcı)
send_after parametresini kullanarak mesajları da zamanlayabilirsiniz.SSS
Veritabanımdan mesaj göndermek için API’yi mi yoksa Journeys’i mi kullanmalıyım?
Makbuzlar veya uyarılar gibi anlık işlemsel mesajlar için Create message API’sini kullanın. Görsel iş akışı oluşturmanın fayda sağladığı otomatik yaşam döngüsü ve pazarlama mesajları için Etiketler veya Özel Etkinlikler ile Journeys’i kullanın.OneSignal’da ve kendi sistemimde hangi verileri saklamalıyım?
Verinin amacına göre karar verin: OneSignal’da ne saklanmalı- Mesajlaşma için doğrudan kullanılan verileri saklayın:
external_idve takma adlar- E-postalar (e-posta mesajlaşma için)
- Telefon numaraları (SMS için)
- Etiketler olarak hafif kullanıcı öznitelikleri
- Mesaj göndermek istediğiniz anahtar olayları Özel Etkinlikler olarak
OneSignal, Mesaj kişiselleştirme’de ayrıntılı olarak açıklanan çeşitli mesaj kişiselleştirme yöntemlerini destekler.
- Mesajlaşmayla ilgili olmayan verileri (örneğin, tam kullanıcı profilleri, işlem günlükleri) performans, gizlilik ve kontrol için kendi sistemlerinizde tutun. Uzun vadeli analitik veya uyumluluk için OneSignal’dan mesaj geçmişini arşivleyin.
External ID’si olmayan kullanıcılara mesaj gönderebilir miyim?
Evet, ancak ekstra işlem gerektirir. OneSignal’ınonesignal_id’sini veya subscription_id’sini kullanabilirsiniz, ancak bunlar external_id’ye bağlanana kadar anonimdir. Sistemler arası tanımlamayı basitleştirmek için her kullanıcı için external_id ayarlamanızı öneririz.
Etiketler ve özel etkinlikler arasındaki fark nedir?
Etiketler, segmentasyon ve kişiselleştirme için kullanılan kalıcı kullanıcı özellikleridir (örneğin, plan türü, dil tercihi). Özel Etkinlikler, Journeys’leri tetiklemek için kullanılan tek seferlik kullanıcı eylemlerini (örneğin,completed_purchase) temsil eder. Etiketler bir kullanıcının kim olduğunu açıklar; özel etkinlikler bir kullanıcının ne yaptığını açıklar.
Kullanıcılar
OneSignal kullanıcı modelini ve kimliklerin nasıl yapılandırıldığını anlayın.
Özel Etkinlikler
Journeys’leri tetiklemek ve kullanıcı davranışını izlemek için sistemlerinizden olaylar gönderin.
Mesaj kişiselleştirme
Etiketler, özel veriler ve dinamik içerikle mesajları kişiselleştirin.
Journeys
Kullanıcı davranışı ve verileri tarafından tetiklenen otomatik mesajlaşma iş akışları oluşturun.