Event Streams

• Push mesaj olayları (gönderildi, alındı, tıklandı, başarısız, abonelik iptal edildi)
• E-posta olayları (gönderildi, açıldı, tıklandı, geri döndü, abonelik iptal edildi vb.)
• SMS olayları (gönderildi, başarısız, abonelik iptal edildi vb.)
• Uygulama içi mesaj olayları (gösterim, tıklandı vb.)
• Canlı Aktivite olayları (gönderildi, teslim edildi, onaylanmış teslimat, başarısız, abonelik iptal edildi, tıklandı)

​

Yaygın kullanım durumları

• Etkileşim verilerini merkezileştirin — Çapraz kanal etkinliğinin (açılışlar, tıklamalar, geri dönüşler) bağlantısız araçlar arasında dağılmak yerine tek bir yerde olması için olayları bir CRM, CDP veya veri ambarına aktarın.
• Analiz, raporlama ve uyumluluk — Trend analizi, denetim veya düzenleyici kayıt tutma için her mesaj olayını bir ambara kaydedin.
• Etkisizleşmeyi izleyin — Erken aşamada elde tutma risklerini tespit etmek için abonelik iptallerini, geri dönüşleri ve redleri kendi sistemlerinizde takip edin.
• Harici iş akışlarını tetikleyin — Bir kullanıcı mesajı açtığında veya tıkladığında diğer araçlarda otomasyonları başlatın (örn. lead skorunu güncellemek, takip dizisi başlatmak).
• Toplu senkronizasyonları ve ekstra entegrasyonları değiştirin — Olaylara gerçek zamanlı olarak tepki verin ve OneSignal’ı doğrudan hedefinize bağlayarak ara araçları ve bakım maliyetini azaltın.

​

Teknik ekibinizi başlatmak

1. Bir hedef ve kapsam üzerinde karar verin — Olayların nereye gitmesi gerektiğini (kendi API’niz, bir veri ambarı, bir CDP vb.), hangi olay türlerini akıtacağınızı (push, e-posta, SMS, IAM, Canlı Aktivite) ve uç noktanın uygun boyutta olması için bir mesaj hacmi tahmini üzerinde anlaşın.
2. Bir HTTP uç noktası oluşturun — POST isteklerini kabul eden, kamuya açık erişilebilir bir uç nokta oluşturun veya yapılandırın. Yanıt sürelerini düşük tutmak için ağır işlem olmadan olayları hızlıca kaydetmelidir. Performans beklentileri ve uç noktanın geride kalması durumunda neler olacağı için bkz. Yeniden Denemeler / Devre Dışı Bırakma.
3. OneSignal’da Event Stream’i yapılandırın — Veri > Event Streams’de olayları seçin, URL ve kimlik doğrulama başlıklarını ayarlayın ve Liquid sözdizimi ile Event Streams Verileri alanlarını kullanarak JSON gövdesini tanımlayın.
4. Uçtan uca test edin — Üretim uç noktanıza geçmeden önce payload biçimini ve başlıkları doğrulamak için webhook.site kullanın (bkz. Test Etme).

​

Kurulum

• Kamuya açık erişilebilir bir HTTP(S) uç noktası için geçerli bir URL veya IP adresi
• URL’ler ve IP adresleri genel olarak yönlendirilebilir olmalıdır
• Alan adları tanınmış bir üst düzey alan adı içermelidir (örn. “.com”, “.net”)

​

Olay Seçimi

​

Event stream filtreleri

​

Event Stream’i Yapılandırma

​

Kimlik Doğrulama Başlıkları

• Authorization Başlığı: Bir Authorization başlığı ekleyin, burada YOUR_TOKEN sisteminiz veya 3. taraf tarafından şu şekilde sağlanır:
  • Basic {{YOUR_TOKEN}}
  • Bearer {{YOUR_TOKEN}}
  • ApiKey {{YOUR_API_KEY}}
• Özel Başlıklar: Aşağıdaki gibi özel başlıklar da ekleyebilirsiniz:
  • X-API-Key: {{YOUR_API_KEY}}

​

Yapılandırmanızı Test Etme

​

İzin verilmeyen başlıklar

• content-length
• referer
• metadata-flavor
• x-google-metadata-request
• host
• x-onesignal*

​

Gövde

​

Kişiselleştirme

​

Örnek gövde

