---
title: "Airbridge"
description: "Pazarlama ve attribution verilerini takip etmek için Adapty'yi Airbridge ile entegre edin."
---

[Airbridge](https://www.airbridge.io/), birden fazla cihaz, platform ve kanaldan toplanan verileri bir araya getirerek web siteleri ve mobil uygulamalar için entegre bir pazarlama performans analizi sunar. Airbridge'in Identity Resolution Engine'i sayesinde, web ve uygulama etkileşimlerinden elde edilen dağınık müşteri kimlik verilerini birleştirerek kişi bazlı tek bir kimlik oluşturabilir ve böylece daha doğru attribution elde edebilirsiniz.

Adapty, mağazalardaki [abonelik etkinliklerini](events) tek bir yerde takip etmenizi sağlayan eksiksiz bir veri seti sunar. Adapty ile abonelerinizin davranışlarını kolayca gözlemleyebilir, tercihlerini öğrenebilir ve bu bilgileri hedefli ve etkili iletişim kurmak için kullanabilirsiniz.

Adapty ile Airbridge arasındaki entegrasyon iki temel şekilde çalışır.

1. **Airbridge'den attribution verisi alma**  
   Airbridge entegrasyonunu kurduktan sonra Adapty, Airbridge'den attribution verisi almaya başlar. Bu verilere kullanıcı sayfasından kolayca erişebilir ve görüntüleyebilirsiniz.
2. **Airbridge'e abonelik etkinlikleri gönderme**  
   Adapty, entegrasyonunuzda yapılandırılan tüm abonelik etkinliklerini Airbridge'e gönderebilir. Bu sayede söz konusu etkinlikleri Airbridge 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 Airbridge'e bağlama \{#connect-adapty-to-airbridge\}

Airbridge'i entegre etmek için [Integrations > Airbridge](https://app.adapty.io/integrations/airbridge) sayfasına gidin, geçiş düğmesini etkinleştirin ve gerekli alanları doldurun.

Öncelikle Airbridge ve Adapty profilleriniz arasında bağlantı kurmak için kimlik bilgilerini girin. Airbridge uygulama adı ve Airbridge API token'ı zorunludur.

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

Her ikisi de Airbridge kontrol panelinizde [Third-party Integrations > Adapty](https://app.airbridge.io/app/testad/integrations/third-party/adapty) bölümünde bulunabilir.

  <img src="/assets/shared/img/5a2f627-Screenshot_2023-02-21_at_11.19.29_AM.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

Adapty API token alanı, Adapty tarafında önceden oluşturulmuştur. Adapty API token değerini kopyalayarak Airbridge Kontrol Paneli'ndeki Adapty Authorization Token alanına yapıştırmanız gerekir.

  <img src="/assets/shared/img/ff422d1-CleanShot_2023-03-01_at_17.11.412x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

### Etkinlikleri ve etiketleri yapılandırma \{#configure-events-and-tags\}

Kimlik bilgilerinin altında, Adapty'den Airbridge'e gönderebileceğiniz üç etkinlik grubu bulunur.

  <img src="/assets/shared/img/eb4e3a9-CleanShot_2023-08-22_at_13.58.472x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

İhtiyaç duyduklarınızı etkinleştirmeniz yeterlidir.

### Uygulamanızı Airbridge'e bağlama \{#connect-your-app-to-airbridge\}

Entegrasyon için `airbridge_device_id` değerini profil oluşturucuya iletmeniz ve aşağıdaki örnekte gösterildiği gibi `setIntegrationIdentifier` fonksiyonunu çağırmanız gerekir:

<Tabs groupId="current-os" queryString>
<TabItem value="swift" label="iOS (Swift)" default>
```swift showLineNumbers

do {
    try await Adapty.setIntegrationIdentifier(
        key: "airbridge_device_id", 
        value: AirBridge.deviceUUID()
    )
} catch {
    // handle the error
}
```
</TabItem>
<TabItem value="kotlin" label="Android (Kotlin)" default>
```kotlin showLineNumbers
Airbridge.getDeviceInfo().getUUID(object: AirbridgeCallback.SimpleCallback<String>() {
    override fun onSuccess(result: String) {
        Adapty.setIntegrationIdentifier("airbridge_device_id", result) { error ->
            if (error != null) {
                // handle the error
            }
        }
    }
    override fun onFailure(throwable: Throwable) {
    }
})
```
</TabItem>
<TabItem value="flutter" label="Flutter (Dart)" default>
```javascript showLineNumbers

final deviceUUID = await Airbridge.state.deviceUUID;

try {
    await Adapty().setIntegrationIdentifier(
        key: "airbridge_device_id", 
        value: deviceUUID,
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}
```
</TabItem>
<TabItem value="rn" label="React Native (TS)" default>
```typescript showLineNumbers

try {
  const deviceId = await Airbridge.state.deviceUUID();

  await adapty.setIntegrationIdentifier("airbridge_device_id", deviceId);
} catch (error) {
  // handle `AdaptyError`
}
```
</TabItem>
</Tabs>

`airbridgeDeviceId` hakkında daha fazla bilgi için [Airbridge belgelerine](https://help.airbridge.io/en/developers/airbridge-device-id-faq) bakabilirsiniz.

Adapty'nin bir abonelik etkinliğinin ardından Airbridge attribution verilerini alması 24 saate kadar sürebilir. Adapty bu verileri kontrol panelinde anında görüntüler.

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

Adapty, seçilen etkinlikleri [**Airbridge Integration page**](https://app.adapty.io/integrations/airbridge) sayfasındaki **Events names** bölümünde yapılandırıldığı şekilde Airbridge'e gönderir. Her etkinlik şu şekilde yapılandırılmıştır:

```json
{
  "user": {
    "externalUserID": "user_12345",
    "externalUserEmail": "user@example.com",
    "attributes": {
      "is_premium": true
    }
  },
  "device": {
    "deviceUUID": "550e8400-e29b-41d4-a716-446655440000",
    "deviceModel": "iPhone 14 Pro",
    "osName": "iOS",
    "osVersion": "17.0.1",
    "locale": "en-US",
    "timezone": "America/New_York",
    "ifa": "00000000-0000-0000-0000-000000000000",
    "ifv": "00000000-0000-0000-0000-000000000000"
  },
  "app": {
    "packageName": "com.example.app",
    "version": "1.2.3"
  },
  "eventUUID": "d4f6f1f4-96fb-4a31-bafd-599fef77be90",
  "eventTimestamp": 1709294400000,
  "eventData": {
    "goal": {
      "category": "airbridge.subscribe",
      "customAttributes": {
        "isTrialConverted": true
      },
      "semanticAttributes": {
        "transactionID": "GPA.3383-4699-1373-07113",
        "totalValue": 9.99,
        "currency": "USD",
        "period": "P1M",
        "isRenewal": true,
        "renewalCount": 2,
        "products": [
          {
            "productID": "yearly.premium.6999",
            "name": "yearly.premium.6999",
            "position": 1
          }
        ]
      }
    }
  }
}
```

Parametreler:

| Parametre                                    | Tür     | Açıklama                                                                               |
|:---------------------------------------------|:--------|:---------------------------------------------------------------------------------------|
| `user`                                       | Object  | Kullanıcı bilgileri.                                                                   |
| `user.externalUserID`                        | String  | Kullanıcının Customer User ID'si.                                                      |
| `user.externalUserEmail`                     | String  | Kullanıcının e-posta adresi (varsa).                                                   |
| `user.attributes`                            | Object  | Özel kullanıcı nitelikleri.                                                            |
| `device`                                     | Object  | Cihaz bilgileri.                                                                       |
| `device.deviceUUID`                          | String  | Airbridge Cihaz UUID'si.                                                               |
| `device.deviceModel`                         | String  | Cihaz modeli (örn. "iPhone 14 Pro").                                                   |
| `device.osName`                              | String  | İşletim sistemi adı (örn. "iOS", "Android").                                           |
| `device.osVersion`                           | String  | İşletim sistemi sürümü.                                                                |
| `device.ifa`                                 | String  | **Yalnızca iOS**. Reklamverenler için kimlik (ID for Advertisers).                     |
| `device.ifv`                                 | String  | **Yalnızca iOS**. Satıcılar için kimlik (ID for Vendors).                              |
| `device.gaid`                                | String  | **Yalnızca Android**. Google Advertising ID.                                           |
| `app`                                        | Object  | Uygulama bilgileri.                                                                    |
| `app.packageName`                            | String  | Uygulamanın paket adı / bundle ID'si.                                                  |
| `app.version`                                | String  | Uygulamanın sürümü.                                                                    |
| `eventUUID`                                  | String  | Adapty'deki etkinliğin benzersiz kimliği.                                              |
| `eventTimestamp`                             | Long    | Etkinliğin milisaniye cinsinden zaman damgası.                                         |
| `eventData`                                  | Object  | Etkinlik ayrıntıları.                                                                  |
| `eventData.goal.category`                    | String  | Airbridge etkinlik kategorisi (Adapty etkinliğinden eşlenir).                          |
| `eventData.goal.semanticAttributes`          | Object  | Standart etkinlik nitelikleri.                                                         |
| `...semanticAttributes.transactionID`        | String  | Mağaza İşlem Kimliği.                                                                  |
| `...semanticAttributes.totalValue`           | Float   | Gelir tutarı.                                                                          |
| `...semanticAttributes.currency`             | String  | Para birimi kodu (örn. "USD").                                                         |
| `...semanticAttributes.period`               | String  | ISO 8601 süre formatında abonelik dönemi (örn. "P1M").                                 |
| `...semanticAttributes.isRenewal`            | Boolean | İşlem bir yenileme ise `true`.                                                         |
| `...semanticAttributes.renewalCount`         | Integer | Başarılı yenileme sayısı.                                                              |
| `...semanticAttributes.products`             | Array   | Etkinliğe dahil olan ürünlerin listesi.                                                |
| `...semanticAttributes.products[].productID` | String  | Mağazadaki Ürün Kimliği (örn. "yearly.premium.6999").                                  |
| `...semanticAttributes.products[].name`      | String  | `productID` ile aynıdır.                                                               |
| `...semanticAttributes.products[].position`  | Integer | Ürünün listedeki konumu (her zaman 1).                                                 |