Ana içeriğe atla
OneSignal’ı veri ambarı, CRM veya veri yönetim platformu (DMP) gibi dahili sistemlerinize bağlamak, gerçek zamanlı, kişiselleştirilmiş ve ölçeklenebilir mesajlaşma için güçlü yeteneklerin kilidini açar. Salesforce, özel bir kullanıcı sistemi veya başka bir platform kullanıyor olun, entegrasyon şunları yapmanızı sağlar:
  • 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
Bir veritabanı ile OneSignal arasındaki veri akışını gösteren diyagram

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.
Platformunuz listede yoksa, OneSignal REST API aracılığıyla entegre etmek için aşağıdaki adımları izleyin.

Adım 1: External ID ile kullanıcıları tanımlayın

OneSignal’ın external_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 userexternal_id, e-posta adresi ve/veya telefon numarasıyla kullanıcı oluşturun
  • Update user — Kullanıcı özelliklerini ve abonelikleri güncelleyin
SDK kurulumu gerekmez. Backend’iniz kullanıcı verilerini doğrudan OneSignal’a gönderir. SDK kurulumu Mobil uygulamalarınız veya web siteleriniz varsa, push bildirimi tokenlarını yakalamak ve external_id’yi ayarlamak için OneSignal’ın frontend SDK’larını kullanın:
  1. Platformunuz için OneSignal SDK’yı yükleyin.
  2. Kullanıcı uygulamanızda kimlik doğruladıktan sonra kullanıcının external_id’siyle login’i çağırın.
  3. 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. Özel Etkinlikler — kullanıcı eylemleri Özel Etkinlikler, 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.
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ı
En iyisi:
  • İş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_id ve 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.
Kendi sistemlerinizde ne tutulmalı
  • 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’ın onesignal_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.