---
title: "Singular"
description: "Adapty ile Singular entegrasyonunu yaparak pazarlama ve abonelik verilerini analiz edin."
---

[Singular](https://www.singular.net/), pazarlama kampanyalarından veri toplayıp sunan önde gelen Mobile Measurement Partner (MMP) platformlarından biridir. Bu sayede şirketler kampanya performanslarını takip edebilir.
Adapty, mağazalardan gelen [abonelik etkinliklerini](events) tek bir yerden takip etmenizi sağlayan eksiksiz bir veri seti sunar. Adapty ile abonelerinizin davranışlarını kolayca izleyebilir, tercihlerini öğrenebilir ve bu bilgileri hedefli ve etkili bir şekilde iletişim kurmak için kullanabilirsiniz. Bu entegrasyon sayesinde Singular'da abonelik etkinliklerini takip edebilir ve kampanyalarınızın ne kadar gelir ürettiğini tam olarak analiz edebilirsiniz.
Adapty, entegrasyonunuzda yapılandırılan tüm abonelik olaylarını Singular'a gönderebilir. Bu sayede söz konusu olayları Singular kontrol panelinde takip edebilirsiniz. Bu entegrasyon, reklam kampanyalarınızın etkinliğini değerlendirmek için oldukça faydalıdır.
## Entegrasyonu kurma \{#set-up-integration\}

### Adapty'yi Singular'a Bağlayın

Singular entegrasyonunu kurmak için Adapty Kontrol Paneli'nde [Integrations > Singular](https://app.adapty.io/integrations/singular) sayfasına gidin, toggle'ı açın ve alanları doldurun.

Aşağıdaki kimlik bilgileri mevcuttur:

- **Singular SDK Key**: Zorunlu. Singular uygulamanız için production SDK anahtarı.
- **Singular SDK Key (Sandbox)**: İsteğe bağlı. Sandbox Singular uygulamanız için SDK anahtarı. Ayarlanmazsa sandbox olayları Singular'a gönderilmez.
Her iki anahtar da Singular kontrol panelinde **Developer tools -> SDK Keys -> SDK Key (**not** SDK Secret)** altında bulunabilir:

  <img src="/assets/shared/img/4bc50d1-singular_sdk_key.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

Kimlik bilgilerinin altında, Adapty'den Singular'a gönderebileceğiniz üç grup etkinlik bulunur. Adapty'nin sunduğu etkinliklerin tam listesine [buradan](events) ulaşabilirsiniz.
Adapty tarafından sağlanan varsayılan etkinlik adlarını kullanmanızı öneririz. Ancak etkinlik adlarını ihtiyaçlarınıza göre değiştirebilirsiniz.
Adapty, abonelik etkinliklerini sunucudan sunucuya entegrasyon aracılığıyla Singular'a gönderecek; böylece tüm abonelik etkinliklerini Singular kontrol panelinizde görüntüleyebilir ve bunları edinim kampanyalarınızla ilişkilendirebilirsiniz.

:::warning
Entegrasyonlar yapılandırılmadan önce oluşturulan profiller, etkinliklerini Singular'a ileteyemez.
:::
### Uygulamanızı Singular'a bağlama \{#connect-your-app-to-singular\}

Adapty ile Singular arasındaki entegrasyon sunucudan sunucuyadır. Bu nedenle uygulamanıza herhangi bir ek kod eklemeniz gerekmez.

## Etkinlik yapısı \{#event-structure\}

Adapty, etkinlikleri Singular'a sorgu parametreleri kullanarak GET isteğiyle gönderir. Her etkinlik şu şekilde yapılandırılmıştır:

```json
{
  "n": "subscription_renewed",
  "a": "singular_sdk_key_123",
  "p": "iOS",
  "i": "com.example.app",
  "ip": "192.168.100.1",
  "idfa": "00000000-0000-0000-0000-000000000000",
  "idfv": "00000000-0000-0000-0000-000000000000",
  "ve": "17.0.1",
  "att_authorization_status": 3,
  "custom_user_id": "user_12345",
  "utime": 1709294400,
  "amt": 9.99,
  "cur": "USD",
  "purchase_product_id": "yearly.premium.6999",
  "purchase_transaction_id": "GPA.3383...",
  "e": "{\"is_revenue_event\":true,\"amt\":9.99,\"cur\":\"USD\",\"purchase_product_id\":\"yearly.premium.6999\",\"purchase_transaction_id\":\"GPA.3383...\"}"
}
```

Parametreler:

| Parametre                  | Tür     | Açıklama                                                       |
|:---------------------------|:--------|:---------------------------------------------------------------|
| `n`                        | String  | Etkinlik adı (Adapty etkinliğinden eşlenir).                   |
| `a`                        | String  | Singular SDK Key'iniz.                                         |
| `p`                        | String  | Platform ("iOS" veya "Android").                               |
| `i`                        | String  | Mağaza Uygulama Kimliği (Bundle ID).                           |
| `ip`                       | String  | Kullanıcının IP adresi.                                        |
| `idfa`                     | String  | **Yalnızca iOS**. Reklamverenler için Kimlik (büyük harf).     |
| `idfv`                     | String  | **Yalnızca iOS**. Satıcılar için Kimlik (büyük harf).          |
| `aifa`                     | String  | **Yalnızca Android**. Google Reklam Kimliği (küçük harf).      |
| `andi`                     | String  | **Yalnızca Android**. Android Kimliği (küçük harf).            |
| `asid`                     | String  | **Yalnızca Android**. Uygulama Set Kimliği (küçük harf).       |
| `ve`                       | String  | İşletim sistemi sürümü.                                        |
| `att_authorization_status` | Integer | **Yalnızca iOS**. ATT durumu (örn. yetkili için `3`).          |
| `custom_user_id`           | String  | Kullanıcının Müşteri Kullanıcı Kimliği.                        |
| `utime`                    | Long    | Etkinliğin saniye cinsinden UNIX zaman damgası.                |
| `amt`                      | Float   | Gelir tutarı.                                                  |
| `cur`                      | String  | Para birimi kodu (örn. "USD").                                 |
| `purchase_product_id`      | String  | Mağazadaki Ürün Kimliği.                                       |
| `purchase_transaction_id`  | String  | Orijinal işlem kimliği.                                        |
| `e`                        | String  | Etkinlik ayrıntılarını içeren JSON dizesi (aşağıya bakın).     |

`e` parametresi (özel etkinlik verisi), şunları içeren JSON kodlu bir dizedir:

| Parametre                 | Tür     | Açıklama                                    |
|:--------------------------|:--------|:--------------------------------------------|
| `is_revenue_event`        | Boolean | Etkinlik gelir içeriyorsa `true`.           |
| `amt`                     | Float   | Gelir tutarı.                               |
| `cur`                     | String  | Para birimi kodu.                           |
| `purchase_product_id`     | String  | Mağazadaki Ürün Kimliği.                    |
| `purchase_transaction_id` | String  | Orijinal işlem kimliği.                     |