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

# Amplitude

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

OneSignal'ı [Amplitude](https://amplitude.com) ile entegre ederek push, uygulama içi, e-posta ve SMS genelinde gerçek zamanlı, davranış tabanlı hedefleme sağlayın. Bu uygulama düzeyinde entegrasyon üç veri akışını destekler:

* **Mesaj olayları → Amplitude**: Tüm kanallar için teslimat, tıklama, başarısızlık ve daha fazlasını takip edin.
* **Özel olaylar → OneSignal**: Journey'leri veya Segment'leri tetiklemek için Amplitude olaylarını OneSignal'a gönderin.
* **Kohortlar → OneSignal**: Davranış tabanlı Amplitude kohortlarını OneSignal'da hedefleme filtresi olarak senkronize edin.

***

## Gereksinimler

* [Amplitude Hesabı](https://amplitude.com/pricing)
* [OneSignal Ücretli Plan](https://onesignal.com/pricing)
* [Kullanıcılar](./users) ve External ID ayarlanmış OneSignal uygulaması.

<Warning>
  Bu entegrasyon kullanıcı oluşturmaz. Amplitude'daki kullanıcıları tanımlayıcıları eşleştirerek OneSignal'daki mevcut kullanıcılara eşler.
</Warning>

***

## Kurulum

### OneSignal'a Amplitude Ekleme (Çıkış)

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

1. OneSignal'da **Veriler > Entegrasyonlar > Katalog** bölümüne gidin ve **Amplitude**'u seçin.
2. **Ayarlar**'ı tıklayın, ardından **Çıkış** sekmesini açın.
3. Amplitude API token'inizi girin, göndermek istediğiniz mesaj olaylarını seçin ve **Kaydet**'i tıklayın.

#### Amplitude'da

1. Proje API anahtarınızı bulun ve OneSignal'a kopyalayıp yapıştırın.
2. Amplitude'un AB sunucularını kullanıyorsanız, **Amplitude'un AB Residence Endpoint'ine özel olarak olaylar gönder** seçeneğini işaretleyin. Bunu Amplitude URL'niz ile doğrulayabilirsiniz. Eğer `eu.amplitude.com` görüyorsanız, Amplitude'un AB sunucularını kullanıyorsunuz demektir.

### Amplitude'a OneSignal Ekleme (Giriş)

Amplitude Destinations'ta **OneSignal**'ı arayın.

<Frame caption="Amplitude'da OneSignal Hedef Ekleme">
  <img src="https://mintcdn.com/onesignal/TbJ7SH8gAntayRJq/images/integrations/amplitude-destination.png?fit=max&auto=format&n=TbJ7SH8gAntayRJq&q=85&s=fe7b7967e5e219556a6356915b0238fa" alt="Amplitude hedef kataloğunda OneSignal seçili" width="2288" height="1168" data-path="images/integrations/amplitude-destination.png" />
</Frame>

Amplitude, katalogda iki OneSignal hedef türü sağlar:

* **Cohorts**: Kohortları Amplitude'dan OneSignal'a senkronize eder.
* **Events User Properties**: Özel olayları Amplitude'dan OneSignal'a gönderir.

<Note>
  Hem kohort senkronizasyonu hem de özel olayları kullanmayı planlıyorsanız, her iki OneSignal hedefini de ekleyin. Her hedef Amplitude'da ayrı ayrı yapılandırılır, bu yüzden her biri için OneSignal kimlik bilgilerinizi girmeniz gerekir.
</Note>

### User ID eşleştirmesi

OneSignal'daki **[External ID](./users)**, seçtiğiniz Amplitude kullanıcı özelliğiyle eşleşmelidir (örneğin `user_id`). Bu özelliğin her iki sistemde de dolu olduğunu doğrulayın — kohort senkronizasyonu ve olay takibi tam eşleşmeye bağlıdır.

#### Ek özellikler

OneSignal'da [özel olaylara](./custom-events) eklenecek ek özellikler ekleyebilirsiniz. Bu, koşullu olay işleme için kullanışlıdır.

<Check>
  Bittiğinde **Save** butonuna tıklayın. Artık Amplitude'dan OneSignal'a kohortları ve özel olayları dışa aktarabilmeli ve OneSignal'dan Amplitude'a mesaj olaylarını toplayabilmelisiniz.
</Check>

***

## Özel olayları test etme

1. Amplitude > OneSignal Events Destination bölümünde Test Connection butonuna tıklayın.

<Frame caption="Amplitude > OneSignal Events Hedefi">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/integrations/amplitude-test-connection.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=8202b1ee8513456d78777425db4a7753" alt="Test Connection butonu vurgulanmış Amplitude Events hedef sayfası" width="1970" height="1160" data-path="images/integrations/amplitude-test-connection.png" />
</Frame>

2. Payload'daki `"user_id"`'nin OneSignal Uygulamanızdaki mevcut bir Kullanıcının External ID'sine ayarlı olduğundan emin olun.
3. **Send Test Event** butonuna tıklayın.
4. Response kutusu boş kalmalı ve `"OneSignal has successfully received test event."` mesajını görmelisiniz.

<Frame caption="Response örneği">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/integrations/amplitude-test-connection-response.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=14b5824d639a748252a36315bc491383" alt="Onay mesajı gösteren başarılı test olayı yanıtı" width="2438" height="1500" data-path="images/integrations/amplitude-test-connection-response.png" />
</Frame>

5. OneSignal'da **Veriler > Özel Olaylar** bölümüne gidin ve listede test olayının göründüğünü doğrulayın.

<Frame caption="OneSignal'da Özel Olay">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/integrations/onesignal-custom-event.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=18c287884737e192fde2da0e28d65676" alt="Amplitude'dan gelen test olayını gösteren OneSignal Özel Olaylar listesi" width="2736" height="1032" data-path="images/integrations/onesignal-custom-event.png" />
</Frame>

<Warning>
  Test başarısız olursa veya olay OneSignal'da görünmüyorsa, OneSignal App ID ve REST API anahtarınızın Amplitude'a doğru girildiğini, uygulamanızın [özel olaylar](./custom-events) için yapılandırıldığını ve `"user_id"`'nin OneSignal Uygulamanızdaki mevcut bir Kullanıcının External ID'siyle eşleştiğini doğrulayın.
</Warning>

## Amplitude kohortlarını OneSignal'a dışa aktarma

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

1. Amplitude'da bir kohort oluşturun. [Amplitude'un kohortlar hakkındaki belgelerine](https://amplitude.com/docs/analytics/behavioral-cohorts) bakın.
2. **Sync** butonuna tıklayın ve hedef olarak **OneSignal**'ı seçin.
3. Senkronizasyon sıklığını seçin.

<Frame caption="Amplitude kohortları için OneSignal senkronizasyon sıklığını ayarlama">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/integrations/amplitude-sync-cadence.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=9ba4b69273f73ccdd1f095c2a3ede63c" alt="OneSignal hedefi için sıklık seçeneklerini gösteren Amplitude kohort senkronizasyon ayarları" width="602" height="499" data-path="images/integrations/amplitude-sync-cadence.png" />
</Frame>

### OneSignal Segment oluşturma

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

* Amplitude Cohort'undaki Kullanıcılar, eşleşen External ID ile OneSignal'da da mevcuttur.
* OneSignal'daki Segment limitinizi aşmamış olmalısınız.

<Frame caption="Amplitude Cohort'undan Segment oluşturma">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/526a986-Screenshot_2023-09-22_at_7.01.09_PM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=e5de1d6896a542a980b9840a05200586" alt="Amplitude Cohort filtresi kullanan OneSignal Segment oluşturucu" width="1622" height="878" data-path="images/docs/526a986-Screenshot_2023-09-22_at_7.01.09_PM.png" />
</Frame>

***

## Amplitude'da mesaj olaylarını takip etme

OneSignal, aşağıdaki mesaj olaylarını Amplitude'a gerçek zamanlı olarak gönderir. Hangi olayları göndereceğinizi **Veriler > Entegrasyonlar > Amplitude > Çıkış** bölümünde seçin.

| Message Event Kind (OneSignal) | Message Event Name (Amplitude)                                | Event Description                                                                        |
| ------------------------------ | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Push Sent                      | \[OneSignal] Push Sent                                        | Push bildirimi başarıyla gönderildi.                                                     |
| Push Received                  | \[OneSignal] Push confirmed receipt                           | Push bildirimi başarıyla alındı                                                          |
| Push Clicked                   | \[OneSignal] Push Clicked                                     | Cihazda push bildirimine dokunuldu                                                       |
| Push Failed                    | \[OneSignal] Push Failed                                      | Push gönderilirken başarısız oldu. OneSignal'daki başarısız mesaj raporunu kontrol edin. |
| Push Unsubscribed              | \[OneSignal] Push Unsubscribed                                | [Abonelik](./subscriptions) push'tan abonelikten çıktı.                                  |
| In-App Impression              | \[OneSignal] IAM Displayed                                    | Uygulama İçi Mesaj cihazda başarıyla görüntülendi                                        |
| In-App Clicked                 | \[OneSignal] IAM Clicked                                      | Cihazda Uygulama İçi Mesaja tıklandı                                                     |
| In-App Page Displayed          | \[OneSignal] IAM Page Displayed                               | Uygulama İçi Mesaj sayfası görüntülendi                                                  |
| Email Sent                     | \[Onesignal] Email Delivered                                  | E-posta başarıyla gönderildi                                                             |
| Email Received                 | \[OneSignal] Email confirmed receipt                          | E-posta alıcı tarafından alındı                                                          |
| Email Opened                   | \[OneSignal] Email Opened                                     | E-posta alıcı tarafından açıldı                                                          |
| Email Link Clicked             | \[OneSignal] Email Clicked                                    | E-posta bağlantısına tıklandı                                                            |
| Email Unsubscribed             | \[OneSignal] Email Unsubscribed                               | Alıcı tarafından e-posta aboneliğinden çıkıldı                                           |
| Email Reported As Spam         | \[OneSignal] Email Reported As SPAM                           | E-posta alıcı tarafından spam olarak bildirildi                                          |
| Email Bounced                  | \[OneSignal] Email Hard Bounced                               | Kalıcı hata nedeniyle e-posta gönderene geri döndü                                       |
| Email Failed                   | \[OneSignal] Email Failed delivery                            | E-posta alıcının gelen kutusuna teslim edilemedi                                         |
| Email Suppressed               | \[OneSignal] Email Not delivering to suppressed email address | Alıcı gönderildiği e-posta adresini engellediği için e-posta teslim edilmedi             |
| SMS Sent                       | \[OneSignal] SMS Sent                                         | SMS alıcıya gönderildi                                                                   |
| SMS Failed                     | \[OneSignal] SMS Failed delivery                              | SMS gönderilemedi                                                                        |
| SMS Delivered                  | \[OneSignal] SMS Confirmed deliveery                          | SMS başarıyla teslim edildi                                                              |
| SMS Undelivered                | \[OneSignal] SMS Undelivered                                  | SMS gönderilemedi.                                                                       |

### Olay özellikleri

OneSignal'dan Amplitude'a gönderilen tüm olaylar bu özellikleri içerir:

| PROPERTY NAME        | DESCRIPTION                                                    |
| -------------------- | -------------------------------------------------------------- |
| **Distinct ID**      | Mesajla ilişkili external\_id                                  |
| **Message ID**       | Ayrık mesajın tanımlayıcısı                                    |
| **Message Name**     | Mesaj adı                                                      |
| **Message Title**    | Mesaj başlığı                                                  |
| **Message Contents** | Mesaj içeriği                                                  |
| **message\_type**    | Gönderilen mesajın türü, push, uygulama içi, e-posta, SMS      |
| **template\_id**     | Kullanılan mesaj şablonu (API ve Journey Mesajları)            |
| **subscription\_id** | OneSignal tarafından ayarlanan 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ı Amplitude ile OneSignal arasında farklılık gösterebilir. Ayrıntılar için [Teslimat verilerim neden eşleşmiyor?](#why-doesnt-delivery-data-match) bölümüne bakın.
</Warning>

***

## SSS

### Kohort 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 Amplitude 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 olmuş [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 Amplitude kohortu 10 kullanıcıya sahipse ancak OneSignal segmenti 8 Abonelik gösteriyorsa, eksik 2 kullanıcı:

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

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

### Abonelikten çıkmış kullanıcılar Amplitude'dan senkronize ediliyor mu?

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

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

Tek bir kullanıcının birden fazla [Aboneliği](./subscriptions) olabilir (push cihazları, e-posta adresleri, telefon numaraları). 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önderilen/alınan/tıklanan olay

Tam kaynağı izlemek için olay özelliklerinde `subscription_id` kullanın.

Eksik olayların sorununu 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önderebiliriz?

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

OneSignal SDK'sı, bu olayları izlemek ve Amplitude'a göndermek için kullanabileceğiniz olay dinleyicilerine sahiptir:

* 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)

### OneSignal Subscription ID neden Amplitude'a device\_id olarak ekleniyor?

Amplitude, tekilleştirme için bir `device_id` bekler. OneSignal bunun için `subscription_id` kullanır ve bu otomatik olarak `device_id`'ye eşlenir.

Daha fazla bilgi için [Amplitude'un belgelerine](https://amplitude.com/docs/apis/analytics/http-v2#event-deduplication) bakın.

***

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