Tenjin entegrasyonu

Tenjin, uygulama geliştiricileri ve pazarlamacılar için bir mobil attribution ve analitik platformudur. Uygulama performansı ve kullanıcı davranışına dair ayrıntılı içgörüler sunarak kullanıcı kazanım kampanyalarını ölçmenize ve optimize etmenize olanak tanır. Esnek ve şeffaf yapısıyla Tenjin, reklam ağlarından ve uygulama mağazalarından gelen verileri bir araya getirerek ekiplerin ROI’yi analiz etmesini, dönüşümleri takip etmesini ve temel performans metriklerini izlemesini sağlar.

Abonelik olaylarını Tenjin’e ileterek dönüşümlerin tam olarak nereden geldiğini ve hangi kampanyaların tüm kanallar, platformlar ve cihazlarda en fazla değer ürettiğini görebilirsiniz. Temelde Tenjin panoları, pazarlama kampanyaları için gelişmiş analitik sunar.

Tenjin’in attribution verilerini Adapty’ye ileterek Adapty analitiğini, kohort ve dönüşüm analizlerinde kullanabileceğiniz ek filtreleme kriterleriyle zenginleştirirsiniz.

Bu entegrasyon iki temel şekilde çalışır:

1. Tenjin’den attribution verisi alma Entegrasyon tamamlandığında Adapty, Tenjin’den attribution verilerini toplar. Bu bilgilere Adapty Kontrol Paneli’ndeki kullanıcı profil sayfasından erişebilirsiniz.
2. Tenjin’e abonelik olayları gönderme Adapty, satın alma olaylarını gerçek zamanlı olarak Tenjin’e iletir. Bu olaylar, reklam kampanyalarınızın etkinliğini doğrudan Tenjin panosunda değerlendirmenize yardımcı olur.

Entegrasyonu kurma

Adapty’yi Tenjin’e bağlama

1. Adapty Kontrol Paneli’nde Integrations -> Tenjin sayfasını açın.

2. Entegrasyonu etkinleştirmek için geçiş düğmesini açın.

   

3. Tenjin Dashboard’a giriş yapın.

4. Gezinme menüsünde Configuration -> Apps bölümüne gidin.

   

5. Platformunuza (iOS veya Android) ait uygulamayı seçin ve App and SDK sekmesine gidin.

6. App and SDK sekmesinde, SDK Key sütunundaki Copy butonuna tıklayın. Henüz bir SDK anahtarınız yoksa Generate SDK Key butonuna tıklayarak bir tane oluşturun.

   

7. Adapty Kontrol Paneli’ne dönün ve kopyaladığınız SDK Anahtarını ilgili platform alanına yapıştırın:

   • iOS uygulamaları için: iOS SDK Key veya iOS Sandbox SDK Key alanına yapıştırın
   • Android uygulamaları için: Android SDK Key veya Android Sandbox SDK Key alanına yapıştırın
   Tenjin’in sunucudan sunucuya entegrasyon için özel bir Sandbox modu yoktur. Hem production hem de sandbox olayları için ayrı bir Tenjin uygulaması veya aynı anahtarı kullanabilirsiniz.

   

8. Her iki platformda da uygulamanız varsa 5-7. adımları diğer platform için tekrarlayın.

9. (isteğe bağlı) Gerekirse How the revenue data should be sent bölümünü düzenleyin. Ayarların ayrıntılı açıklaması için Integration settings sayfasına bakın.

10. Kurulumu tamamlamak için Save butonuna tıklayın.

Adapty artık satın alma olaylarını Tenjin’e gönderecek ve attribution verilerini alacaktır. Events names bölümünden olay paylaşımını ayarlayabilirsiniz.

Olayları ve etiketleri yapılandırma

Tenjin yalnızca satın alma ve Trial started olaylarını kabul eder. Events names bölümünde, takip hedeflerinize uygun olarak Tenjin ile hangi olayları paylaşacağınızı seçin.

Uygulamanızı Tenjin’e bağlama

Tenjin’den attribution verilerini almak ve Adapty’ye iletmek için Adapty.updateAttribution() SDK metodunu kullanın.

func updateTenjinId() {
    guard let tenjinId = TenjinSDK.getAnalyticsInstallationId() else { return }

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

func updateTenjinAttribution() {
    let instance = TenjinSDK.getInstance("<YOUR_TENJIN_API_TOKEN>")
        
    instance?.getAttributionInfo { info, _ in
        guard let info else { return }

        Task {
            do {
                try await Adapty.updateAttribution(info, source: "tenjin")
            } catch {
                // handle the error
            }
        }
    }
}

Adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", tenjinSdk.analyticsInstallationId) { error ->
    if (error != null) {
        // handle the error
    }
}

tenjinSdk.getAttributionInfo { attribution ->
    if (attribution == null) return@getAttributionInfo

    Adapty.updateAttribution(attribution, "tenjin") { error ->
        if (error != null) {
            // handle the error
        }
    }
}

Adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", tenjinSdk.getAnalyticsInstallationId(), error -> {
    if (error != null) {
        // handle the error
    }
});

tenjinSdk.getAttributionInfo(attribution -> {
    if (attribution == null) return;

    Adapty.updateAttribution(attribution, "tenjin", error -> {
        // handle the error
    });
});

try {
    final tenjinId = await TenjinSDK.instance.getAnalyticsInstallationId();
    
    if (tenjinId != null) {
        await Adapty().setIntegrationIdentifier(
            key: 'tenjin_analytics_installation_id', 
            value: tenjinId,
        );
    }

    final attribution = await TenjinSDK.instance.getAttributionInfo();
    if (attribution != null) {
        await Adapty().updateAttribution(attribution, source: 'tenjin');
    }
} catch (e) {
    // handle the error
}

using AdaptySDK;
using System.Linq;

BaseTenjin instance = Tenjin.getInstance("<SDK_KEY>");
var tenjinId = instance.GetAnalyticsInstallationId();

Adapty.SetIntegrationIdentifier(
    "tenjin_analytics_installation_id",
    tenjinId,
    (error) => {
        // handle the error
    });

instance.GetAttributionInfo((attribution) => {
    var dynamicAttribution = attribution.ToDictionary(
        kvp => kvp.Key,
        kvp => (dynamic)kvp.Value
    );
                
Adapty.UpdateAttribution(
    dynamicAttribution,
    "tenjin",
    (error) => {
        // handle the error
    });
});

// ...
const posthog = usePostHog()

// ...
try {
  await adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", await Tenjin.getAnalyticsInstallationId());
} catch (error) {
  // handle `AdaptyError`
}

Olay yapısı

Adapty, seçilen olayları Tenjin Integration page üzerindeki Events names bölümünde yapılandırıldığı şekilde Tenjin’e gönderir. Her olay aşağıdaki yapıya sahiptir:

{
  "price": 99.0,
  "locale": "en-US",
  "country": "ME",
  "postcut": "false",
  "currency": "USD",
  "platform": "ios",
  "quantity": 1,
  "bundle_id": "com.adapty.adaptydemoapp",
  "ip_address": "127.0.0.1",
  "os_version": "18.1.1",
  "product_id": "month.premium.99",
  "app_version": "3.2.0",
  "sdk_version": "server",
  "device_model": "iPhone 13 Mini",
  "advertising_id": "00000000-0000-0000-0000-000000000000",
  "os_version_release": "18.1.1",
  "developer_device_id": "00000000-0000-0000-0000-000000000000",
  "analytics_installation_id": "00000000-0000-0000-0000-000000000000"
}

Parametreler: