İçeriğe geç

App Store Connect API

App Store Connect API ile fiyatları değiştirme

App Store Connect’teki fiyatlandırma ekranlarının yaptığı her şey API üzerinden de yapılabilir. Bu rehber harita niteliğinde: hangi kaynaklar var, istekler neye benziyor, dünya çapında bir değişiklik kaç çağrı sürüyor ve pratikte neler ters gidiyor.

Güncellendi: 7 dk okuma

Kısa yanıt

App Store Connect API ile bir fiyatı değiştirmek için ürünün fiyat noktalarını temel bölgeniz için alın, yeni fiyata uyan noktayı seçin, ardından bir fiyat takvimi oluşturun: uygulamalar için POST /v1/appPriceSchedules, uygulama içi satın almalar için POST /v1/inAppPurchasePriceSchedules, abonelikler için bölge başına bir POST /v1/subscriptionPrices. Bir ekip API anahtarıyla imzalanmış bir JWT ile kimlik doğrulayın.

Kimlik doğrulama

Her istek, API anahtarınızın .p8 özel anahtarıyla imzaladığınız bir bearer JWT taşır (Apple: belirteç üretme):

  • Başlık: alg = ES256, kid = Key ID’niz, typ = JWT.
  • Yük: iss = Issuer ID’niz, iat = şimdi, exp = en fazla 20 dakika sonrası, aud = appstoreconnect-v1. İsteğe bağlı bir scope, bir belirteci listelenen GET istekleriyle sınırlayabilir.
  • Süresi dolana kadar birçok istek için tek bir belirteci yeniden kullanın; Apple bunu performans için önerir. Uzun işler belirli aralıklarla yeni bir belirteç üretir.
  • Anahtarın fiyatlandırmayı yönetebilen bir role ihtiyacı var: Admin veya App Manager (Apple’ın yardım sayfaları gerekli rol olarak Account Holder, Admin veya App Manager’ı listeler). Bir tane oluşturmak API anahtarı rehberinde anlatılıyor.

Kaynaklar

ÜrünFiyat noktalarıEşitlemelerFiyat değişikliği oluşturma
Uygulama`GET /v1/apps/{id}/appPricePoints`?filter[territory]=USA`GET /v3/appPricePoints/{id}/equalizations``POST /v1/appPriceSchedules` — temel bölge artı elle girilen fiyatlar
Uygulama içi satın alma`GET /v2/inAppPurchases/{id}/pricePoints``GET /v1/inAppPurchasePricePoints/{id}/equalizations``POST /v1/inAppPurchasePriceSchedules` — temel bölge zorunlu
Abonelik`GET /v1/subscriptions/{id}/pricePoints` — her zaman filter[territory] ile`GET /v1/subscriptionPricePoints/{id}/equalizations``POST /v1/subscriptionPrices` — bölge başına bir tane
Bölgeler`GET /v1/territories`—Salt okunur: 175 mağaza ve para birimleri

Her fiyat noktasının bir customerPrice ve sizin proceeds değeriniz vardır. Bir noktanın eşitlemeleri, diğer her mağazadaki karşılık gelen noktalardır — o temel fiyat için Apple’ın dünya çapındaki fiyatları, sizin tarafınızda hiçbir döviz kuru hesabı olmadan. Aylık ve peşin plan türlerine sahip abonelikler için Apple ayrıca adjustedEqualizations belgeler (Apple: bölgeler arası abonelik fiyatlarını yapılandırma). Güncel durumu GET /v1/apps/{id}/appPriceSchedule ile, abonelikler için GET /v1/subscriptions/{id}/prices ile okuyun.

İsteklerin görünümü

Bir uygulama fiyat takvimi, fiyatların satır içi oluşturulduğu tek bir JSON:API belgesidir. Önemli kısımlar:

NeredeAlanDeğer
datatypeappPriceSchedules
data.relationshipsappUygulamanızın kimliği
data.relationshipsbaseTerritoryÖrneğin USA
data.relationshipsmanualPricesincluded içindeki fiyatlara, ${price-1} gibi geçici kimliklerle başvurular
included[]typeappPrices (uygulama içi satın almalar: inAppPurchasePrices)
included[].attributesstartDate, endDate“Şimdi” ve “süresiz” için null, ya da bir tarih
included[].relationshipsappPricePointO bölge için fiyat noktası kimliği

Elle fiyatı olmayan bölgeler, temelden türetilen Apple’ın otomatik fiyatını alır. Bir abonelik fiyatı daha basittir: type subscriptionPrices, öznitelikler startDate ve preserveCurrentPrice (plan türleri sunuyorsanız ayrıca planType) ve aboneliğe, bölgeye ve subscriptionPricePoint’e ilişkiler.