{
  "Event Data": {
    "event.kind": "{{ event.kind }}",
    "event.id": "{{ event.id }}",
    "event.timestamp": "{{ event.timestamp }}",
    "event.datetime": "{{ event.datetime }}",
    "event.app_id": "{{ event.app_id }}",
    "event.subscription_device_type": "{{ event.subscription_device_type }}",
    "event.subscription_id": "{{ event.subscription_id }}",
    "event.onesignal_id": "{{ event.onesignal_id }}",
    "event.external_id": "{{ event.external_id }}",
    "event.data.page_name": "{{ event.data.page_name}}",
    "event.data.page_id": "{{ event.data.page_id}}",
    "event.data.target_name": "{{ event.data.target_name}}",
    "event.data.target_id": "{{ event.data.target_id}}",
    "event.data.failure_reason": "{{ event.data.failure_reason}}"
  },
  "Message Data": {
    "message.id": "{{ message.id }}",
    "message.name": "{{ message.name }}",
    "message.title": "{{ message.title.en }}",
    "message.contents": "{{ message.contents.en }}",
    "message.template_id": "{{ message.template_id }}",
    "message.url": "{{ message.url }}",
    "message.app_url": "{{ message.app_url }}",
    "message.web_url": "{{ message.web_url }}"
  }
}

​

JSON’da Liquid Sözdizimi Kullanma

• Dizeler → Mutlaka tırnak içine alınmalıdır.
• Sayılar → Tırnak içine alınmamalıdır.
• Nesneler → Tırnak içine alınmamalıdır.

{
  "user_id": "{{ user.onesignal_id }}"
}

{
  "user_id": {{ user.onesignal_id }}
}

{
  "user_score": {{ user.tags.score }}
}

{
  "user_score": "{{ user.tags.score }}"
}

{
  "user_data": {{ user.tags }}
}

{
  "user_data": "{{ user.tags }}"
}

1. Doğrudan Dil Kontrollerini Kullanın: Daha iyi uyumluluk için koşullarda her zaman user.language’ı doğrudan kontrol edin, userLang gibi değişkenlerde değil.
2. Basit Başlayın: Temel ifadelerle başlayın, ardından kademeli olarak karmaşıklık ekleyin.
3. Aşırı İçiçe Geçmeden Kaçının: Ayrıştırma sorunlarını önlemek için koşulları düz tutun.
4. Önce Temel Noktalama İşaretlerini Test Edin: Özel karakterler kullanmadan önce basit cümleler ve noktalama işaretleriyle başlayın.
5. Geri Dönüşler Kullanın: Eksik çeviriler durumunda varsayılan bir dil (örn. İngilizce) sağlayın.
6. Standart Anahtarlara Bağlı Kalın: Güvenilirlik için content/title/en gibi standart OneSignal anahtarlarını kullanın.

​

Sonuçlar ve Hata Ayıklama

​

Yeniden Denemeler / Devre Dışı Bırakma

1. Uygulama ve kuruluş yöneticileri, başarısızlık hacmi önemli hale geldiğinde (devre dışı bırakmadan önce) ve stream devre dışı bırakıldığında tekrar e-posta alır.
2. Panodaki Event Streams dizin sayfasında da bir banner görünür.
3. Temel sorunu düzeltin, Günlükler sekmesi veya webhook.site ile test edin ve stream’i yeniden etkinleştirin.

• Olayları hızlıca kaydedin — Ağır satır içi işleme olmadan gelen olayı bir kuyruğa veya veri deposuna yazın.
• Yavaş yanıtlardan ve 429’lardan kaçının — Tutarlı yavaş yanıt süreleri veya hız sınırı yanıtları, olayların birikmesine neden olur ve bu OneSignal’ın stream’i devre dışı bırakmasına yol açar.
• Gönderim hacminize göre boyutlandırın — 100k mesaj gönderirseniz, seçilen her olay türü başına 100k olaya kadar bekleyin. Planınızın mesaj hacmini gözden geçirin ve buna göre hazırlık yapın.

​

Başarı İçin İpuçları

• Stream’leri önce kendi sunucularınıza yönlendirin. Doğrudan bir üçüncü taraf API’ye bağlanabilirsiniz, ancak alıcı ucu kontrol etmediğinizde hata ayıklama, hız sınırı yönetimi ve hacim yönetimi daha zordur.
• Üçüncü taraflara iletmeden önce tampon uygulayın. OneSignal, kullanıcılar olayları tetiklediği kadar hızlı gönderir — büyük bir gönderim, harici hız limitlerini aşan veya maliyetleri artıran (özellikle SMS sağlayıcılarıyla) bir patlama üretebilir. Olayları kabul eden, kuyruğa alan ve kontrol ettiğiniz bir hızda harici API’lere ileten hafif bir hizmet oluşturun.
• Üçüncü taraf API belgelerini kontrol edin. Birçok hizmet, event stream ile hedefleyebileceğiniz genel HTTP API’leri sunar. Stream’inizi yapılandırmadan önce kimlik doğrulama, kabul edilen payload biçimi ve hız sınırları hakkındaki belgelerini arayın.

​

Mesaj olay verisi sınırlamaları

​

Test Etme

• Host: isteğin geldiği IP adresi. Olası IP’lerin bir listesi için REST API genel bakış’a bakın.
• Request Content: event stream’in gövdesi içinde gönderilen veriler.