FunnelFox'u Adapty'ye Bağlama
FunnelFox, App Store ve Google Play dışında aboneliklerinizi satan açılış sayfaları ve quizlerden oluşan web flow’ları oluşturur. Web’den satın alan kullanıcılara mobil uygulamanızdaki ücretli özelliklere erişim sağlamak ve onların satın almalarını mağaza satın almalarınızla aynı kontrol panelinde görmek için FunnelFox’u Adapty’ye bağlayın.
Bağlanmak için bir anahtar ve bir access level ID gerekir. Uygulamanızın ardından alıcıyı tanımlaması ve o access level’a ulaşması gerekir. Bkz. Uygulamanızda erişim sağlama.
Entegrasyon nasıl çalışır
FunnelFox, ödemeyi web üzerinden tahsil eder. FunnelFox daha sonra Adapty Sunucu Tarafı API’sini çağırarak profili oluşturur, işlemi kaydeder ve FunnelFox entegrasyon ayarlarına girdiğiniz kimliğe sahip access level’ı tanımlar. Yenilemeler, iptaller ve başarısız ödemeler aynı profili günceller. Web satın alımları, App Store ve Google Play gelirinizin yanı sıra Adapty analitiğinde görünür.
Satış huninizin sattığı her ürün için Adapty’de karşılık gelen bir ürün oluşturun. Satın alma her iki durumda da Adapty’e ulaşır; ancak ürün tanımlanmamışsa Adapty abonelik süresini bilemez; bu durumda analitik yanlış süre gösterebilir ya da satın alma kategorisiz kalabilir.
Adapty, web satın almasını bir uygulama kullanıcısıyla customer user ID üzerinden eşleştirir. FunnelFox, ödeme sırasında girilen e-posta adresini varsayılan olarak bu ID olarak kullanır.
Eğer funnel’ınız Stripe veya Paddle üzerinden faturalandırıyorsa, bu sağlayıcıyı ayrıca Adapty’ye bağlamanız gerekmez. Yalnızca funnel’larınız dışında da bu sağlayıcı üzerinden satış yapıyorsanız bağlayın; Adapty, her iki kaynaktan gelen işlemleri otomatik olarak tekilleştirir.
Aynı flow’u bir FunnelFox funnel’ı yerine kendi web ödeme sayfanıza karşı oluşturmak için bkz. Web ve mobil arasında satın almaları senkronize etme.
FunnelFox’u Bağlayın
Bağlantıyı FunnelFox tarafında, FunnelFox’un Adapty entegrasyon kılavuzunu izleyerek kurarsınız. Bu kılavuz Adapty’den iki değer ister:
- Secret API key: Adapty’de App Settings sayfasını açın ve gizli anahtarı kopyalayın.
- Access level ID: Bir satın alma işleminin sağladığı access level. Her Adapty uygulaması
premiumadında bir access level ile başlar; farklı bir şey sağlamak istiyorsanız önce oluşturun.
Tek bir funnel içinde farklı access level’lar tanımlama
Tek bir tier satan bir funnel için burada yapılacak bir şey yoktur: her satın alma, entegrasyon ayarlarındaki access level’ı verir.
Tek bir funnel’dan birden fazla tier satmak için checkout öğesindeki Custom entitlement alanını kullanın. Bu alan, söz konusu öğe üzerinden gerçekleşen satın almalarda entegrasyon ayarlarındaki access level ID’sini geçersiz kılar. Bir funnel, bir Wallet düğmesi ve bir akordeon checkout gibi birden fazla checkout öğesi içerebilir. Her birinin kendine ait Custom entitlement alanı vardır; bu nedenle geçersiz kılmayı uygulaması gereken her öğede bu alanı doldurun.
Entegrasyon ayarlarını veya herhangi bir Custom entitlement değerini değiştirdikten sonra flow’u yeniden yayınlayın. Yayınlanmış bir flow, siz yeniden yayınlayana kadar önceki yapılandırmasıyla çalışmaya devam eder.
Uygulamanızda erişim sağlama
Web üzerinden satın alma yapan bir kullanıcıya ücretli özelliklerin kilidini açmak için, FunnelFox’un kullandığı customer user ID ile Adapty.activate() veya Adapty.identify() çağrısı yapın. Varsayılan olarak bu ID, alıcının ödeme sırasında girdiği e-posta adresidir. Çağrı için Kullanıcıları tanımlama iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform ve Capacitor belgelerine bakın.
Funneldeki bir bağlantı üzerinden uygulamayı yüklemek alıcıyı otomatik olarak tanımlamaz. Uygulamanız eşleşen ID ile Adapty.identify() çağırana kadar, access level’ı tutan profil ile uygulamanın oluşturduğu profil ayrı kalır ve uygulama ücretli erişimi göstermez. Ödeme e-postasıyla oturum açmak bu ikisini eşleştirir.
Oturum açma adımı olmadan erişimin kilidini açmak için, funnel’daki customer user ID’yi ertelenmiş derin bağlantı (deferred deep link) aracılığıyla uygulamaya iletip ilk açılışta bu ID ile Adapty.identify() çağırın.
Ardından özelliklerin kilidini açmak için profilden access level’ı okuyun. Bkz. Abonelik durumunu kontrol etme iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform ve Capacitor .
Entegrasyonu test edin
- Funnel’ınızda bir satın alma işlemi tamamlayın.
- Adapty’de Profiles sayfasını açın ve FunnelFox’un kullandığı müşteri kullanıcı kimliğiyle profili bulun.
- FunnelFox entegrasyon ayarlarına girdiğiniz ID’ye sahip access level’ın ilgili profilde aktif olduğunu doğrulayın.
- Uygulamanızı açın, aynı kullanıcıyı tanımlayın ve ücretli özelliklerin kilidinin açıldığını onaylayın.
Sorun Giderme
Web’den satın alan bir kullanıcı uygulamayı ücretli erişim olmadan açıyor
Uygulamanız alıcıyı tanımlamamış. FunnelFox, varsayılan olarak ödeme e-postasını kullandığı ID ile anahtarlanan bir profile access level tanımladı; ancak uygulamanız farklı bir profil okuyor. Uygulamanızda erişim sağlama bölümünde açıklandığı gibi o ID ile Adapty.identify() çağrısı yapın.
Diğer FunnelFox entegrasyonları
FunnelFox, her biri ayrı ayrı kurulan üç Adapty ürününe bağlanır.
| Ürün | FunnelFox’un Adapty’ye gönderdiği veriler | Kurulum kılavuzu |
|---|---|---|
| Core | Web satın alımlarının uygulamayı açabilmesi için profiller, işlemler ve access level’lar | Bu makale |
| Adapty Attribution | Kampanya, funnel ve deney verileri içeren işlem olayları | FunnelFox’u Adapty Attribution ile entegre etme |
| Adapty Mail | E-posta adresleri, satın alma geçmişi ve abonelik olayları | FunnelFox’u Adapty Mail’e bağlama |