Adapty Kontrol Paneli’nde ve mobil uygulamanızda her şeyi yapılandırdıktan sonra uygulama içi satın alma testlerini yapmaya hazırsınız. Not: Test araçlarının hiçbiri, kullanıcılardan ürün satın alma testi sırasında ücret almaz. App Store, test ortamlarında gerçekleştirilen satın alma veya iade işlemleri için e-posta göndermez.

Sandbox testi

Uygulama içi satın almaları test etmenin iki ana yolu vardır:

• Xcode’da derleyip test cihazında çalıştırmak: Geliştiriciler ve QA mühendisleri için idealdir.
• TestFlight ile sandbox test hesabı kullanmak: Diğer herkes için uygundur.

Her iki seçenek de aşağıdaki kılavuzda ele alınmaktadır.

Adım 1. App Store Connect’te Sandbox test hesabı oluşturma

Birkaç tıklamayla yeni bir Sandbox test hesabı oluşturabilirsiniz:

1. App Store Connect’te Users and Access > Sandbox > Test Accounts bölümüne gidin ve + düğmesine tıklayın.

2. Test kullanıcısının bilgilerini girin. Test etmeyi planladığınız Country or Region seçeneğini mutlaka belirtin; bu seçenek, ilgili bölgedeki ürün erişilebilirliğini ve satın alma para birimini etkiler.

3. Create’e tıklayın.

Adım 2. Geliştirici modunu etkinleştir

Xcode yüklü bir Mac ve test cihazı kablosuna ihtiyacınız olacak:

1. Mac’inizde Xcode’u açın. TestFlight ile uygulama içi satın almaları test edecekseniz yalnızca Xcode’un yüklü olması yeterlidir; uygulamanın orada açık olmasına gerek yoktur.
2. Test cihazınızı kablo ile Mac’e bağlayın.
3. Test cihazınızda Settings > Privacy & Security > Developer Mode yoluna gidin ve Developer Mode’u açın.

Adım 3. Uygulamayı TestFlight’tan indirin

Uygulamanızı TestFlight’a gönderme hakkında ayrıntılı bilgi için Apple belgelerine bakın.

TestFlight uygulamasını indirmeden önce test cihazınızda üretim Apple Hesabınızla oturum açtığınızdan emin olun. Ardından test etmek istediğiniz uygulamayı TestFlight’tan indirin.

Adım 4. Sandbox test hesabına geçin

Mac kullanmıyor musunuz? İşte size özel bir ipucu

macOS üzerinde çalışmıyorsanız, Xcode aracılığıyla sandbox hesabına geçemezsiniz. Ancak bunu test cihazınızda doğrudan yapabilirsiniz:

1. Test cihazınızda Settings > Your Apple Account > Media & Purchases bölümüne gidin.
2. Açılan menüden Sign Out seçeneğini seçin.
3. TestFlight’tan indirilen uygulamayı açın ve bir ürün satın almayı deneyin.
4. Oturum açmanız istendiğinde, sandbox ortamına geçmek için sandbox hesabı bilgilerinizi girin.

Sandbox hesabınıza geçmek için:

1. Test cihazınızda Settings > Your Apple Account > Media & Purchases bölümüne gidin.
2. Açılan menüden Sign Out seçeneğini seçin.
3. Settings > Developer bölümüne gidin. Eğer Developer seçeneği görünmüyorsa, 2. adımda etkinleştirdiğinizden emin olun.

4. Sandbox Apple Account bölümüne gidin ve Sign In düğmesine dokunun.

5. Sandbox Apple Account bilgilerinizle giriş yapın.

Adım 5. Satın alma geçmişini temizle

Yeni bir Sandbox test hesabı oluşturup bu hesaba geçiş yaptıysanız, bu adımı atlayabilirsiniz; çünkü bu adım yalnızca aynı Sandbox test hesabıyla tekrarlanan testler için geçerlidir.

1. Test cihazınızda Settings > Developer > Sandbox Apple Account bölümüne gidin.
2. Açılan menüden Manage seçeneğini belirleyin.
3. Account Settings bölümüne gidip Clear Purchase History öğesine dokunun.

Adım 6. Xcode’da derleyin ve çalıştırın

1. Test cihazınızı Mac’inize bağlayın.
2. Xcode’u açın.
3. Uygulamayı bağlı cihazda derleyip çalıştırmak için araç çubuğundaki Run düğmesine tıklayın ya da Product > Run yolunu izleyin.

Derleme başarılı olursa Xcode, uygulamayı cihazınızda başlatır ve hata ayıklama alanında bir hata ayıklama oturumu açar.

