Apple'ın Send Consumption Information özelliği artık on iki değil beş alan istiyor ve işte her biri

Apple'ın, bir müşteri para iadesi istediğinde sizden istediği bilgi listesi epeyce kısaldı. Bir geliştiricinin bir App Store para iadesi kararına gönderebildiği tek yanıt olan Send Consumption Information yükünde eskiden on iki alan vardı. Artık beş alan var. Apple bunu WWDC24 civarında kırptı ve eski hesap profilleme sorularının çoğunu iki basit soruya ve bir sayıya indirdi. Daha az alan küçük bir düzenleme değildir. Apple'ın hangi kanıtı tarttığını değiştirir ve hangi alanlarda yanlış yapmayı göze alamayacağınızı değiştirir.

İşte bunun neden sadece bir şema notu değil, dikkatinize değer olduğu. Bu yük, bir Apple para iadesinde sizin tarafınızdaki hikayenin karara ulaştığı tek andır. Tüketilebilir bir ürünün iadesi, teslim etmek için zaten gerçek para harcadığınız geliri geri alır ve beş alan, ürünün teslim edildiğini ve kullanıldığını Apple'a bildirme biçiminizdir. 12 saatlik pencereyi kaçırın ya da bir alanı yanlış doldurun, Apple yalnızca müşterinin talebine göre karar verir.

Send Consumption Information nedir

Send Consumption Information, Apple sunucunuza bir CONSUMPTION_REQUEST bildirimi gönderdikten sonra çağırdığınız App Store Server API uç noktasıdır. Bu bildirim, bir müşterinin Apple'dan bir uygulama içi satın alma için para iadesi istediği ve Apple'ın karar vermeden önce sizin girdinizi istediği anlamına gelir. Küçük bir JSON gövdesini, yani ConsumptionRequest'i uç noktaya PUT ederek yanıt verirsiniz. Apple onu okur, müşterinin geçmişiyle tartar ve kararı verir. Para iadesine asla siz karar vermezsiniz. Siz gerçekleri sağlarsınız.

Gövde, arayüzün tamamıdır. Ayrı bir form, itiraz ya da sayılan ikinci bir gönderim yoktur. O tek yükte gönderdiğiniz her şey davanızın tamamıdır, bu yüzden her alanın anlamı, alan sayısının düşündürdüğünden daha çok önemlidir.

Apple'ın artık istediği beş alan

Mevcut ConsumptionRequest'in beş üyesi vardır. Üçü zorunlu ve ikisi isteğe bağlıdır. Apple'ın müşterinin hesabı, kıdemi, ömür boyu harcaması, ömür boyu iadeleri, oynama süresi hakkında eskiden sorduğu her şey, gönderdiğiniz veriden kaldırıldı.

customerConsented kapıdır

customerConsented bir Boolean'dır ve genel olarak herhangi bir şey gönderip göndermeyeceğinize karar veren alandır. Müşterinin tüketim verilerini Apple ile paylaşmanıza izin verip vermediğini kaydeder. Apple'ın yönlendirmesi nettir: müşteri onay vermediyse, tüketim bilgisini göndermeyin. Yani bu, davanızı güçlendirmek için true'ya çevirdiğiniz bir alan değildir. Zaten elinizde bulunması gereken gerçek bir evet ya da hayırı yansıtır ve buradaki bir false, yükün geri kalanının gönderilmemesi gerektiği anlamına gelir.

deliveryStatus para iadelerini hareket ettiren alandır

deliveryStatus bir string enum'dur ve sahip olduğunuz en güçlü kaldıraçtır. Uygulamanızın gerçekten çalışan bir uygulama içi satın alma teslim edip etmediğini Apple'a bildirir. Bir değer evet der. Diğer dört değer hayır der, her biri farklı bir nedenle ve her biri müşterinin meşru bir şikayeti olduğunu Apple'a bildirir.

sampleContentProvided bir adalet sorusunu yanıtlar

sampleContentProvided bir Boolean'dır. Müşteriye satın almadan önce ücretsiz bir örnek, bir deneme ya da satın almanın ne yaptığına dair net bir bilgi verip vermediğinizi kaydeder. Buradaki bir true küçük bir adalet sinyalidir: müşterinin ne satın aldığını bilme şansı olmuştur. Kendi başına hiçbir şeye karar vermez, ama yalnızca üç zorunlu alandan biridir, bu yüzden Apple onu her yanıtta açıkça istiyor.

consumptionPercentage artık bir durum değil, bir sayı

En çok değişen alan budur. Eski yükte consumptionStatus vardı, dört basamaklı bir enum: UNDECLARED, NOT_CONSUMED, PARTIALLY_CONSUMED, FULLY_CONSUMED. Yeni yük onu consumptionPercentage ile değiştiriyor, milliunits cinsinden ölçülen bir tam sayı. 100,000 milliunits, öğenin tamamen tüketildiği anlamına gelir, yani 50,000 yarısı ve 0 dokunulmamıştır. Kesin bir sayı dört yönlü bir kovadan iyidir, çünkü bir müşterinin bir kredi paketinin yüzde 90'ını tükettiğini söylemenize izin verir, kısmen tüketilmiş olarak aşağı yuvarlamak yerine.

İnsanların takıldığı bir uyarı. Otomatik yenilenen abonelikler için Apple tüketimi geçen süreden kendisi hesaplar, bu yüzden consumptionPercentage tüketilebilir ve yenilenmeyen satın almalar için tasarlanmıştır. Uygulandığı yerde gönderin ve uygulanmadığı yerde Apple'ın türetmesine izin verin.

refundPreference bir karar değil, bir tercih belirtir