Dünya çapında bir değişiklik, adım adım

  1. Bölgeleri bir kez listeleyin ve önbelleğe alın; nadiren değişirler.
  2. Her ürün için temel bölgenizdeki fiyat noktalarını alın (sayfa başına 200) ve yeni temel fiyatınıza uyanı bulun.
  3. Her yerde Apple’ın fiyatlaması için burada durun: uygulamalar ve uygulama içi satın almalar için yalnızca temel nokta yeterlidir. Kendi bölgesel fiyatlarınız için mağaza başına bir hedef hesaplayın ve yuvarlayın — kolay yol, hedefi temel para biriminde yuvarlayıp o noktanın eşitlemelerini izlemektir (yuvarlama nasıl çalışır).
  4. Uygulamalar ve uygulama içi satın almalar: temel bölge ve her elle girilen fiyatla tek bir takvim POST edin. Abonelikler: mağaza başına, başlangıç tarihi ve mevcut aboneler politikasıyla bir subscriptionPrices POST edin.
  5. 429 ve 5xx hatalarını geri çekilme ve yeniden deneme ile ele alın; oluşturulan her kaynağı denetim izi olarak kaydedin.
  6. Takvimi veya fiyatları geri okuyun ve App Store Connect’te birkaç mağazayı örnekleme yoluyla kontrol edin.

Kaç istek gerekir?

Uygulamalı bir örnek: 2 uygulama, 10 uygulama içi satın alma ve 4 abonelik, 4 bölgesel kademeyle yeniden fiyatlanıyor. Apple’ın istek sınırı örneği anahtar başına kayan saatte 3.500 istek gösterir ve gerçek sınırların değiştiğini söyler — her yanıtta X-Rate-Limit başlığını okuyun (Apple: istek sınırları).

AdımHesapİstek
BölgelerBir kez1
Temel fiyat noktaları16 ürün × yaklaşık 5 sayfa≈ 80
Eşitlemeler16 ürün × 4 kademe noktası≈ 64
Uygulama ve IAP takvimleri12 ürün × 112
Abonelik fiyatları4 abonelik × 175 mağaza700
Toplam≈ 857

Abonelikler başı çeker: Apple, eşitlenmiş abonelik fiyatlarını uygulamak için toplu bir uç nokta olmadığını belirtir. Kataloğu ikiye katlayın, yeniden denemeleri ve bir doğrulama turunu ekleyin; örnek saatlik sınıra yaklaşırsınız — bu yüzden sıkı bir döngü başlatmak yerine işi yavaşlatın.

Tuzaklar

  • Bir takvim POST’u tüm uygulama veya uygulama içi satın alma takvimini değiştirir. Yalnızca değişenleri değil, tutmak istediğiniz her elle girilen fiyatı ekleyin — dışarıda kalan her şey Apple’ın otomatik fiyatına geri düşer.
  • Bir uygulama veya IAP üzerinde gelecek bir değişiklik planlamak için bugünün elle girilen fiyatlarını, endDate değeri yeni startDate’e eşit olacak şekilde gönderin, ardından yeni fiyatları. Aynı fiyat noktasındaki iki bitişik aralık reddedilir (“Adjacent intervals cannot have the same price point”), bu yüzden değişmeyen bir bölgeyi süresiz tek bir kayıt olarak gönderin.
  • Abonelikler bölge başına en fazla bir gelecek fiyat tutar. Başka bir tane oluşturmadan önce kuyruktakini `DELETE /v1/subscriptionPrices/{id}` ile silin.
  • Başlangıç tarihi olmayan bir abonelik fiyatı ilk fiyattır. Abonelik onaylandıktan sonra sonraki fiyatlar için startDate gerekir; aksi halde API 409 durum hatasıyla yanıt verir.
  • Abonelik düşüşleri mevcut abonelere uygulanır ve herhangi bir abonelik değişikliği yürürlüğe girdikten sonra geri alınamaz. Artışlar onay gerektirebilir — bkz. abonelik fiyatı artırma.
  • Fiyat noktası listeleri büyüktür. Her zaman bölgeye göre filtreleyin ve sayfalayın.
  • Bu uç noktalar için belirteçler en fazla 20 dakika yaşar; uzun işlerin yeniden imzalaması gerekir.
  • Değişikliklerin sandbox’ta görünmesi bir saate kadar sürebilir.
  • API’de hiçbir yer “emin misiniz?” diye sormaz. Gözden geçirme adımını kendiniz kurun.

Bir fiyatlandırma betiğini güvenle test etme