Uygulamanız artık cihazda test edilmeye hazır.

Adım 7. Test satın alması yapın

Uygulamayı açın ve bir paywall üzerinden test satın alması gerçekleştirin.

İşlem tamamlandıktan sonra, sonuçlarınızı kontrol etmek için test satın almalarını doğrulama makalesine gidin.

Adım 8. Test etmeye devam edin

Artık test ortamınız tamamen hazır. Tekrar test etmek istiyorsanız, sandbox hesabının satın alma geçmişini temizleyin.

Test sorunları

Aşağıda bir uygulamayı test ederken karşılaşabileceğiniz yaygın sorunlar listelenmiştir.

TestFlight sorunları

Sandbox test hesabı kullanmadan TestFlight kullanırsanız satın alma geçmişinizi temizleyemezsiniz; bu durum çeşitli sorunlara ve hatalı test sonuçlarına yol açar.

Yanlışlıkla Sandbox test hesabına geçmeyi unutup uygulamayı bir kez bile açtıysanız, TestFlight satın alma geçmişinizi üretim Apple hesabınıza bağlar ve beklenmedik sorunlara neden olur.

Düzeltmek için şu adımları izleyin:

1. Uygulamayı test cihazından kaldırın.
2. Sandbox testi adımlarını takip edin.

Paylaşılan access level sorunları

Aynı Sandbox test hesabıyla tekrar test yaparsanız, test kullanıcısı için paylaşılan access level’larla beklenmedik davranışlarla karşılaşabilirsiniz.

Kullanıcının devralınan bir access level’a sahip olup olmadığını kontrol etmek için Adapty Kontrol Paneli’nden Profiles & Segments sayfasına gidin ve kullanıcının profilini açın.

The user wants me to translate a fragment of MDX documentation from English to Turkish. Let me analyze what needs to be translated and what needs to be preserved.

1. The <Zoom> component with the <img> tag - preserve the JSX exactly, only translate attribute values that are human-readable phrases (but here there are no human-readable attribute values to translate)
2. The prose text after the component needs to be translated.

Let me translate the prose: “If the user has an inherited access level, follow these steps for accurate testing results:”

Turkish translation: “Kullanıcının miras alınan bir access level’ı varsa, doğru test sonuçları için şu adımları izleyin:”

Note: “access level” stays as “access level” per glossary.

Kullanıcının miras alınan bir access level’ı varsa, doğru test sonuçları elde etmek için şu adımları izleyin:

1. Üst profili silin.
2. Uygulamayı test cihazından kaldırın.
3. Uygulamayı TestFlight’tan indirin.
4. Sandbox test hesabına geçin.
5. Satın alma geçmişini temizleyin.
6. Uygulamayı açın ve test satın alımınızı yapın.

TestFlight’ta uygulamayı güncelleme

TestFlight uygulaması güncellendiyse:

1. Uygulamayı test cihazından kaldırın.
2. Uygulamayı TestFlight’tan indirin.
3. Sandbox test hesabına geçin.
4. Satın alma geçmişini temizleyin.
5. Uygulamayı açın ve test satın alımınızı gerçekleştirin.

Test kullanıcısının aboneliğini sıfırlama

Sandbox ortamında bir satın alma, Adapty profiline değil Apple sandbox hesabına aittir. Profilde yaptığınız işlemler (profili silmek veya access level düzenlemek), satın almayı mağaza hesabından kaldırmaz. Sonraki yeniden yükleme veya senkronizasyonda SDK aynı işlemi yeniden profille ilişkilendirir ve test kullanıcısı erişimini geri kazanır.

Aşağıdaki tablo, her sıfırlama işleminin neleri değiştirdiğini ve test kullanıcısının ardından ne gördüğünü göstermektedir.

Eylem	Adapty profili	Apple sandbox hesabı	Test sonrası erişim
Adapty Kontrol Paneli’nde profili sil	Silindi	Değişmedi	Geri döner — yeniden yüklemede, yeni bir profil aynı işlem zincirine yeniden bağlanır
Profil silme API’si aracılığıyla profili sil	Silindi	Değişmedi	Geri döner — Kontrol Paneli’nden silmekle aynı sonuç
Add access level ile geçmiş bir sona erme tarihi ekle	Sonraki senkronizasyonda geçersiz kılınır	Değişmedi	Sonraki yenilemede geri döner — canlı abonelik ileriki bir sona erme tarihi uygular
Erişim seviyesini iptal etme API’si çağrısı yap	Şu an sona erer, access_level_updated (is_active=false) tetiklenir	Değişmedi	Sonraki yenilemede veya yeniden yüklemede geri döner — güvenilir bir sandbox sıfırlaması değildir
Sandbox hesabındaki aboneliği iptal et	Doğrudan değişiklik yok	Abonelik iptal edildi	Yenilemeler durur, mevcut dönem sona erdiğinde erişim biter ve test kullanıcısı ürünü yeniden satın alabilir
Yeni bir Apple sandbox hesabıyla giriş yap	Yeni profil	Yeni, boş hesap	Temiz — tekrar test için önerilir

