App Store entegrasyonunu yapılandırma
iOS uygulamanızı Adapty’ye bağlamak için App settings > iOS SDK bölümüne App Store kimlik bilgilerini girin. Adapty bunun ardından:
- Satın almaları doğrular.
- Abonelik etkinliklerini alır.
- Ürünlerinizi App Store Connect ile senkronize tutar.
Satın alımlar veya abonelik olayları Adapty’ye ulaşmayı durdurursa, her kimlik bilgisini kontrol edin.
Başlamadan önce:
- Hedef uygulamaya App Store Connect’te erişiminiz olması gerekir. Uygulama henüz orada değilse, App Store Connect’i kurun. Platforma erişiminiz yoksa, yetkili kişiden talep edin.
- Ekibinizin App Store Connect API’sine erişimi olması gerekir; bu, gerekli erişim anahtarını oluşturmak için zorunludur. Ekibinizde henüz yoksa, Hesap Sahibinden talep etmesini isteyin. Apple her talebi inceler.
- İki tarayıcı sekmesi açın: birinde App Store Connect’teki uygulamanız, diğerinde Adapty’de App settings > iOS SDK. Bu kılavuz boyunca iki sekme arasında değerler kopyalayacaksınız.
Genel Bakış
Bu kılavuzdaki her kimlik bilgisi zorunludur. Adapty, her birini App Store ile veri alışverişinin farklı bir bölümü için kullanır. Kurulumu tamamlamak için şu yedi adımı izleyin:
- Bundle ID ve Apple App ID girin
- Uygulamaya özel paylaşılan secret girin
- Adapty’den gelen URL ile App Store sunucu bildirimlerini etkinleştirin
- In-App Purchase key ekleyin
- App Store Connect API key ekleyin
- Adapty SDK’yı yükleyin ve sandbox satın alımı yapın
- Tüm kimlik bilgilerini doğrulayın
Bundle ID ve Apple App ID’yi Girin
App Store Connect’te uygulamanızı tanımlayan iki değer vardır: Bundle ID ve Apple ID. Bu değer Adapty’de Apple App ID olarak etiketlenmiştir. Adapty, satın alma işlemlerini gerçekleştirmek için Bundle ID’ye ihtiyaç duyar. Apple ID ile Adapty:
- App Store Connect’teki ürünlerinizi bulur ve orada yeni ürünler oluşturur.
- Ürünlerinizin App Store durumunu ve fiyatlarını gösterir.
- Retention Messaging için gerçek zamanlı mesajlar sunar.
- Uygulamanızı AppsFlyer gibi attribution entegrasyonlarına tanıtır.
Apple, uygulamayı App Store Connect’e eklediğinizde Apple ID’yi atar; bu nedenle uygulamanız App Store’da yayına girmeden önce bile bu ID’yi girin.
-
Open App Store Connect. Select your app and proceed to General > App Information section.
-
Copy the Bundle ID in the General Information sub-section.
Copy only the identifier — reverse-DNS format with no spaces, for example,
com.company.app. App Store Connect shows the app name next to it in other views, like the apps list; pasting that instead of the identifier makes the connection between Adapty and the App Store fail to validate.
- Open the App settings > iOS SDK tab from the Adapty top menu and paste the copied value to the Bundle ID field.
- Get back to the App information page in App Store Connect and copy Apple ID from there.
- On the App settings > iOS SDK page in the Adapty dashboard, paste the ID to the Apple App ID field.
Uygulamaya özel paylaşılan gizli anahtarı girin
Adapty, satın alma makbuzlarını doğrulamak ve App Store Connect’te ürün oluşturmak için uygulamaya özel paylaşılan gizli anahtara ihtiyaç duyar.
-
App Store Connect’te uygulamanızın App Information sayfasını açın. App-Specific Shared Secret bölümünde Manage’e tıklayın.
-
Gizli anahtarı kopyalayın. Uygulamanın henüz bir gizli anahtarı yoksa önce Generate butonuna tıklayın. Gizli anahtar oluşturmak için App Store Connect’te Hesap Sahibi veya Yönetici rolüne sahip olmanız gerekir. Bu rollerden birine sahip değilseniz, sahip olan birinden gizli anahtarı oluşturmasını ve size göndermesini isteyin.
Uygulamayı bir uygulama transferi yoluyla almadıysanız Regenerate butonuna tıklamayın: mevcut gizli anahtar, kullanıldığı her yerde çalışmayı durdurur.
-
Adapty’de, gizli anahtarı App Store Connect shared secret alanına yapıştırın.
-
Save’e tıklayın.
Adapty’den gelen URL ile App Store sunucu bildirimlerini etkinleştirin
Ana makale: App Store sunucu bildirimlerini etkinleştirin
Apple, yenilemeler, iadeler ve diğer abonelik olayları gerçekleştiğinde Adapty’ye sunucu bildirimleri gönderir. Adapty, uygulamanız herhangi bir işlem bildirmese bile bu olayları kaydeder.
Apple bu bildirimleri zaten bir sunucuya gönderiyorsa, App Store Connect’teki URL’yi değiştirmeden önce o sunucuya yönlendirme ayarını yapın. Adapty’de, URL for forwarding raw Apple events alanına o sunucunun URL’sini girin ve Save’e tıklayın. Adapty, Apple’dan aldığı bildirimleri bu sunucuya yönlendirir.
Arka uç sisteminizin URL’sinin App Store Connect’te kalması gerekiyorsa, bildirimleri arka ucunuzdan Adapty’ye iletin.
-
Adapty’de bağladığınız uygulamayı açın: her Adapty uygulamasının kendine ait bir bildirim URL’si vardır. App settings > iOS SDK sayfasına gidin. App Store server notifications bölümünde, URL for App Store server notifications alanındaki URL’yi kopyalayın.
-
App Store Connect’te uygulamanızın App Information sayfasını açın.
-
App Store Server Notifications bölümünde Production Server URL’yi bulun. Orada zaten bir URL varsa Edit’e tıklayın. Yoksa Set Up URL’ye tıklayın.
-
Adapty’den kopyaladığınız URL’yi yapıştırın ve Save’e tıklayın.
-
Sandbox testlerinizdeki bildirimlerin Adapty’ye ulaşması için Sandbox Server URL kısmında da 3. ve 4. adımları tekrarlayın.
In-App Purchase anahtarını ekleyin
Ana makale: In-App Purchase anahtarını Adapty’ye ekleyin
Adapty, satın alımları doğrulamak ve promosyon tekliflerini imzalamak için In-App Purchase anahtarını kullanır. Henüz anahtar dosyanız yoksa önce App Store Connect’te anahtarı oluşturun. Anahtarı Adapty’ye eklemek için:
-
Issuer ID ve Key ID bilgilerini bulmak için App Store Connect’te Users and Access > Integrations > In-App Purchase sayfasına gidin. Anahtarı başkası oluşturduysa ve size Issuer ID, Key ID ile dosyayı gönderdiyse bu adımı atlayın.
-
Adapty’de App settings > iOS SDK sayfasına gidin. In-app purchase API (StoreKit 2) bölümünde alanları doldurun:
- Issuer ID: App Store Connect’teki In-App Purchase sayfasından kopyalayın.
- Key ID: In-App Purchase sayfasındaki Active listesinden, indirdiğiniz anahtarın yanından kopyalayın.
- Private key (.p8 file): İndirdiğiniz dosyayı yükleyin.
-
Adapty, promosyon tekliflerini In-App Purchase anahtarıyla imzalar. App Store promotional offers bölümünde anahtarı tekrar girin:
- Subscription key ID: 2. adımdaki Key ID.
- Subscription key (.p8 file): 2. adımdaki dosya.
Farklı bir anahtar hatasız kaydedilir, ancak kullanıcılar bu durumda promosyon tekliflerini alamaz.
-
Save’e tıklayın. Adapty, sayfayı kaydetmeden önce In-app purchase API (StoreKit 2) bölümündeki anahtarı Apple ile doğrular. Apple anahtarı reddederse sayfada “The provided field values are incorrect” hatası görünür: değerleri gözden geçirin.
App Store Connect API anahtarını ekleyin
Adapty, App Store Connect’te ürün oluşturmak ve ürünlerin durumunu ile fiyatlarını senkronize tutmak için App Store Connect API anahtarını kullanır. Bu anahtar, Uygulama İçi Satın Alma anahtarından farklıdır; ancak her ikisi de Issuer ID ve Key ID alan adlarını paylaşır.
Adapty’nin Admin erişimine sahip bir takım anahtarına ihtiyacı var. Henüz bir anahtarınız yoksa, önce App Store Connect’te bir takım anahtarı oluşturun. Anahtarı Adapty’ye bağlamak için:
-
Issuer ID ve takım anahtarının Key ID bilgilerini bulmak için App Store Connect’te Users and Access > Integrations > App Store Connect API bölümüne gidin ve Team Keys sekmesini açın. Anahtarı başkası oluşturmuşsa ve size Issuer ID, Key ID ve dosyayı gönderdiyse bu adımı atlayın.
-
Adapty’de App settings > iOS SDK bölümüne gidin. App Store Connect API key bölümünde Connect API Key düğmesine tıklayın.
-
Alanları doldurun:
- Issuer ID: App Store Connect’teki Team Keys sekmesinden kopyalayın.
- Key ID: Team Keys sekmesindeki Active listesinde, indirdiğiniz anahtarın yanından kopyalayın.
- Private key (.p8 file): Takım anahtarı için indirdiğiniz dosyayı yükleyin.
-
Bağlı bir anahtarı daha sonra değiştirebilirsiniz, ancak kaldıramazsınız. Anahtarın bu uygulamanın sahibi olan App Store Connect takımına ait olduğundan emin olun ve Connect düğmesine tıklayın. Bundan sonra her App Store Product ID’yi yazmak yerine App Store Connect’teki ürünlerinizden seçersiniz.
Adapty, bağladığınızda anahtarı Apple ile doğrulamaz. Yanlış bir anahtar, anahtar hakkında herhangi bir mesaj vermeden başarısız olur: ürünler App Store durumu göstermez ve App Store Product ID açılır menüsü boş kalır. Yanlış bir anahtarı düzeltmek için anahtarı değiştirin.
Her kimlik bilgisinin çalıştığını doğrulayın
Adapty’nin satın almaları doğruladığını onaylamak için uygulamanıza Adapty SDK’yı yükleyin ve sandbox ortamında bir satın alma yapın.
Sandbox satın alması yalnızca bazı kimlik bilgilerini kullanır. Her birini satın alma işleminin ardından ve satın almalar veya abonelik olayları Adapty’ye ulaşmayı her durduğunda doğrulayın:
- Bundle ID, Apple App ID ve App Store Connect shared secret: Bu üç değeri App Store Connect’teki App Information sayfasında yer alan Bundle ID, Apple ID ve App-Specific Shared Secret altındaki gizli anahtarla karşılaştırın.
- App Store sunucu bildirimleri: Bu bölümdeki durum, Adapty’ye bir satın alma veya yenileme bildirimi ulaştığında Active olarak görünür. Farklı bir değer gösteriyorsa sunucu URL’lerini kontrol edin.
- Uygulama içi satın alma API’si (StoreKit 2): Adapty, anahtarı kaydettiğinizde Apple ile doğrular. Uygulamanızdaki satın almalar daha sonra hiçbir erişim sağlamıyorsa anahtar çalışmayı durdurmuş olabilir: anahtarı değiştirin.
- App Store promosyon teklifleri: Subscription key ID’nin In-app purchase API (StoreKit 2) bölümündeki Key ID ile eşleştiğinden emin olun. Farklıysa her iki bölüme de aynı anahtarı girin.
- App Store Connect API anahtarı: Her App Store ürünü, Products sayfasındaki App Store status sütununda bir durum gösterir. Bir ürün tire ya da Not Connected gösteriyorsa anahtarı ve Apple App ID’yi kontrol edin.
Kurulumun hemen ardından Analytics, Event Feed’de gösterilenden daha fazla deneme ve satın alma sayabilir; bu aradaki fark profili olmayan işlemlerden kaynaklanır: Adapty SDK’sını içeren bir uygulama sürümünü henüz açmamış kullanıcıların satın almaları bunlardır.
Adapty ile mağaza raporları arasındaki diğer farklılıklar ise kimlik bilgilerinden değil, her birinin satın almaları nasıl saydığından kaynaklanır.
Sonraki adımlar
Uygulamanızı yayına hazırlamak için yayın kontrol listesini inceleyin.
Uygulamanız Google Play’de de mevcutsa, o mağazayı da bağlayın.