Tenjin entegrasyonu

Tenjin, uygulama geliştiricileri ve pazarlamacılar için bir mobil attribution ve analitik platformudur. Uygulama performansı ve kullanıcı davranışına ilişkin ayrıntılı bilgiler sunarak kullanıcı edinme kampanyalarını ölçmenizi ve optimize etmenizi sağlayan araçlar içerir. Şeffaf ve esnek yapısıyla Tenjin, reklam ağlarından ve uygulama mağazalarından gelen verileri bir araya getirerek ekiplerin ROI analizini yapmasına, dönüşümleri takip etmesine ve temel performans metriklerini izlemesine olanak tanır. Abonelik etkinliklerini Tenjin’e ileterek dönüşümlerin tam olarak nereden geldiğini ve hangi kampanyaların tüm kanallar, platformlar ve cihazlar genelinde en fazla değer getirdiğini görebilirsiniz. Temelde Tenjin kontrol panelleri, pazarlama kampanyaları için gelişmiş analitik sunar.

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

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

1. Tenjin’den attribution verisi alma Entegrasyon tamamlandıktan sonra Adapty, Tenjin’den attribution verisi toplar. Bu bilgilere Adapty Kontrol Paneli’ndeki kullanıcı profil sayfasından erişebilirsiniz.
2. Tenjin’e abonelik etkinlikleri gönderme Adapty, satın alma etkinliklerini gerçek zamanlı olarak Tenjin’e gönderir. Bu etkinlikler, reklam kampanyalarınızın etkinliğini doğrudan Tenjin’in kontrol panelinde değerlendirmenize yardımcı olur. | Entegrasyon özelliği | Açıklama | | -------------------------- | ------------------------------------------------------------ | | Zamanlama | Gerçek zamanlı | | Veri yönü |

   İki yönlü iletim:

   • Adapty olayları: Adapty sunucusundan Tenjin sunucusuna
   • Tenjin attribution: Tenjin SDK’dan Adapty sunucusuna
   | | Adapty entegrasyon noktası |
   • Mobil uygulama kodunda Tenjin ve Adapty SDK’ları
   • Adapty sunucusu
   |

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
   Info

   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ğlayın

Tenjin’den attribution verisini almak ve Adapty’ye iletmek için Adapty.updateExternalAttribution() SDK metodunu (SDK sürüm 4.1 öncesinde updateAttribution() olarak adlandırılıyordu) kullanın.

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

    do {
        try await Adapty.setIntegrationIdentifier(.tenjinAnalyticsInstallationId(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.updateExternalAttribution(info, provider: .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:

Sorun Giderme

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

Tenjin yalnızca Etkinlikleri ve etiketleri yapılandır bölümünde listelenen etkinlikleri kabul eder. Diğer tüm etkinlikler Event Feed’de bir satır olarak görünür ve “The event type is not supported for integration.” (Bu etkinlik türü entegrasyon için desteklenmiyor.) açıklamasıyla başarısız teslimat olarak işaretlenir. Bu durum, Events names bölümünde hiç yer almayan access_level_updated etkinliğini de kapsar; çünkü bu etkinlik yalnızca webhook entegrasyonuna özeldir.