Bir test kullanıcısını temiz duruma sıfırlama

Tekrarlayan satın alma akışı testleri için profili sıfırlamak yerine her test için yeni bir Apple sandbox hesabı kullanın. Hesabı oluşturmak için 1. Adım’ı, cihazda hesaba geçmek için ise 4. Adım’ı takip edin. Mevcut bir sandbox hesabını yeniden kullanıyorsanız önce satın alma geçmişini temizleyin — Adapty profilini silmek bunu temizlemez.

Mevcut bir test kullanıcısının erişimini kaldırma

Bir test kullanıcısının erişimini kaldırmak için bitiş tarihini geriye almayın ya da Revoke access level API’ını çağırmayın. Sandbox ortamında abonelik her birkaç dakikada bir otomatik yenilenir. Her yenileme, aynı işlem zincirinde ilerleyen bir bitiş tarihi ayarlar; bu nedenle erişim kendiliğinden geri gelir. Revoke access level API bir access_level_updated (is_active=false) olayı tetikler, ancak bir sonraki yenileme bunu geçersiz kılar. Erişimi gerçekten durdurmak için aboneliği mağaza tarafında iptal etmeniz gerekir. Test cihazında Settings > Developer > Sandbox Apple Account yolunu izleyin, Manage seçeneğine tıklayın ve aboneliği iptal edin. Yenilemeler durur ve mevcut dönem sona erdiğinde erişim de biter.

Profili silmek neden erişimi geri getiriyor

Bir test kullanıcısı uygulamayı yeniden yüklediğinde, Adapty sandbox hesabının satın alma geçmişini alır ve yeni yüklemeyi mevcut satın almayla ilişkilendirir. Satın alma, sildiğiniz profile değil, mağaza hesabına bağlıdır.

• Anonim profiller: customer_user_id olmadan yapılan bir yeniden yükleme, ücretli erişim paylaşımı ayarınızdan bağımsız olarak her zaman mağaza hesabının access level’ını devralır.
• Tanımlı profiller: Erişimin yeni bir customer_user_id’ye aktarılıp aktarılmayacağı, ücretli erişim paylaşımı ayarınıza bağlıdır.

Adapty’nin bu profilleri nasıl bir zincire bağladığını öğrenmek için bkz. Profiller nasıl çalışır.

Abonelikleri test etme

Sandbox test hesabı kullanarak uygulamayı test ederken, sandbox ortamında her test kullanıcısı için abonelik yenileme hızını ayarlayabilirsiniz. Abonelik yenileme hızlarını düzenleme hakkında daha fazla bilgi için Apple’ın resmi belgelerine bakın.

Varsayılan olarak, abonelikler aşağıdaki programa göre durmadan önce 12 kez yenilenir:

Abonelik süresi	1 hafta	1 ay	2 ay	3 ay	6 ay	1 yıl
Abonelik yenileme hızı	3 dakika	5 dakika	10 dakika	15 dakika	30 dakika	1 saat
Fatura Yeniden Deneme süresi	10 dakika	10 dakika	10 dakika	10 dakika	10 dakika	10 dakika
Fatura Ek Süre uzunluğu	3 dakika	5 dakika	5 dakika	5 dakika	5 dakika	5 dakika

Yenileme, ödeme yeniden denemesi ve ek süre gibi durumların uygulamanız ve backend’iniz tarafından doğru işlendiğini doğrulamak için sandbox’ı kullanın; üretim yenileme zamanlamasını tahmin etmek için değil. Yukarıdaki hızlandırılmış ve sınırlı zamanlama, üretim ortamıyla örtüşmez. Backend testleri için işlemleri sunucunuzda yeniden oynatmak istiyorsanız Set transaction API’yi kullanabilirsiniz.

Teklifleri test etme

Teklifleri test etmek için, uygunluk kontrolünün doğru çalışması amacıyla tüm kullanıcı makbuzlarının silinmesi gerekir.

Teklifleri test etmenin en güvenilir yolu, tamamen yeni bir Sandbox test hesabı kullanmaktır. Aynı Sandbox test hesabıyla tekrarlanan testler beklenmedik davranışlara yol açabilir.