Ana içeriğe atla

​
Genel bakış

OneSignal + Apache Kafka entegrasyonu, Kafka konularınızdan doğrudan OneSignal’in Özel Olaylar API’sine özel olayların otomatik senkronizasyonunu sağlar. Bu, Kafka altyapınız üzerinden akan gerçek zamanlı kullanıcı davranışına dayalı olarak otomatik Journey’leri ve kişiselleştirilmiş mesajlaşma kampanyalarını tetiklemenize olanak tanır. Satın almalar, ürün görüntülemeleri, abonelik değişiklikleri veya özel kullanıcı eylemlerini senkronize ederek push bildirimleri, e-posta, uygulama içi mesajlar ve SMS genelinde onboarding sekanslarını, yeniden etkileşim kampanyalarını, işlemsel mesajları ve hedefli promosyonları otomatik olarak tetikleyebilirsiniz.

​
Gereksinimler

  • Giden mesaj etkinlikleri için Event Streams’e erişim (Plan kısıtlamaları ve aşımlar geçerlidir)
  • Gelen etkinlik senkronizasyonu için Custom Events’e erişim (Plan kısıtlamaları ve aşımlar geçerlidir)
  • Güncellenmiş Hesap Planı (ücretsiz uygulamalarda mevcut değildir)

​
Apache Kafka

  • Kafka Cluster (Apache Kafka, Confluent veya bulut tarafından yönetilen)
  • Olay verisi içeren Konular
  • Kimlik doğrulama kimlik bilgileri (SASL/SCRAM, SSL veya API anahtarları)
  • Kafka broker’larına Ağ erişimi
  • JSON formatında Olay verisi

​
Kurulum

​
Kafka izinlerini yapılandırma

OneSignal’in Kafka konularınızdan olayları tüketmesi gerekir. Tam kurulum, Kafka yapılandırmanıza bağlıdır:
1

Bağlantı ayrıntılarını toplayın

Kafka kümeniz hakkında aşağıdaki bilgileri toplayın:
  • Bootstrap Sunucuları: Kafka broker uç noktaları
  • Güvenlik Protokolü: PLAINTEXT, SASL_PLAINTEXT, SASL_SSL veya SSL
  • Kimlik Doğrulama: Kullanıcı adı/şifre, sertifikalar veya API anahtarları
  • Konu Adları: Olay verisi içeren konuların listesi
2

Tüketici kimlik bilgilerini oluşturun

OneSignal’in Kafka konularınıza erişmesi için kimlik bilgileri oluşturun:SASL/SCRAM kimlik doğrulaması için:
# Olay konularına okuma erişimi olan bir kullanıcı oluşturun
kafka-configs --bootstrap-server localhost:9092 \
  --alter --add-config 'SCRAM-SHA-256=[password=onesignal-password]' \
  --entity-type users --entity-name onesignal-consumer
ACL tabanlı yetkilendirme için:
# Konulara ve tüketici grubuna okuma erişimi verin
kafka-acls --bootstrap-server localhost:9092 \
  --add --allow-principal User:onesignal-consumer \
  --operation Read --topic your-event-topic

kafka-acls --bootstrap-server localhost:9092 \
  --add --allow-principal User:onesignal-consumer \
  --operation Read --group onesignal-consumer-group
3

Konu erişimini doğrulayın

OneSignal’in olay konularınıza erişebileceğini test edin:
kafka-console-consumer --bootstrap-server localhost:9092 \
  --topic your-event-topic \
  --from-beginning \
  --max-messages 5

​
OneSignal Kafka bağlantısını yapılandırma

1

Entegrasyonlara gidin

OneSignal’da, Veri > Entegrasyonlar’a gidin ve Entegrasyon Ekle’ye tıklayın.
2

Apache Kafka'yı seçin

Mevcut entegrasyonlar listesinden Apache Kafka’yı seçin.
3

Bağlantı ayrıntılarını girin

Kafka bağlantı bilgilerinizi sağlayın:
  • Bootstrap Sunucuları: Virgülle ayrılmış broker uç noktaları
  • Güvenlik Protokolü: Kümenizin güvenlik yapılandırması
  • Kullanıcı Adı/Şifre: SASL kimlik bilgileri (uygulanabilirse)
  • Konu Adları: Olay verinizi içeren konular
  • Tüketici Grubu: OneSignal için benzersiz grup kimliği
4

Bağlantıyı test edin

OneSignal’in Kafka kümenize bağlanabileceğini ve olayları tüketebileceğini doğrulamak için Bağlantıyı Test Et’e tıklayın.

​
Etkinlik veri eşleştirme

verilerinizi OneSignal’ın özel etkinlik formatına eşleştirin:
OneSignal AlanıAçıklamaGerekli
nameevent_nameEtkinlik tanımlayıcıEvet
external_iduser_idKullanıcı tanımlayıcıEvet
timestampevent_timestampEtkinliğin gerçekleştiği zamanHayır
propertiesevent_dataHayır

​
Olay Veri Şeması

Kafka olay mesajlarınız JSON formatında olmalı ve OneSignal özel olay yapısına eşlenen alanları içermelidir:
Kafka Olay AlanıOneSignal Olay AlanıAçıklama
event_type