Event Streams

​

Yaygın kullanım durumları

1. Müşteri yolculuğu haritalama ve kişiselleştirme: kapsamlı müşteri profilleri oluşturmak ve kampanyaları çeşitli temas noktalarında uyarlamak için olayları bir CRM veya Müşteri Veri Platformuna (CDP) aktarın.
2. Analiz ve raporlama: etkileşim modellerini veya kanallar arası uzun vadeli trendleri analiz etmek için mesaj olaylarını (örn. gönderimler, açılışlar, tıklamalar) bir veri ambarına gönderin.
3. Uyum ve düzenleyici raporlama: denetim ve uyum amaçları için tüm mesaj gönderim verilerini bir veri ambarına aktarın.
4. YZ ve tahmin modelleri: kapsamlı müşteri grupları oluşturmak ve potansiyel kayıp gösterebilecek e-posta abonelik iptalleri veya mesaj redleri gibi kayıp risklerini anlamak için mesaj olay verilerini kurum içi YZ veya tahmin modellerine gönderin.
5. Pazarlama otomasyonu: kullanıcı yolculuğundaki bir sonraki adımları otomatik olarak tetiklemek veya müşteri profillerini ve son etkinlikleri güncellemek için etkileşim olaylarını (mesaj açılışları veya tıklamalar gibi) diğer araçlara gönderin.
6. Veri parçalanması: değerli müşteri verileri genellikle ayrı araçlarda bulunur (müşteri etkileşim platformları, CRM’ler, analitik araçları ve veri ambarları gibi). Event streaming bu verileri merkezileştirmeye yardımcı olarak değerli birinci taraf verilerine görünürlüğü artırır ve daha hızlı gelir sonuçlarına olanak tanır.
7. Sistemler arası yavaş iletişim: canlı etkileşim olaylarını diğer sistemlere göndererek, toplu güncellemeler için saatler veya günler beklemek yerine bir olay meydana geldikten hemen sonra eylemleri tetikleyebilirsiniz. Bu, manuel içe aktarmalara veya veri senkronizasyonlarına bağımlılığı ortadan kaldırır.
8. Harcama şişmesi ve teknik borç: birden fazla ara aracı yönetmek yerine, OneSignal’ı doğrudan veri ambarınıza bağlayabilirsiniz. Bu, birden fazla entegrasyonu veya özel veri hattını yönetmenin maliyetli yükünü azaltır, teknik borcu azaltır ve değerli teknik kaynakları ürün ve pazarlama için korur.

​

Teknik ekibinizle nasıl ortaklık kurulur

1. Faydaları açıklayın: bu verileri kullanma stratejinizi ve bunun pazarlama kampanyalarını nasıl geliştirebileceğini, kullanıcı deneyimlerini kişiselleştirebileceğini, verileri birleştirebileceğini ve teknik borcu azaltabileceğini paylaşın.
2. Kapsamı tanımlayın: verilerin nereye gönderilmesini istediğinizi, hangi olayları izlemek istediğinizi ve tahmini veri hacmini belirleyin. Bu, uygun uç nokta kurulumunu yapılandırmaya yardımcı olacaktır.
3. Teknik belgeleme sağlayın: OneSignal’ın teknik belgelerini ve kurulum talimatlarını paylaşın. Geliştirme ekibinizin alıcı uç noktalarını ve OneSignal’daki event stream’i yapılandırması ve verilerin doğru şekilde yönlendirilmesini sağlaması gerekecektir.
4. Veri hacmi ve yönetimini tartışın: sistemlerinizin gerçek zamanlı veri akışlarını işleyebileceğini onaylayın. API işleyicisinin düşük yanıt sürelerini korumak için ek çevrimiçi işleme olmadan olayları kaydetmesi önerilir.
5. Test edin ve sorun giderin: yayına geçmeden önce her şeyin sorunsuz çalıştığından emin olmak için testler yapın.

​

Kurulum

​

Gereksinimler

• Sunucunuzun HTTP(S) sunucusuna işaret eden 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

Webhook'u Tetikle

Olay Seçimi

​

Event stream filtreleri

Olayları şablona göre filtreleme

Bir şablonun Şablon ID'sini kopyalama

• Şablon – https://dashboard.onesignal.com/apps/{APP_ID}/templates/{TEMPLATE_ID}
• Push – https://dashboard.onesignal.com/apps/{APP_ID}/notifications/{MESSAGE_ID}
• E-posta – https://dashboard.onesignal.com/apps/{APP_ID}/email/{MESSAGE_ID}
• SMS – https://dashboard.onesignal.com/apps/{APP_ID}/sms/{MESSAGE_ID}

​

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

Webhook'u Yapılandır

​

İzin verilmeyen başlıklar

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

​

Gövde

Event Stream Gövde Seçenekleri

Event Stream'in cURL Önizlemesi

​

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 }}"
  },
  "Message Data": {
    "message.id": "{{ message.id }}",
    "message.name": "{{ message.name }}",
    "message.title": "{{ message.title.en }}",
    "message.contents": "{{ message.contents.en }}",
    "template_id": "{{ message.template_id }}",
    "message.template_id": "{{ message.template_id }}",
    "message.url": "{{ message.url }}",
    "message.app_url": "{{ message.app_url }}",
    "message.web_url": "{{ message.web_url }}"
  }
}

Özel Gövde

​

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.

​

Dizeler

// Dize değerlerini tırnak içine alın
{
  "user_id": "{{ user.onesignal_id }}"
}

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

​

Sayılar ve Mantıksallar

// Sayıları veya mantıksalları tırnak içine almayın
{
  "user_score": {{ user.tags.score }}
}

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

​

Nesneler

// Nesneleri tırnak içine almayın.
{
  "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

Event Stream Günlükleri ve Metrikleri

​

Yeniden Denemeler / Devre Dışı Bırakma

​

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

• Genellikle event stream’lerin üçüncü taraf hizmetlere değil, kendi sunucularınıza bağlanmasını istersiniz.
  • Doğrudan üçüncü bir tarafa bağlanmakta yanlış bir şey olmasa da aşağıdakiler yönetilmesi daha zor olabilir: Yapılandırma/hata ayıklama daha zorlu olacaktır
• İstek hacmi OneSignal’da yönetilmeyecektir.
  • Event stream olayları, kullanıcılar yolculuğunuzdaki adımlara ulaşır ulaşmaz gönderilecektir ve bu diğer hizmetleri bunaltabilir, hız limitlerini aşabilir veya beklenmedik şekilde faturanızı artırabilir. Bu, özellikle SMS gibi bir şey için başka bir mesajlaşma kanalı kullanmaya çalışırken yaygındır. Event stream’lerin esnekliği, OneSignal’ın onlarla ne yapmaya çalıştığınızı bilmediği anlamına gelir, bu nedenle event stream isteklerini kabul eden ve ardından üçüncü taraf bağlantı limitlerini, hız limitlerini ve kuyruğu doğru şekilde işleyen kendi basit hizmetinizi oluşturmak isteyebilirsiniz.
• Birçok hizmetin genel HTTP API’leri vardır, bu da onlara bir event stream ile bağlanabileceğiniz anlamına gelir; doğru yerden başlamak için API belgelerini ve HTTP isteğinin nasıl yapılacağına dair örnekleri arayın.

​

Mesaj olay verisi sınırlamaları

​

Test Etme

URL, webhook.site'ten 'Your unique URL' ile eşleşiyor

Push mesaj olayları seçildi, ancak test için herhangi biri kullanılabilir.

webhook.site kullanarak örnek

• 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.