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

# Mixpanel

> Davranışsal cohort'ları senkronize etmek, mesaj olaylarını izlemek ve push, e-posta, SMS ve uygulama içi kanallar genelinde Kullanıcıları hedeflemek için OneSignal'i Mixpanel ile entegre edin.

OneSignal'i [Mixpanel](https://mixpanel.com) ile entegre ederek push, uygulama içi, e-posta ve SMS genelinde gerçek zamanlı, davranış tabanlı hedeflemeyi etkinleştirin. Bu uygulama düzeyindeki entegrasyon iki veri akışını destekler:

* **Mesaj olayları → Mixpanel**: Tüm kanallar için teslimat, tıklama, başarısızlık ve daha fazlasını izleyin.
* **Cohort'lar → OneSignal**: Davranış tabanlı Mixpanel cohort'larını OneSignal'de hedefleme filtreleri olarak senkronize edin.

<Warning>
  Mixpanel şu anda OneSignal'e [Özel Olaylar](./custom-events) gönderememektedir. Mixpanel olaylarını OneSignal'e yönlendirmeniz gerekiyorsa, [Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal) gibi bir üçüncü taraf bağlayıcı kullanın.
</Warning>

***

## Gereksinimler

* [Mixpanel Hesabı](https://mixpanel.com/)
* [OneSignal Ücretli Plan](https://onesignal.com/pricing)
* External ID ayarlanmış OneSignal uygulaması.

<Info>
  Bu entegrasyon kullanıcı oluşturmaz. Mixpanel'deki Kullanıcıları tanımlayıcıları eşleştirerek OneSignal'deki mevcut Kullanıcılarla eşler.
</Info>

***

## Kurulum

### OneSignal'e Mixpanel ekleyin (Çıkış)

OneSignal mesaj olaylarını Mixpanel projenize gönderir.

1. OneSignal'de **Data > Integrations > Mixpanel**'e gidin ve **Activate**'e tıklayın.

<Frame caption="OneSignal'de Mixpanel entegrasyonunu etkinleştirin">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/f5dfbab5a6c41ae816e34401b7fa5a8624e15d43f90ad723c4c7b2166dbd66de-Screenshot_2025-03-18_at_8.15.13_AM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=4c5a9ba2e4e2a2c8b2e2b2b2376253f1" alt="OneSignal Integrations page with Mixpanel selected" width="1150" height="458" data-path="images/docs/f5dfbab5a6c41ae816e34401b7fa5a8624e15d43f90ad723c4c7b2166dbd66de-Screenshot_2025-03-18_at_8.15.13_AM.png" />
</Frame>

#### Mixpanel'de

1. [Project Token](https://docs.mixpanel.com/docs/orgs-and-projects/managing-projects#find-your-project-tokens)'ınızı bulun ve OneSignal'e kopyalayıp yapıştırın.
2. [Data Residency](https://docs.mixpanel.com/docs/orgs-and-projects/managing-projects#project-details)'nizi kontrol edin. Mixpanel'in AB sunucularını kullanıyorsanız, **Send events exclusively to Mixpanel's EU Residency Server** kutusunu işaretleyin.

#### Mesaj olaylarını seçin

Mixpanel'e göndermek istediğiniz OneSignal mesaj olaylarını seçin. Bitirdiğinizde, **Activate**'e tıklayın.

<Frame caption="OneSignal'de Mixpanel ayarları">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/bc980ae-Screenshot_2024-06-04_at_10.18.59_AM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=b98514269a60a2144c1dc0334969e7d3" alt="OneSignal Mixpanel integration settings showing event selection" width="2216" height="1412" data-path="images/docs/bc980ae-Screenshot_2024-06-04_at_10.18.59_AM.png" />
</Frame>

### Mixpanel'e OneSignal ekleyin (Giriş)

Mixpanel **Integrations**'ınızda OneSignal'i ekleyin.

<Frame caption="Mixpanel'de OneSignal Entegrasyonu ekleyin">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/mixpanel-integration.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=b4e6bc1f405b2087b455b2942ce5aecd" alt="Mixpanel integrations catalog with OneSignal selected" width="2986" height="1300" data-path="images/docs/mixpanel-integration.png" />
</Frame>

**Connector Name**'i `OneSignal - APP_NAME` gibi tanımlanabilir bir şey olarak ayarlayın; burada `APP_NAME`, OneSignal'deki uygulamanın adıdır.

OneSignal **Settings > [Keys & IDs](./keys-and-ids)**'de aşağıdaki verilere ihtiyacınız olacak:

1. App ID
2. API Key

### User ID eşleştirmesi

<Warning>
  Bu adım, cohort senkronizasyonu ve olay takibinin düzgün çalışması için gereklidir.
</Warning>

OneSignal'deki **[External ID](./users)**, seçtiğiniz bir Mixpanel User ID Property (örn. `user_id`) ile eşleşmelidir. Bu özelliğin her iki sistemde de dolu olduğunu doğrulayın — cohort senkronizasyonu ve olay takibi tam bir eşleşmeye bağlıdır.

<Frame caption="OneSignal özelliklerini ayarlamak için Mixpanel'in kontrol paneli">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b5e818708efcc73ea8eb0cccb6542c205069b395978b8fa796af28d816b33356-Screenshot_2025-03-18_at_11.22.54_AM.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=c161191d039f187a20df7201d9ca71db" alt="Mixpanel OneSignal connector settings showing User ID property selection" width="864" height="900" data-path="images/docs/b5e818708efcc73ea8eb0cccb6542c205069b395978b8fa796af28d816b33356-Screenshot_2025-03-18_at_11.22.54_AM.png" />
</Frame>

Seçtiğiniz **User ID Property**'nin Mixpanel kullanıcı profil özelliklerinizde mevcut olduğunu doğrulayın.

<Frame caption="Mixpanel > Users > User Profile Properties">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4416681-small-Screenshot_2023-05-15_at_9.54.14_AM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=e89ad019a61077ae376fc92e1a1eb87a" alt="Mixpanel user profile properties list" width="521" height="1024" data-path="images/docs/4416681-small-Screenshot_2023-05-15_at_9.54.14_AM.png" />
</Frame>

Mixpanel'deki kullanıcı profil özelliği için aynı değer, OneSignal'deki External ID ile eşleşmelidir.

<Frame caption="OneSignal > Audience > Users > External ID">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e6853b59781b29ccbd264f97925830986605ec5514d02b5435c27ec896804a89-Screenshot_2025-03-18_at_10.22.25_AM.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=9a0b4237233c0492901853d72a6b1b63" alt="OneSignal user profile showing External ID" width="2764" height="686" data-path="images/docs/e6853b59781b29ccbd264f97925830986605ec5514d02b5435c27ec896804a89-Screenshot_2025-03-18_at_10.22.25_AM.png" />
</Frame>

<Warning>
  Kullanıcıları Mixpanel `$distinct_id`'ye göre OneSignal ile eşleştirirseniz, yalnızca en üstteki değerle eşleşir.

  Aşağıdaki örnekte, yalnızca `890ea9b1-9024-4fb9-a92f-152ba67dd21a` çalışır. `109768518080488203109` veya `$device:1880c06821f1b3-052354675cde95-1d525634-1fa400-1880c06821f1b3` ile eşleşemez.
</Warning>

<Frame caption="User ID Property eşleştirmesi için kullanılıyorsa Distinct ID ayarlarken dikkatli olun">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/e7b80eb-small-Screenshot_2023-05-15_at_10.07.10_AM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=ef1999c6f01a48063d98e7e2ea330052" alt="Mixpanel Distinct ID example showing multiple values" width="464" height="314" data-path="images/docs/e7b80eb-small-Screenshot_2023-05-15_at_10.07.10_AM.png" />
</Frame>

<Check>
  Bitirdiğinizde **Continue**'ye tıklayın. Artık Mixpanel'den OneSignal'e cohort'ları dışa aktarabilmeli ve OneSignal'den Mixpanel'e mesaj olaylarını toplayabilmelisiniz.
</Check>

***

## Mixpanel cohort'larını OneSignal'e dışa aktarın

Yukarıda yapılandırılan eşleşen External ID'yi kullanarak Mixpanel cohort'larını OneSignal ile senkronize edin. Dışa aktarma **Kullanıcı oluşturmaz** — her Kullanıcının OneSignal'de zaten mevcut olması gerekir.

1. Mixpanel'de bir cohort oluşturun.
2. **Options > Export to... > *OneSignal Bağlantı adı***'na tıklayın.

<Frame caption="Bir Mixpanel cohort'unu OneSignal'e nasıl dışa aktarırsınız">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/187698db55979af5f5c94d672ada1e0c8d7329d600a650e3115b77077ef99237-Screenshot_2025-03-18_at_12.04.16_PM.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=fce16e4cde30d69f3b24a947cf71c937" alt="Mixpanel cohort export menu with OneSignal destination" width="2432" height="1008" data-path="images/docs/187698db55979af5f5c94d672ada1e0c8d7329d600a650e3115b77077ef99237-Screenshot_2025-03-18_at_12.04.16_PM.png" />
</Frame>

3. Senkronizasyon sıklığını seçin ve **Begin Sync**'e basın.

<Frame caption="Mixpanel sıklık seçenekleri">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c6b36cedac01d722acaa4240225ea6d10519458682f4c2844d681b8ee34b236e-Screenshot_2025-03-18_at_12.12.06_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=5bb3a035bfb3bea7d78553e86ccb943b" alt="Mixpanel cohort sync frequency selection dialog" width="860" height="896" data-path="images/docs/c6b36cedac01d722acaa4240225ea6d10519458682f4c2844d681b8ee34b236e-Screenshot_2025-03-18_at_12.12.06_PM.png" />
</Frame>

### OneSignal Segment oluşturma

Senkronize edilen cohort, OneSignal'de bir **Mixpanel Segment filtresi** olarak görünür. OneSignal, aşağıdaki koşullar sağlandığında cohort için otomatik olarak bir Segment oluşturur:

* Mixpanel Cohort'undaki kullanıcılar OneSignal'de de eşleşen External ID ile mevcuttur.
* OneSignal'deki Segment limitinizi aşmamalısınız.

<Note>
  Mixpanel'in OneSignal'de bir Segment oluşturması için en az bir eşleşen Kullanıcı gerekir. Segment oluşturulduktan sonra, cohort'ta daha sonra kullanıcı olmasa bile OneSignal'de kalacaktır. Bu durumda, Segment kullanıcılar tekrar eklenene kadar boş olarak gösterilir.
</Note>

<Frame caption="Bir Mixpanel Cohort'undan Segment oluşturma">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7b01785ad5a5f85377bdb20e664e5d5c38280cff56373d70726621569668907d-Screenshot_2025-03-18_at_12.38.47_PM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=3ba94cf6588a4158a86e77c4a23c3e34" alt="OneSignal Segment builder using Mixpanel Cohort filter" width="1444" height="818" data-path="images/docs/7b01785ad5a5f85377bdb20e664e5d5c38280cff56373d70726621569668907d-Screenshot_2025-03-18_at_12.38.47_PM.png" />
</Frame>

***

## Mixpanel'de mesaj olaylarını izleyin

OneSignal, aşağıdaki mesaj olaylarını gerçek zamanlı olarak Mixpanel'e gönderir. **Data > Integrations > Mixpanel**'de hangi olayların gönderileceğini seçin.

Bunu test etmek için OneSignal'den kendinize bir mesaj gönderin, ardından Mixpanel'deki kullanıcı profil sayfanıza gidin. Activity Feed içinde olayların doldurulduğunu görmelisiniz.

<Frame caption="OneSignal mesaj olayları ile Mixpanel activity feed">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c344970fd85bda82f9b6bedf1700a9cbb91afd63afc9fe1e866c42e1b380770e-Screenshot_2025-03-18_at_1.59.23_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=9ca542f553f6c08a15ca99d52d68be2b" alt="Mixpanel user activity feed showing OneSignal message events" width="2420" height="1654" data-path="images/docs/c344970fd85bda82f9b6bedf1700a9cbb91afd63afc9fe1e866c42e1b380770e-Screenshot_2025-03-18_at_1.59.23_PM.png" />
</Frame>

### Mesaj olayları

| Message Event Kind (OneSignal) | Message Event Name (Mixpanel) | Event Description                                                                               |
| ------------------------------ | ----------------------------- | ----------------------------------------------------------------------------------------------- |
| Push Sent                      | Message Sent                  | Push bildirimi başarıyla gönderildi                                                             |
| Push Received                  | Message Received              | Push bildirimi başarıyla alındı                                                                 |
| Push Clicked                   | App Opened from Push          | Cihazda push bildirimine dokunuldu                                                              |
| Push Failed                    | Push Failed                   | Push gönderilemedi. OneSignal'deki başarısız mesaj raporunu kontrol edin                        |
| Push Unsubscribed              | Push Unsubscribed             | [Abonelik](./subscriptions) push'tan abonelikten çıktı                                          |
|                                |                               |                                                                                                 |
| In-App Impression              | Message Sent                  | Uygulama içi mesaj cihazda başarıyla görüntülendi                                               |
| In-App Clicked                 | Message Opened                | Cihazda uygulama içi mesaja tıklandı                                                            |
| In-App Page Displayed          | In-App Page Displayed         | Uygulama içi mesaj sayfası görüntülendi                                                         |
|                                |                               |                                                                                                 |
| Email Sent                     | \$campaign\_delivery          | E-posta başarıyla gönderildi                                                                    |
| Email Received                 | Message Received              | E-posta alıcı tarafından alındı                                                                 |
| Email Opened                   | Message Opened                | E-posta alıcı tarafından açıldı                                                                 |
| Email Link Clicked             | App Opened from Push          | E-posta bağlantısına tıklandı                                                                   |
| Email Unsubscribed             | Email Unsubscribed            | Alıcı e-posta aboneliğinden çıktı                                                               |
| Email Reported As Spam         | Email Reported As Spam        | E-posta alıcı tarafından spam olarak bildirildi                                                 |
| Email Bounced                  | Email Bounced                 | E-posta kalıcı bir hata nedeniyle gönderene geri döndü                                          |
| Email Failed                   | Email Failed                  | E-posta alıcının gelen kutusuna teslim edilemedi                                                |
| Email Suppressed               | Email Suppressed              | E-posta adresi engelleme listenizde. Ya geri döndü ya da e-postalarınız spam olarak işaretlendi |
|                                |                               |                                                                                                 |
| SMS Sent                       | App Opened from Push          | SMS alıcıya gönderildi                                                                          |
| SMS Failed                     | SMS Failed                    | SMS gönderilemedi                                                                               |
| SMS Delivered                  | SMS Received                  | SMS başarıyla teslim edildi                                                                     |
| SMS Undelivered                | SMS Undelivered               | SMS gönderilemedi                                                                               |

### Olay özellikleri

OneSignal'den Mixpanel'e gönderilen her olay bu özellikleri içerir:

| PROPERTY NAME        | DESCRIPTION                                             |
| -------------------- | ------------------------------------------------------- |
| **Distinct ID**      | Mesajla ilişkili external\_id                           |
| **Message ID**       | Ayrı mesajın tanımlayıcısı                              |
| **Message Name**     | Mesaj adı                                               |
| **Message Title**    | Mesaj başlığı                                           |
| **Message Contents** | Mesaj içerikleri                                        |
| **message\_type**    | Gönderilen mesaj türü: push, uygulama içi, e-posta, SMS |
| **template\_id**     | Kullanılan mesaj şablonu (API ve Journey Mesajları)     |
| **subscription\_id** | OneSignal ayarlı cihaz/e-posta/sms tanımlayıcısı        |
| **device\_type**     | Mesajı alan cihaz türü                                  |
| **language**         | Cihazın iki karakterli dil kodu                         |
| **source**           | `onesignal` (tüm olaylar için kaynak olarak belirtilir) |

<Warning>
  Teslimat sayıları Mixpanel ve OneSignal arasında farklılık gösterebilir. Ayrıntılar için [Teslimat verileri neden eşleşmiyor?](#why-doesnt-delivery-data-match) bölümüne bakın.
</Warning>

***

## Özel olaylar (üçüncü taraf)

Mixpanel entegrasyonu, Mixpanel'den OneSignal'e özel olay göndermeyi doğal olarak desteklememektedir. [Amplitude](./amplitude)'den farklı olarak, Mixpanel'den OneSignal'e yerleşik bir olay hedefi yoktur.

Journey'leri veya Segment'leri tetiklemek için Mixpanel davranışsal olaylarını OneSignal'e [özel olaylar](./custom-events) olarak yönlendirmeniz gerekiyorsa, [Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal) gibi bir üçüncü taraf bağlayıcı kullanabilirsiniz. Vendo, seçilen Mixpanel olaylarını kampanya tetiklemesi için özel olaylar olarak OneSignal'e aktarır.

***

## SSS

### Cohort ve segment sayılarım neden eşleşmiyor?

1. **Eksik veya eşleşmeyen External ID'ler**
   Yalnızca eşleşen OneSignal External ID ve Mixpanel User ID'ye sahip kullanıcılar dahil edilir. Bu entegrasyon kullanıcı veya abonelik oluşturmaz.

2. **Abonelikten çıkmış kullanıcılar**
   OneSignal segmentleri yalnızca abone [Abonelikler](./subscriptions) için sayıyı görüntüler. Abonelikten çıkmış Abonelikler Journey'ler veya Uygulama İçi Mesajlar için kullanılabilir.

Örneğin, bir Mixpanel cohort'unda 10 kullanıcı varsa ancak OneSignal segmenti 8 Abonelik gösteriyorsa, eksik olan 2 kullanıcı:

* OneSignal'de mevcut olmayabilir veya yanlış bir External ID'ye sahip olabilir.
* Abonelikten çıkmış aboneliklere sahip olabilir.

Doğrulamak için, kullanıcıların mevcut olup olmadığını ve aktif aboneliklere sahip olup olmadığını görmek için OneSignal'deki **Audience > Users** sekmesini kontrol edin.

### Mixpanel'den OneSignal'e özel olaylar gönderebilir miyim?

Doğal olarak hayır. Mixpanel entegrasyonu mesaj olaylarını (OneSignal → Mixpanel) ve cohort senkronizasyonunu (Mixpanel → OneSignal) destekler, ancak yerleşik bir özel olay hedefi içermez. Mixpanel olaylarını OneSignal'e [özel olaylar](./custom-events) olarak yönlendirmek için [Vendo](https://www.vendodata.com/use-cases/integrate-mixpanel-with-onesignal) gibi bir üçüncü taraf bağlayıcı kullanın.

### Abonelikten çıkmış kullanıcılar Mixpanel'den senkronize oluyor mu?

Evet, ancak şu anda OneSignal segment sayılarından hariç tutuluyorlar. Başka [Abonelikler](./subscriptions)e sahiplerse veya Abonelik türleri destekliyorsa, onlara Journey'ler veya Uygulama içi mesajlar aracılığıyla hala mesaj gönderebilirsiniz.

### Teslimat verileri neden eşleşmiyor?

Tek bir kullanıcının birden fazla [Aboneliği](./subscriptions) (push cihazları, e-posta adresleri, telefon numaraları) olabilir. Her Abonelik kendi teslimat olayını oluşturur. Örneğin:

* 1 kullanıcı = 2 Android + 1 iOS + 2 Web = 5 push Aboneliği
* 1 push mesajı = 5'e kadar gönderildi/alındı/tıklandı olayı

Tam kaynağı izlemek için olay özelliklerindeki `subscription_id`'yi kullanın.

Eksik olayları gidermek için:

* External ID'yi ayarlamak için bir kullanıcı tanımlandığında `OneSignal.login`'in çağrıldığından emin olun.
* `OneSignal.logout`'un External ID'yi kaldırmadığını doğrulayın.
* External ID'yi değiştirebilecek API isteklerini veya CSV yüklemelerini kontrol edin.

### Kullanıcı/abonelik olaylarını nasıl gönderebilirim?

Kullanıcı ve abonelik düzeyindeki olaylar (örn. izin verildi, kullanıcı girişi/çıkışı) otomatik olarak gönderilmez.

OneSignal SDK'da, bu olayları izlemek için Mixpanel'e göndermeniz için kullanılabilecek olay dinleyicileri vardır:

* User State Observer: [Mobile SDK](./mobile-sdk-reference#addobserver-user-state), [Web SDK](./web-sdk-reference#addeventlistener-user-state)
* Permission Observer: [Mobile SDK](./mobile-sdk-reference#addpermissionobserver-push), [Web SDK](./web-sdk-reference#permissionchange)

***

## İlgili sayfalar

<Columns cols={2}>
  <Card title="Analizlere genel bakış" icon="chart-line" href="./analytics-overview">
    OneSignal analizleri, teslimat metrikleri ve olay takibine genel bakış.
  </Card>

  <Card title="Özel olaylar" icon="bolt" href="./custom-events">
    Journey'leri tetiklemek veya analizleri güçlendirmek için kullanıcı eylemlerini takip edin.
  </Card>
</Columns>

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please include:

  * Details of the issue you're experiencing and steps to reproduce if available
  * Your OneSignal App ID
  * The External ID or Subscription ID if applicable
  * The URL to the message you tested in the OneSignal Dashboard if applicable
  * Any relevant [logs or error messages](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>