Airbridge

Airbridge, 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 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

Adapty’yi Airbridge’e bağlama

Airbridge’i entegre etmek için 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.

Her ikisi de Airbridge kontrol panelinizde Third-party Integrations > Adapty bölümünde bulunabilir.

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.

Etkinlikleri ve etiketleri yapılandırma

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

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

Uygulamanızı Airbridge’e bağlama

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:

do {
    try await Adapty.setIntegrationIdentifier(
        key: "airbridge_device_id", 
        value: AirBridge.deviceUUID()
    )
} catch {
    // handle the error
}

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) {
    }
})

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
}

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

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

airbridgeDeviceId hakkında daha fazla bilgi için Airbridge belgelerine 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ı

Adapty, seçilen etkinlikleri Airbridge Integration page 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:

{
  "user": {
    "externalUserID": "user_12345",
    "externalUserEmail": "[email protected]",
    "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: