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’ini kullanarak web ve uygulama etkileşimlerinden gelen dağınık müşteri kimlik verilerini, insan tabanlı birleşik bir kimlikte toplayabilir ve böylece daha doğru bir attribution elde edebilirsiniz.

Adapty, mağazalardan gelen abonelik etkinliklerini tek bir yerden takip etmenizi sağlayan eksiksiz bir veri seti sunar. Adapty ile abonelerinizin nasıl davrandığını kolayca görebilir, nelerden hoşlandıklarını öğrenebilir ve bu bilgileri onlarla hedefli ve etkili bir şekilde iletişim kurmak için kullanabilirsiniz.

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

1. Airbridge’den attribution verisi alma Airbridge entegrasyonunu kurduğunuzda, 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. Böylece bu 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": "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:

Sorun Giderme

access_level_updated Event Feed’de başarısız olarak görünüyor

access_level_updated yalnızca webhook’a özgü bir event’tir. Adapty bu event’i bu entegrasyona hiçbir zaman göndermez. Ancak Adapty, etkinleştirilmiş her entegrasyon için bir sonuç kaydeder ve desteklenmeyen bir event başarısızlık olarak görüntülenir.