App Store Connect hesabınızın bir hazırlık (staging) kopyası yoktur, bu yüzden güvenliği betiğin kendisine yerleştirin:

  • Betiğe her şeyi hesaplayan ve ürün, bölge, güncel fiyat ve yeni fiyat tablosu basan — ve hiçbir şey göndermeyen — bir deneme çalıştırması bayrağı verin.
  • Yazmadan önce canlı takvimi veya fiyatları okuyun ve planınızla karşılaştırın; hedef fiyata zaten sahip bölgeleri atlayın.
  • İlk gerçek yazmayı henüz indirimde olmayan tek bir üründe ya da tek bir bölgede çalıştırın ve geri okuyun.
  • Bölge başına eski ve yeni fiyat noktasını içeren bir günlük satırı yazın. Bir şey ters giderse fiyatları geri koymanın yolu o günlüktür.
  • Anahtarı bir gizli bilgi deposunda tutun, asla depoda değil; ve betiğe kendi anahtarını verin ki bağımsız olarak iptal edebilesiniz.

Betiği atlayın: RepriceCat

RepriceCat, fiilen bu rehberin bir ürüne dönüşmüş halidir. Kendi ekip anahtarınızı bağlarsınız (şifreli saklanır, istediğiniz zaman iptal edilebilir); fiyat noktalarını alır, kademe fiyatlarını geçerli noktalara yuvarlar, takvimleri oluşturur — planlanmış değişiklikler için bugünün fiyatlarını devretmek dahil — ve istek sınırına göre kendi hızını ayarlar.

  • Bir şey gönderilmeden önce ürün × ülke gözden geçirme tablosu, bugünün fiyatı → yeni fiyat; hiçbir şey göndermeyen bir deneme çalıştırması.
  • Uygulamalar genelinde tek bir değişiklikte en fazla 200 ürün, hemen ya da bir tarihte.
  • Başarısız ülkeler Apple’ın gerekçesiyle listelenir ve tek başına yeniden gönderilebilir; her değişiklik ülke bazında kaydedilir ve geri alınabilir.
  • Elektronik tablo gidiş-dönüşü: fiyatları XLSX veya CSV olarak dışa aktarın, düzenleyin, geri içe aktarın.

Kendin yap mı, satın al mı diye mi tartıyorsunuz? RepriceCat ile API betiklerini okuyun veya ücretsiz bir ayla başlayın.

Sık sorulanlar

Fiyat değiştirmek için bir App Store Connect API anahtarının hangi role ihtiyacı var?

Admin veya App Manager. Apple’ın fiyatlandırma yardım sayfaları fiyatları yönetebilen roller olarak Account Holder, Admin veya App Manager’ı listeler; Developer, Marketing, Sales veya Finance rolündeki anahtarlar yönetemez.

API tek istekte tüm bölgelerin fiyatını değiştirebilir mi?

Uygulamalar ve uygulama içi satın almalar için evet: tek bir fiyat takvimi temel bölgeyi ve her elle girilen fiyatı taşır. Aboneliklerde her bölge kendi subscriptionPrices kaynağıdır, bu yüzden dünya çapında bir değişiklik abonelik başına en fazla 175 istektir.

Apple’ın eşitlenmiş fiyatlarını API üzerinden nasıl alırım?

Temel fiyatınız için fiyat noktasını bulun, ardından eşitlemeler uç noktasını çağırın. Diğer her mağazadaki karşılaştırılabilir fiyat noktasını döndürür; bunu olduğu gibi ya da bir bölgesel kademe için yuvarlanmış fiyat olarak kullanabilirsiniz.

Fiyatlandırma çağrıları için bir sandbox veya deneme çalıştırması modu var mı?

Hayır. Fiyat takvimleri gerçek hesap üzerinde işler. Hesaplanan toplu işi dikkatle gözden geçirin, henüz yayında olmayan bir üründe test edin veya kendi deneme çalıştırması olan bir araç kullanın.

App Store Connect API istek sınırı nedir?

Sınırlar kayan bir saat boyunca API anahtarı başınadır ve her yanıtın X-Rate-Limit başlığında bildirilir. Apple’ın örneği saatte 3.500 istek gösterir ama gerçek sınırların değiştiğini söyler; aşılırsa HTTP 429 döner.

API üzerinden planlanmış bir fiyat değişikliğini nasıl iptal ederim?

Abonelik için bekleyen subscriptionPrices kaynağını silin. Uygulama veya uygulama içi satın alma için gelecek kaydı olmayan yeni bir takvim gönderin; POST’un tüm takvimi değiştirdiğini unutmayın.

Deneyin

Her ülkeyi tek bir temel fiyattan yeniden fiyatlandırın

Kademeler, fiyat noktasına yuvarlama, tek bir gözden geçirme tablosu, tek bir onay — App Store Connect API üzerinden. İlk ay ücretsiz, sonrasında uygulama başına aylık 1 $.