refundPreference isteğe bağlı bir string'dir ve Apple'a hangi sonucu tercih edeceğinizi bildirdiğiniz yerdir. O da biçim değiştirdi. Eski alan, prefer-grant, prefer-decline ve no-preference gibi değerlere sahip bir sayıydı. Yenisi, üç değeri olan adlandırılmış bir string'dir.

Apple neyi çıkardı ve bu neden önemli

Eski ConsumptionRequest'in on iki alanı vardı. Bunların yedisi gönderdiğiniz veriden gitti. accountTenure, lifetimeDollarsPurchased, lifetimeDollarsRefunded, playTime, userStatus, platform ve appAccountToken, yükün hesap profilleme yarısıydı; bir müşteriyi hesabının ne kadar eski olduğuna, ne kadar harcadığına, ne kadar iade aldığına ve uygulamayı ne kadar kullandığına göre kovalara ayırmanızı isteyen alanlardı.

Apple onları not almaya değer bir nedenle çıkardı. O alanlar geliştiricilerden müşterinin bir profilini teslim etmesini istiyordu ve çoğu geliştirici ya onları bildirmeden bıraktı ya da tahmin etti. Kalan beşi satın alma ve teslimat hakkındadır, kendi sistemlerinizden gerçekten doğrulayabileceğiniz gerçeklerdir. Kayma, müşterinin kim olduğundan bu belirli satın almada ne olduğuna doğrudur.

Uç nokta ve saat

Yükü, ihtilaflı satın almanın işlem kimliğiyle anahtarlanmış olarak Send Consumption Information uç noktasına bir HTTP PUT ile gönderirsiniz: PUT /inApps/v1/transactions/consumption/{transactionId}. Başarı 202 Accepted döndürür ve yanıt gövdesi boştur. O boş yanıt beklenendir, bir hata değil. Apple'ın verilerinizi kuyruğa aldığını doğrular ve daha sonra bir REFUND ya da REFUND_DECLINED bildirimi olarak gelen nihai sonuç hakkında size hiçbir şey söylemez.

Saat, uzatamayacağınız kısımdır. Apple size yanıt vermek için CONSUMPTION_REQUEST'ten itibaren 12 saat verir. Yalnızca ilk yanıtınız kullanılır, bu yüzden ilk yükün eksiksiz ve doğru olanı olması gerekir. Apple aynı satın alma için CONSUMPTION_REQUEST'i birden fazla kez gönderebilir, ama her birinin son tarihi sabittir ve manuel bir inceleme, saat dilimleri ve hafta sonları arasında 12 saate nadiren sığar.

Yanlış işlenmiş bir alan size neye mal olur

Para, iade gerçekleşmeden önce çoktan gitmişti

Tüketilebilir bir ürünün iadesi temiz bir geri alma değildir. Bir müşteri bir kredi paketi ya da bir grup AI üretimi için parasını geri istediğinde, siz onu teslim etmek için zaten harcamışsınızdır: her istekte GPU çıkarımı, jeton başına faturalandırılan üçüncü taraf model API çağrıları, ürettiğiniz her ne varsa onun için depolama ve bu kullanıma bağlı her türlü içerik üreticisi ya da iş ortağı ödemesi. Mağaza fiyatı müşteriye geri döner. Teslimat maliyetiniz size geri dönmez. Yani itiraz edebileceğiniz bir iade, başabaş bir olay değildir, hesaba hizmet etmek için ödediğiniz her şeyin net bir kaybıdır.

Beş alan, iki kez ödemekten kaçınma biçiminizdir

DELIVERED olarak ayarlanmış deliveryStatus ve yüksek bir consumptionPercentage, müşterinin ürünü aldığını ve kullandığını Apple'a bildiren iki gerçektir. Bunlar, hesaplamanın, API çağrılarının ve depolamanın hepsinin işini yaptığına dair kanıtınızdır. Yükü göndermeden bırakın ve Apple bunu asla duymaz. Müşterinin talebine göre karar verir, iadenin geçme olasılığı daha yüksektir ve siz hem geri alınan geliri hem de onun arkasındaki teslimat maliyetini yüklenirsiniz.

Ters ibrazlar daha kötü kapıdır ve sessizlik oraya işaret eder

Apple'ın para iadesi akışı üzerinden tatmin olamayan bir müşteri, yine de bankasıyla ödemeye itiraz edebilir. Bir kart ters ibrazı nihaidir, sabit bir itiraz ücreti taşır ve kararı Apple'ın ve sizin elinizden alır. CONSUMPTION_REQUEST'i iyi yanıtlamak, anlaşmazlığı söz sahibi olduğunuz Apple'ın sistemi içinde tutar. Onu görmezden gelmek, sınırdaki durumları hiç söz sahibi olmadığınız tek kanala doğru iter.

RefundHalt bunu nasıl ele alır

Beş alan, onları doğru şekilde, 12 saat içinde, her CONSUMPTION_REQUEST'te, doğru işleme anahtarlanmış olarak doldurmanız gerekene kadar basit görünür. RefundHalt bildirimi yakalar, o satın alma için kendi teslimat ve kullanım kayıtlarınızı okur ve pencere kapanmadan önce yükü otomatik olarak gönderir. deliveryStatus günlüklerinizin gerçekten gösterdiğini yansıtır, consumptionPercentage bir tahminden değil gerçek kullanımdan gelir ve refundPreference bir kez belirlediğiniz politikayı izler. İtiraz edilebilir iadenin kanıtla incelenmesini elde edersiniz, kaçırılan bir son tarihi ve sizsiz verilen bir kararı değil.