> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apache Kafka

> Gerçek zamanlı kullanıcı davranışına dayalı otomatik Journey'leri ve kişiselleştirilmiş mesajlaşma kampanyalarını tetiklemek için Apache Kafka konularından OneSignal'e özel olayları senkronize edin.

export const PLATFORM_0 = "Kafka"

export const DATA_TYPE_0 = undefined

export const COLUMN_HEADER_0 = undefined

export const PROPERTIES_DESCRIPTION_0 = undefined

## 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](/docs/en/event-streams)'e erişim (Plan kısıtlamaları ve aşımlar geçerlidir)
* Gelen etkinlik senkronizasyonu için [Custom Events](/docs/en/custom-events)'e erişim (Plan kısıtlamaları ve aşımlar geçerlidir)
* [Güncellenmiş Hesap Planı](https://onesignal.com/pricing) (ü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:

<Steps>
  <Step title="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
  </Step>

  <Step title="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:**

    ```bash theme={null}
    # 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:**

    ```bash theme={null}
    # 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
    ```
  </Step>

  <Step title="Konu erişimini doğrulayın">
    OneSignal'in olay konularınıza erişebileceğini test edin:

    ```bash theme={null}
    kafka-console-consumer --bootstrap-server localhost:9092 \
      --topic your-event-topic \
      --from-beginning \
      --max-messages 5
    ```
  </Step>
</Steps>

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

<Steps>
  <Step title="Entegrasyonlara gidin">
    OneSignal'da, **Veri > Entegrasyonlar**'a gidin ve **Entegrasyon Ekle**'ye tıklayın.
  </Step>

  <Step title="Apache Kafka'yı seçin">
    Mevcut entegrasyonlar listesinden **Apache Kafka**'yı seçin.
  </Step>

  <Step title="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
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

### Etkinlik veri eşleştirme

{PLATFORM_0} {DATA_TYPE_0} verilerinizi OneSignal'ın özel etkinlik formatına eşleştirin:

| OneSignal Alanı | {COLUMN_HEADER_0} | Açıklama                       | Gerekli |
| --------------- | ----------------- | ------------------------------ | ------- |
| `name`          | `event_name`      | Etkinlik tanımlayıcı           | Evet    |
| `external_id`   | `user_id`         | Kullanıcı tanımlayıcı          | Evet    |
| `timestamp`     | `event_timestamp` | Etkinliğin gerçekleştiği zaman | Hayır   |
| `properties`    | `event_data`      | {PROPERTIES_DESCRIPTION_0}     | Hayı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`     |                      |          |