App Store entegrasyonunu yapılandırma

Bu bölümde, iOS uygulamanız için App Store ile Adapty arasındaki bağlantının nasıl kurulacağı anlatılmaktadır. Bu bağlantı, abonelik analizlerini gösterebilmemiz ve satın alımları doğrulayabilmemiz için gereklidir. Entegrasyonu ilk onboarding sırasında veya daha sonra Adapty Kontrol Paneli’ndeki App Settings bölümünden tamamlayabilirsiniz.

İlk onboarding sırasında mobil uygulamanız ile Adapty entegrasyonunu yapılandırmış olsanız bile bu ayarları daha sonra App settings bölümünden değiştirebilirsiniz.

Yapılandırma değişiklikleri, Adapty SDK yüklü mobil uygulamanız yayına girene kadar Sandbox aşamasında güvenle yapılabilir. Yayın sonrasında yapılan değişiklikler uygulamanızdaki satın alma akışını bozabilir.

Adım 1. Bundle ID ve Apple uygulama ID’sini girin

Bundle ID, uygulamanızın App Store’daki benzersiz tanımlayıcısıdır. Abonelik işleme gibi Adapty’nin temel işlevleri için zorunludur.

  1. App Store Connect’i açın. Uygulamanızı seçin ve General → App Information bölümüne gidin.

  2. General Information alt bölümündeki Bundle ID’yi kopyalayın.

  1. Adapty üst menüsünden App settings -> iOS SDK sekmesini açın ve kopyaladığınız değeri Bundle ID alanına yapıştırın.
  1. App Store Connect’teki App information sayfasına geri dönün ve oradan Apple ID’yi kopyalayın.
  2. Adapty kontrol panelindeki App settings -> iOS SDK sayfasında, ID’yi Apple app ID alanına yapıştırın.

Adım 2. Issuer ID ve Key ID’yi girin

In-app purchase Issuer ID, App Store Connect’te Issuer ID olarak geçer ve kimlik doğrulama tokenını oluşturan sağlayıcıyı tanımlayan özel bir ID’dir. In-App Purchase Key ID, App Store Connect’te Key ID olarak geçer ve App Store Connect’te In-App Purchase Key Oluşturma bölümünde oluşturduğunuz kriptografik anahtarla ilişkili benzersiz bir tanımlayıcıdır.

  1. App Store Connect’i açın. Users and Access → Integrations → In-App Purchase bölümüne gidin.
  2. Active listesinde, App Store Connect’te In-App Purchase Key Oluşturma bölümünde oluşturduğunuz anahtarı bulun.
19a2868-issuer_apple.webp
  1. Issuer ID’yi kopyalayıp Adapty Kontrol Paneli’ndeki In-app purchase Issuer ID alanına yapıştırın.
c2b42e7-issuer_id.webp
  1. Key ID’yi kopyalayıp Adapty Kontrol Paneli’ndeki In-app purchase Key ID alanına yapıştırın.

Adım 3. In-App Purchase Key dosyasını yükleyin

App Store Connect’te In-App Purchase Key Oluşturma bölümünde indirdiğiniz In-App Purchase Key dosyasını

88cdfff-download_inapp_file.webp

Adapty Kontrol Paneli’ndeki Private key (.p8 file) alanına yükleyin.

253b840-in-app_file_upload.webp

Adım 4. Deneme süreleri ve özel teklifler için – promosyon tekliflerini ayarlayın

Bu adım, uygulamanızda deneme süresi veya başka promosyon teklifleri varsa zorunludur.

  1. Adım 2’de kullandığınız Key ID’yi App Store promotional offers bölümündeki Subscription key ID alanına kopyalayın.
  2. Adım 3’te kullandığınız In-App Purchase Key dosyasını App Store promotional offers bölümündeki Subscription key (.p8 file) alanına yükleyin.
promo-key.webp

Adım 5. App Store paylaşılan sırrını girin

App Store shared secret, aynı zamanda App Store Connect Shared Secret olarak da bilinir; uygulama içi satın almalar ve abonelik makbuzu doğrulaması için kullanılan 32 karakterlik onaltılık bir dizedir.

  1. App Store Connect’i açın. Uygulamanızı seçip General → App Information bölümüne gidin.

  2. App-Specific Shared Secret alt bölümüne kadar aşağı kaydırın.

2bd112a-shared_secret_apple.webp

App-Specific Shared Secret alt bölümü görünmüyorsa Account Holder veya Admin rolüne sahip olduğunuzdan emin olun. Admin rolünüz olmasına rağmen bu alt bölümü göremiyorsanız, uygulamanın Account Holder’ından (App Store Connect’te uygulamayı oluşturan kişiden) uygulama için App Store paylaşılan sırrını oluşturmasını isteyin. Bundan sonra alt bölüm Admin’lere de gösterilecektir.

  1. Manage düğmesine tıklayın.
2d8b4c0-shared_secret_apple_copy.webp

  1. Açılan App-Specific Shared Secret penceresinde Shared Secret’i kopyalayın. Paylaşılan sır görünmüyorsa önce mevcut olan Manage veya Generate düğmesine tıklayın, ardından Shared Secret’i kopyalayın.

  2. Kopyaladığınız Shared Secret’i Adapty Kontrol Paneli’ndeki App Store shared secret alanına yapıştırın.

4f9624d-shared_secret.webp
  1. Değişiklikleri kaydetmek için Adapty Kontrol Paneli’nde Save düğmesine tıklayın.

Adım 6. App Store Connect API anahtarı ekleyin

Adapty kontrol panelinden App Store’daki ürünlerinizi yönetebilmek için bir App Store Connect API anahtarı oluşturun ve Adapty’ye ekleyin:

  1. App Store Connect’te Users and Access > Integrations > Team keys bölümüne gidin ve + düğmesine tıklayın.
app-store-connect-api.webp
  1. Generate API key penceresinde anahtar için bir ad girin ve Admin erişimi verin.
generate-api-key.webp
  1. Anahtarınızın yanındaki Download düğmesine tıklayın. Anahtarı yalnızca bir kez indirebileceğinizi unutmayın.
download-api-key.webp
  1. Adapty kontrol panelinde App settings > iOS SDK bölümüne gidin ve Connect API key düğmesine tıklayın.
connect-api-key.webp
  1. Açılan penceredeki alanları doldurun:
issuer-id.webp
key-id.webp
  • API key: App Store Connect’ten indirdiğiniz API anahtar dosyasını yükleyin.
app-store-connect-key.webp
  1. Connect düğmesine tıklayın.

Sıradaki adım