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

# Segment (Twilio)

> Kullanıcı verileri ve mesajlaşma olayları için OneSignal'i Twilio Segment ile entegre edin.

<Frame caption="OneSignal Segment entegrasyon genel bakışı">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0fe35d2-onesignal-segment-integration_1.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=f70d1f0b0ea879b548b634bb253ecacf" width="1280" height="720" data-path="images/docs/0fe35d2-onesignal-segment-integration_1.png" />
</Frame>

## Genel bakış

OneSignal + Segment entegrasyonu şunları yapmanıza olanak tanır:

* Kullanıcı profillerini zenginleştirmek, segmentasyonu güçlendirmek ve mesajlaşmayı tetiklemek için Segment'ten OneSignal'e kullanıcı özellikleri ve olayları gönderin.
* Merkezi analitik ve veri ambarlama için OneSignal'den Segment'e mesaj teslimi ve etkileşim olaylarını gönderin.

Bu çift yönlü kurulum, tüm büyük OneSignal kanallarını destekler: Push, In-App, Email ve SMS.

***

## Gereksinimler

* Growth, Professional veya Enterprise [OneSignal Hesabı](https://onesignal.com/pricing).
* Segment Yönetici İzinleri
* Veri göndermek istediğiniz OneSignal [Mobile SDK](./mobile-sdk-setup) ve/veya [Web SDK](./web-push-setup). Yalnızca [Email](./email-setup) veya [SMS](./sms-setup) entegrasyonları SDK gerektirmez.
* Segment.com `userId`'ye eşlenen OneSignal Özelliği: [External ID](./users).

***

## Kurulum

### 1. OneSignal'i kurun

OneSignal dashboard'unda mevcut bir uygulamayı kullanın veya yeni bir tane oluşturun. Ardından tercih ettiğiniz kanalları kurun:

* [Web Push Setup](./web-push-setup)
* [Mobile Push Setup](./mobile-sdk-setup)
* [SMS Setup](./sms-setup)
* [Email Setup](./email-setup)

### 2. Segment'i OneSignal'e bağlayın

OneSignal Dashboard'da, **Data > Integrations**'a gidin ve Segment.com kartı içinde **Active**'e tıklayın. Ardından kurulum seçenekleriyle devam edin.

#### Data in

OneSignal'e "Data In", Segment.com hesabınızdan OneSignal'e [OneSignal segments](./segmentation), [tags](./add-user-data-tags) ve [custom events](./custom-events) göndermenizi sağlar. OneSignal Dashboard'daki Segment.com ayar sayfasının *Data In* bölümünde **Authenticate**'e tıklayın.

<Warning>
  Özel olayları izlemek için etkinleştirildikten sonra, Segment.com entegrasyonu hem Tags hem de Events gönderecektir, bu nedenle veri etiketlerine referans veren mevcut şablonları güncellemenize gerek kalmayacaktır.
</Warning>

<Frame caption="Data In kimlik doğrulama ayarları">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/48031e3-Data_in.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=3985a85e39ed139234cf81b3f29a0290" width="1182" height="428" data-path="images/docs/48031e3-Data_in.png" />
</Frame>

Authenticate'e tıkladığınızda, bir Segment.com web sayfası açılacak ve Segment.com hesabınıza giriş yapmanız istenecektir. Ardından Segment.com hesabınızdan yeni bir veri hedefi yapılandırmanız istenecektir.

<Frame caption="Segment kurulum yapılandırma ekranı">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/85c6577-segment_set_up.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=a8a554790d8c80595116aca43093627b" width="898" height="916" data-path="images/docs/85c6577-segment_set_up.png" />
</Frame>

#### Data out

Segment.com'a "Data Out" etkinleştirmek, OneSignal platformunda kullanıcılarınıza mesaj göndermekten oluşturulan mesaj olaylarını Segment.com hesabınıza geri senkronize eder. Ne tür olayların oluşturulabileceği ve hangi özelliklerle gönderildikleri hakkında daha fazla ayrıntı [aşağıda](./segment-onesignal-integration#message-events) bulunabilir.

İlk olarak, Segment.com hesabınızdan OneSignal'i kaynak olarak eklemeniz gerekir. Bunu, Segment Connections Catalogue'daki [OneSignal Source listeleme](https://segment.com/docs/connections/sources/catalog/cloud-apps/onesignal/)'ye giderek yapabilirsiniz.

Oradan, OneSignal Dashboard'a Segment.com API token'ınızı ekleyebilirsiniz. Segment API anahtarını eklemek için lütfen OneSignal Dashboard'da **Data > Integrations > Segment**'e gidin.

<Frame caption="Data Out API key yapılandırması">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9d8eb5f-data_out_3.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=56098282da219dd7eb274b183b271362" width="1604" height="1052" data-path="images/docs/9d8eb5f-data_out_3.png" />
</Frame>

API anahtarını kurduktan sonra, lütfen olayları Segment'in AB Yerleşim Endpoint'ine göndermeniz gerekip gerekmediğini belirlemek için Segment.com'daki Data Policy ayarlarınızı kontrol ettiğinizden emin olun.

Tüm bu ayarlar tamamlandıktan sonra, OneSignal ile kullandığınız kanallara bağlı olarak Segment Hesabınıza hangi olayları senkronize etmek istediğinizi seçebilirsiniz.

### 3. Segment'te OneSignal hedefi ekleyin

**Segment.com Dashboard > Destinations** içinde **OneSignal**'i görmelisiniz. Görmüyorsanız, OneSignal'i yeni bir hedef olarak ekleyin.

OneSignal Destination'ı etkinleştirin, OneSignal API Key ve App ID'nizi zaten görmelisiniz

<Frame caption="Segment'te OneSignal hedef yapılandırması">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b191d42-turn-on-configuration-in-segment.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=aebe97a4fbfe4775b502b2c3186ff5fb" width="2046" height="946" data-path="images/docs/b191d42-turn-on-configuration-in-segment.png" />
</Frame>

API anahtarı ve App Id ayarlanmamışsa, [OneSignal dashboard](https://app.onesignal.com/apps/)'a gidin, Uygulamayı seçin ve **Settings > Keys & IDs**'e gidin. "App ID" ve "API key"'i kopyalayıp Segment.com'a yapıştırın.

#### Birden fazla Segment.com Kaynağı

Birden fazla kaynağınız varsa, birden fazla kaynağı bir hedefe bağlamak için [Segment'in **Personas > Spaces** özelliğini](https://segment.com/docs/personas/#personas-spaces) kullanabilirsiniz.

### 4. Segment'ten OneSignal'e veri gönderin

OneSignal kanal düzeyinde kayıtlar saklar: Push/IAM, Email ve SMS. Bu kayıtlar OneSignal'de zaten oluşturulmuş olmalıdır ve ayrıca OneSignal'deki [External ID](./users) takma adını Segment.com tarafından gönderilen `userID` alanıyla eşleşecek şekilde ayarlamalısınız.

<Warning>
  **Segment User ID \<--> OneSignal External ID** eşleşmesi olmayan kayıtlar düşürülecektir.
</Warning>

## Kullanıcı özellikleri

Segment'teki her müşteri temas noktasında verileri toplayabilir ve ardından bu kullanıcı özelliklerini gerçek zamanlı olarak OneSignal'e [Tags](./add-user-data-tags) olarak gönderebilirsiniz.

**Not**: OneSignal, kullanıcı özellikleri olarak iç içe nesneleri veya dizileri kabul edemez.

[Identify](https://segment.com/docs/connections/spec/identify) - *Segment'in Identify çağrısı* kullanılarak gönderilen kullanıcı özellikleri veya özellikleri, OneSignal'de veri etiketleri olarak saklanır. Örneğin:

<Frame caption="Kullanıcı identify çağrısı örneği">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/0209647-Screenshot_2024-05-08_at_11.44.24_AM.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=423258a2b318e017771eb7a0586a88d9" width="2360" height="632" data-path="images/docs/0209647-Screenshot_2024-05-08_at_11.44.24_AM.png" />
</Frame>

[Track](https://segment.com/docs/connections/spec/track/) - *Segment'in Track çağrısı* kullanılarak gönderilen olaylar ve ilişkili özellikler için, OneSignal tüm *olay özelliklerini* veri etiketleri olarak saklayacak, ancak etiketleri saklarken *olay adını* *düşürecektir*. *Olay adlarını* veri etiketlerinde tutmak istiyorsanız, OneSignal'e göndermeden önce olay adını özelliklere ekleyebilirsiniz. Örneğin:

<CodeGroup>
  ```javascript track example theme={null}
  let timestampInSeconds = Int(NSDate().timeIntervalSince1970).toString()//convert to string since Segment adds decimals to end
  //name will be dropped and only properties will be sent to OneSignal as tag "last opened: timestampInSeconds"
  analytics.track(
    name: "iOS App Last Opened",
    properties: ["last opened": timestampInSeconds]
  )
  ```
</CodeGroup>

<Frame caption="Track çağrısı özellikleri örneği">
  <img src="https://mintcdn.com/onesignal/4HyuQPBpu-4xjmQC/images/docs/ce2b574-Screenshot_2024-05-08_at_11.49.34_AM.png?fit=max&auto=format&n=4HyuQPBpu-4xjmQC&q=85&s=0a32647a69bae9078fa785b6df4a7d24" width="2360" height="632" data-path="images/docs/ce2b574-Screenshot_2024-05-08_at_11.49.34_AM.png" />
</Frame>

<Frame caption="Kullanıcı özellikleri arayüzü">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/565e212-user-traits-or-properties.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=a18d3a422c087b32ce05d702b51b2e6b" width="1773" height="1209" data-path="images/docs/565e212-user-traits-or-properties.png" />
</Frame>

## Personas Audience ve Computed Traits

[Persona Audiences](https://segment.com/docs/personas/), [OneSignal'de bir segment](./segmentation) olarak otomatik olarak görünür.

Computed traits, OneSignal kullanıcı kayıtlarında [Tags](./add-user-data-tags) olarak güncellenir.

**Audience**

<Frame caption="Persona audience ve computed traits arayüzü">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c494a4b-persona-audience-or-computed-traits.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=2a858790b04fbcbc6676e894efd3254b" width="1773" height="1209" data-path="images/docs/c494a4b-persona-audience-or-computed-traits.png" />
</Frame>

Segment'in [Track çağrısı](https://segment.com/docs/connections/spec/track/) kullanılarak gönderilen Audience'lar, *Audience Name* ile bir OneSignal segmenti oluşturacaktır.

Segment'in [Identify çağrısı](https://segment.com/docs/connections/spec/identify/) kullanılarak gönderilen Audience'lar:

* *Audience Name* ile bir OneSignal segmenti oluşturacaktır
* eşleşen tüm kullanıcı kayıtlarına veri etiketleri ekleyecektir (Identify çağrısında ek özellikler varsa).

<Frame caption="Segment'ten OneSignal'de oluşturulan segmentler">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e5ad7f4-segments-in-onesignal.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=21e0f73a8bf21f50311b1c6e11535c51" width="1773" height="1209" data-path="images/docs/e5ad7f4-segments-in-onesignal.png" />
</Frame>

Identify ve Track çağrıları, bir kullanıcı Audience'a girdiğinde veya çıktığında otomatik olarak OneSignal'e gönderilir.

**Computed Traits** Personas Computed Traits, OneSignal'e Identify çağrısı veya Track çağrısı olarak iletilip iletilmediğine bakılmaksızın OneSignal kullanıcı kayıtlarında [Tags](./add-user-data-tags) olarak saklanır. Ardından bu veri etiketlerini manuel olarak OneSignal segmentleri oluşturmak ve mesajlaşma iş akışlarınızı otomatikleştirmek için kullanabilirsiniz.

***

## Mesaj Olayları

## Olay Türleri

Bunlar, OneSignal'in Segment'e gönderdiği mesaj olayı türleridir

| MessageEvent Türü             | Olay Açıklaması                                    |
| ----------------------------- | -------------------------------------------------- |
| Push Sent                     | Push bildirimi başarıyla gönderildi                |
| Push Received                 | Push bildirimi başarıyla alındı                    |
| Push Clicked                  | Cihazda push bildirimine dokunuldu                 |
| In-App Message Displayed      | In-App Message cihazda başarıyla görüntülendi      |
| In-App Message Clicked        | Cihazda In-App Message tıklandı                    |
| In-App Message Page Displayed | In-App Message sayfası görüntülendi                |
| Email Sent                    | E-posta başarıyla gönderildi                       |
| Email Opened                  | E-posta alıcı tarafından açıldı                    |
| Email Unsubscribed            | E-posta alıcı tarafından abonelikten çıkıldı       |
| Email Received                | E-posta alıcı tarafından alındı                    |
| Email Reported As Spam        | E-posta alıcı tarafından spam olarak bildirildi    |
| Email Bounced                 | Kalıcı hata nedeniyle e-posta gönderene geri döndü |
| Email Failed                  | E-posta alıcının gelen kutusuna teslim edilemedi   |
| SMS Sent                      | SMS alıcıya gönderildi                             |
| SMS Delivered                 | SMS başarıyla teslim edildi                        |
| SMS Failed                    | SMS gönderilemedi                                  |

### Olay Özellikleri

Bunlar, OneSignal'den Segment.com'a gönderilen olaylarda bulunan özelliklerdir

| ÖZELLİK ADI         | AÇIKLAMA                                                       |
| ------------------- | -------------------------------------------------------------- |
| `userId`            | Mesajla ilişkili `external_id`                                 |
| `anonymousId`       | `subscription_id`                                              |
| `messageId`         | Ayrık mesajın tanımlayıcısı                                    |
| `campaign_id`       | `messageId` ile aynı değer                                     |
| `message_name`      | Mesaj adı                                                      |
| `message_title`     | Mesaj başlığı                                                  |
| `message_contents`  | Mesaj içeriği                                                  |
|                     |                                                                |
| `subscription_type` | Mesajın gönderildiği kanal                                     |
| `template_id`       | Kullanılan mesaj şablonu                                       |
| `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 karakterlik dil kodu                               |
| `message_type`      | Gönderilen mesaj türü, push, in-app, email, SMS                |

## SSS

### Subscription olaylarını nasıl iletebiliriz?

Subscription olayları şu anda otomatik olarak gönderilmemektedir. Bu, OneSignal SDK Subscription Observer Yöntemleri ile yapılabilir. Daha fazla ayrıntı için [Subscription Tracking](./analytics-overview#subscription-tracking)'e bakın.

### Segment'in Ayrılmış ve Özel Kullanıcı Özelliklerini OneSignal'de Yönetme

* Tüm Segment kullanıcı özellikleri, OneSignal'e veri etiketleri olarak gönderilir. OneSignal'de izin verilen veri etiketi sayısı, OneSignal fiyatlandırma planınıza bağlıdır. Hak verilen sayının üzerindeki etiketler düşürülecektir.
* OneSignal her zaman eşleşen kullanıcılar için firstName ve lastName özelliklerini günceller. Diğer tüm özellikler ilk gelen esasına göre eklenir/güncellenir. *firstName* ve *lastName* etiketleri "first\_name" ve "last\_name" olarak saklanır.
* OneSignal'e boş/null değerlerle gönderilen kullanıcı özellikleri, OneSignal kullanıcı kaydından kaldırılır. Bu, veri etiketi limitleriniz içinde olduğunuzdan emin olmak için yapılır.

***