English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

App Store entegrasyonuyla ilgili sorunları giderme

Bu makale, App Store entegrasyonuyla ilgili sık karşılaşılan sorunları ele almaktadır. Aşağıdaki her bölümde belirtiler, temel neden ve çözüm yolu açıklanmaktadır.

Kimlik bilgilerini kaydederken “The provided field values are incorrect” hatası

In-App Purchase kimlik bilgilerini kaydettiğinizde, Adapty In-app purchase Issuer ID, In-app purchase Key ID ve .p8 dosyasını kullanarak bir kimlik doğrulama token’ı oluşturur ve bunu Apple’a karşı doğrular. Bu hata, Apple’ın token’ı reddettiği anlamına gelir. Değerleri şu sırayla kontrol edin:

  1. Anahtar türü. Anahtar, App Store Connect’te Users and Access → Integrations → In-App Purchase bölümündeki bir In-App Purchase anahtarı olmalıdır. Team keys sekmesindeki anahtar (App Store Connect API anahtarı) kendine ait bir Issuer ID ve Key ID’ye sahiptir; ancak Apple bu anahtarı burada reddeder — o anahtar yapılandırmanın 6. adımına aittir.
  2. Aynı hesap ve ekip. Issuer ID, Key ID ve .p8 dosyası, uygulamayla aynı App Store Connect ekibinden gelmelidir. Başka bir ekibin hesabında (örneğin bir ajans hesabı) oluşturulan bir anahtar doğrulamayı geçemez.
  3. .p8 dosyasının kendisi. Dosyayı App Store Connect’ten indirildiği hâliyle yükleyin. Yapıştırılan anahtar içeriğinden yeniden oluşturulan bir dosya çoğunlukla başarısız olur. App Store Connect anahtarı yalnızca bir kez indirmenize izin verir; bu yüzden orijinal dosya kaybedilirse yeni bir anahtar oluşturun.
  4. Bundle ID. Bundle ID, App Store Connect’teki uygulamanızın bundle ID’siyle tam olarak eşleşmelidir — boşluk içermeyen, ters DNS formatında; örneğin com.company.app.
  5. Gizli karakterler. Her ID’yi doğrudan App Store Connect’ten yeniden kopyalayın. Fazladan boşluklar veya birbirine benzeyen karakterler (örneğin 1 rakamı yerine küçük l harfi) doğrulamanın başarısız olmasına neden olur.

Bu doğrulama yalnızca üç In-App Purchase anahtarı alanını ve Bundle ID’yi kullanır. App-Specific Shared Secret ile App Store Connect API anahtarı bu süreçte yer almaz; dolayısıyla bunlardan herhangi birini yeniden girmek sonucu değiştirmez.

Ürünler görünmüyor

İki farklı belirti aynı temel nedene işaret eder:

  • App Store Connect API anahtarı doğru yapılandırılmış, ancak Adapty ürünleri hiç çekemiyor.
  • Ürünler App Store Connect’te mevcut ama Adapty’de görünmüyor ya da beklenenden az ürün çıkıyor. SDK, satın alma denemelerinde “Product Id not found” hatası veriyor. En yaygın temel neden imzalanmamış Apple sözleşmeleri — ücretli sözleşme, vergi formları veya bankacılık formları beklemede ya da imzalanmamış durumda. Sözleşmeler beklemedeyken App Store Connect API, ürünle ilgili endpoint’lerde sessizce 403 döndürür. Adapty’ye herhangi bir hata iletilmez; ürünler sessizce filtrelenir.

App Store Connect → Agreements, Tax, and Banking bölümüne gidin ve beklemedeki tüm sözleşmeleri imzalayın. Ardından Adapty’nin App settings → iOS SDK bölümünde yeniden senkronize edin.

App Store Sunucu Bildirimleri “Delayed” Olarak Görünüyor

App Store Connect’te App Store Sunucu Bildirimleri durumu Delayed olarak görünebilir. Bu, Apple’ın abonelik olayı bildirimlerini — yenilemeler, iptaller ve ödeme sorunları — gecikmeli gönderdiği anlamına gelir; bu bildirimler kuyruğa alınır ve geç ulaşır.

Kurulum istatistikleri bundan etkilenmez. Adapty, kurulumları sunucu tarafı bildirimlerinden değil, uygulamanın ilk açılışından itibaren sayar.

Yenileme veya iptal verileri gecikmeli geliyorsa, bunun en olası nedeni Delayed durumudur. Bu durum genellikle Apple birikmiş bildirimleri işledikçe otomatik olarak düzelir.

Satın alma başarılı ama müşteri erişimini kaybediyor

Müşteri ödeme yapıyor ve kısa bir süre erişimi oluyor, ancak uygulamanız Adapty’den profili bir sonraki yenileyişinde erişimini kaybediyor. Apple ödemeyi aldı, ancak işlem henüz Adapty’e ulaşmadı — ulaşana kadar profilde access level yok ve satış raporlarınızda görünmüyor.

Bunun nedeni genellikle şunlardan biridir:

  • Bir kimlik bilgisi çalışmayı durdudu: Adapty, işlemi Apple ile doğrulayamadı. Güncellemeler gelmeyi durursa bölümündeki kimlik bilgilerini gözden geçirin ve satın alma doğrulamasını kapsayan olanı değiştirin.
  • Ürün Adapty’de bağlı değil: Müşterinin satın aldığı mağaza ürün kimliği, bir Adapty ürününe bağlı değil; dolayısıyla tanımlanmış bir access level yok. Ürünün tam App Store Product ID ile mevcut olduğunu ve kendisine bir access level atandığını doğrulayın.

Adapty SDK işlemi yeniden denemeye devam eder, dolayısıyla Adapty kaydı tamamlayabildiğinde erişim yeniden sağlanır.

Adapty’deki fiyatlar App Store ile eşleşmiyor

Adapty’nin ürün düzenleme sayfasındaki price alanı, ürünün nasıl eklendiğine bağlı olarak farklı davranır.

Adapty’de bir ürün oluşturup kontrol panelinden mağazaya gönderirseniz, bu fiyat başlangıç mağaza fiyatı olarak kullanılır. Mağazada zaten mevcut olan bir ürün eklerseniz, bu fiyat yalnızca bir yer tutucudur. Adapty’nin analizleri, entegrasyonları ve SDK, gerçek fiyatları App Store’dan çekerek kullanır. App Store’daki fiyat değişiklikleri yer tutucuyu güncellemek için geri senkronize edilmez ve şu an için yer tutucuyu kontrol panelinden düzenleyemezsiniz.

CSV fiyat dışa aktarımı boş

CSV fiyat dışa aktarımınız yalnızca sütun başlıklarını döndürdüyse, App Store Connect API anahtarınız tam olarak yapılandırılmamış demektir. Bkz. 6. Adım — App Store Connect API anahtarı ekleme.

App Store’a yeni ürün gönderilemiyor

Adapty, kontrol panelinde oluşturduğunuz yeni ürünleri App Store Connect’e gönderebilir. App Store entegrasyonunuz tam olarak yapılandırılmamışsa bu seçenek engellenir. İki ayar gereklidir: