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

# Veri ambarı, DMP ve CRM entegrasyonu

> CRM, veritabanı veya DMP'nizi OneSignal ile entegre ederek kişiselleştirilmiş, gerçek zamanlı bildirimler tetikleyin ve kullanıcı mesajlaşma verilerini ölçekte senkronize edin.

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](./journeys-overview) tetikleyin
* OneSignal'ın mesajlaşma altyapısından yararlanırken dahili sisteminizi gerçek kaynağı olarak kullanın

<Frame caption="Veritabanı entegrasyonu">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3a0f52f88c855832e2f2185aa456925c300ed7c2d13446f52802cbda474c3570-Screenshot_2024-10-08_at_15.27.28.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=4887fb763f121365fbdf803e3b298d3b" alt="Bir veritabanı ile OneSignal arasındaki veri akışını gösteren diyagram" width="747" height="537" data-path="images/docs/3a0f52f88c855832e2f2185aa456925c300ed7c2d13446f52802cbda474c3570-Screenshot_2024-10-08_at_15.27.28.png" />
</Frame>

***

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

<Card title="Entegrasyonlar" icon="plug" href="./integrations">
  CRM'ler, veri ambarları, analitik araçlar ve daha fazlasıyla tüm mevcut OneSignal entegrasyonlarına göz atın.
</Card>

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`](./users)'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](./mobile-sdk-reference#addobserver-push-subscription-changes) 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 user](/reference/create-user) — `external_id`, e-posta adresi ve/veya telefon numarasıyla kullanıcı oluşturun
* [Update user](/reference/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](./mobile-sdk-setup)'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](./add-user-data-tags), segmentasyon ve [mesaj kişiselleştirme](./message-personalization) 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.

* [Update user](/reference/update-user) API'si veya frontend SDK'larımız aracılığıyla etiketleri ayarlayın
* Etiketler, siz güncelleyene veya kaldırana kadar kullanıcıda kalır
* [Segmentler](./segmentation) oluşturmak ve [mesaj içeriğini kişiselleştirmek](./message-personalization) için etiketleri kullanın

**Özel Etkinlikler** — kullanıcı eylemleri

[Özel Etkinlikler](./custom-events), `completed_purchase`, `viewed_page` veya `subscription_expired` gibi bir kullanıcının gerçekleştirdiği eylemleri temsil eder. Otomatik [Journeys](./journeys-overview)'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](./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](/reference/csv-export)** — Periyodik senkronizasyon veya geçişler için abonelik verilerinin toplu dışa aktarımı.
* **[View messages API](/reference/view-messages)** — 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ı](./import) kullanın.
* **[Hız sınırlarına](/reference/rate-limits) 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](./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.

<Tabs>
  <Tab title="API">
    Anlık, işlemsel mesajlaşma için [Create message](/reference/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](./transactional-messages) (ö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.
  </Tab>

  <Tab title="Etiketler ve Journeys">
    Dinamik kullanıcı segmentleri oluşturmak için [Etiketler](./add-user-data-tags) kullanın.

    Mesajları şu yollarla gönderin:

    * API aracılığıyla segmentleri veya filtreleri hedefleme
    * Dashboard üzerinden manuel gönderimler
    * [Journeys](./journeys-overview) kullanarak otomatik mesajlaşma

    En iyisi:

    * Pazarlama kampanyaları (promosyonlar, yeniden etkileşim)
    * Planlanmış veya yaşam döngüsü mesajları
    * Teknik olmayan ekipleri kampanya yürütmeye güçlendirme
  </Tab>

  <Tab title="Özel Etkinlikler ve Journeys">
    API aracılığıyla gönderilen veya [desteklenen bir warehouse entegrasyonundan](./integrations) senkronize edilen kullanıcı eylemlerine dayalı olarak [Journeys](./journeys-overview)'leri tetiklemek için [Özel Etkinlikler](./custom-events) kullanın.

    Daha fazla bilgi için [Özel Etkinlikler](./custom-events)'e bakın.
  </Tab>
</Tabs>

***

## 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](/reference/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](./add-user-data-tags) veya [Özel Etkinlikler](./custom-events) ile [Journeys](./journeys-overview)'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](./add-user-data-tags) olarak hafif kullanıcı öznitelikleri
  * Mesaj göndermek istediğiniz anahtar olayları [Özel Etkinlikler](./custom-events) olarak

<Note>
  OneSignal, [Mesaj kişiselleştirme](./message-personalization)'de ayrıntılı olarak açıklanan çeşitli mesaj kişiselleştirme yöntemlerini destekler.
</Note>

**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](./add-user-data-tags), segmentasyon ve kişiselleştirme için kullanılan kalıcı kullanıcı özellikleridir (örneğin, plan türü, dil tercihi). [Özel Etkinlikler](./custom-events), [Journeys](./journeys-overview)'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.

***

<Columns cols={2}>
  <Card title="Kullanıcılar" icon="user" href="./users">
    OneSignal kullanıcı modelini ve kimliklerin nasıl yapılandırıldığını anlayın.
  </Card>

  <Card title="Özel Etkinlikler" icon="bolt" href="./custom-events">
    Journeys'leri tetiklemek ve kullanıcı davranışını izlemek için sistemlerinizden olaylar gönderin.
  </Card>

  <Card title="Mesaj kişiselleştirme" icon="wand-magic-sparkles" href="./message-personalization">
    Etiketler, özel veriler ve dinamik içerikle mesajları kişiselleştirin.
  </Card>

  <Card title="Journeys" icon="route" href="./journeys-overview">
    Kullanıcı davranışı ve verileri tarafından tetiklenen otomatik mesajlaşma iş akışları oluşturun.
  </Card>
</Columns>
