Subskrypcje i raportowanie na platformie Xamarin.iOS

Informacje o subskrypcjach, które nie są odnawiane

Subskrypcje nienadające są przeznaczone dla produktów reprezentujących sprzedaż usługi z ograniczeniem czasu (na przykład dostęp do aplikacji nawigacji lub ograniczony czasowo dostęp do archiwum danych).

Kluczowe różnice między subskrypcjami nieodnawiania i innymi typami produktów:

• Definicja produktu w programie iTunes Połączenie nie zawiera terminu . Kod aplikacji musi mieć możliwość wnioskowania okresu ważności z identyfikatora produktu.
• Można je kupić wiele razy (na przykład produkt eksploatacyjny). Aplikacje są wymagane do zarządzania okresem subskrypcji/wygaśnięciem i odnawianiem oraz uniemożliwić użytkownikowi kupowanie nakładających się subskrypcji.
• Zakupy nie są obsługiwane przez funkcję StoreKit Restore. Jeśli subskrypcja powinna być dostępna na wszystkich urządzeniach użytkownika, aplikacja będzie musiała zaprojektować i zaimplementować tę funkcję w połączeniu z serwerem zdalnym. Aplikacje są również odpowiedzialne za tworzenie kopii zapasowych stanu subskrypcji w przypadkach, gdy kopia zapasowa urządzenia zostanie utworzona, a następnie przywrócona z kopii zapasowej.
• Omówienie implementacji
• Subskrypcje nieodnawiające powinny być zwykle implementowane przy użyciu przepływu pracy dostarczanego przez serwer i zarządzanego, takiego jak produkty eksploatacyjne.

Informacje o bezpłatnych subskrypcjach

Bezpłatne subskrypcje umożliwiają deweloperom umieszczanie bezpłatnej zawartości w aplikacjach Newsstand (nie mogą być używane w aplikacjach innych niż Newsstand). Po uruchomieniu bezpłatnej subskrypcji będzie ona dostępna na wszystkich urządzeniach użytkownika. Bezpłatne subskrypcje nigdy nie wygasają; kończą się tylko po odinstalowaniu aplikacji.

Omówienie implementacji

Bezpłatne subskrypcje zachowują się podobnie jak subskrypcje autoodnawialne. Aplikacja musi mieć produkt Bezpłatna subskrypcja dostępna do zakupu w programie iTunes Połączenie. W przypadku zakupu przez użytkownika zakup bezpłatnej subskrypcji powinien zostać zweryfikowany jako produkt subskrypcji automatycznie odnawialnej. Transakcje bezpłatnej subskrypcji można przywrócić.

Informacje o subskrypcjach autoodnawialnych

Subskrypcje autoodnawialne są używane głównie w aplikacjach Newsstand. Reprezentują one produkt, który udziela użytkownikowi dostępu do zawartości dynamicznej przez dany okres czasu, który jest skonfigurowany w programie iTunes Połączenie (określone okresy od 7 dni do 1 roku). Subskrypcje są odnawiane automatycznie, obciążając użytkowników identyfikatorem Apple ID na końcu każdego okresu subskrypcji, chyba że użytkownik zrezygnował. Ten typ produktu działa dobrze w przypadku subskrypcji czasopism lub wiadomości, w których użytkownik uzyskuje dostęp do każdego problemu opublikowanego, gdy ich subskrypcja jest prawidłowa.

Omówienie implementacji

Automatyczne odnawialne subskrypcje powinny być implementowane przy użyciu przepływu pracy Produkty dostarczane przez serwer (zapoznaj się z sekcją Weryfikacja paragonu i Produkty dostarczane przez serwer).

Wspólny wpis tajny

Wspólny wpis tajny zakupu w aplikacji musi być używany w żądaniu JSON podczas weryfikowania automatycznych subskrypcji odnawialnych na serwerze. Udostępniony wpis tajny jest tworzony/uzyskiwany za pośrednictwem Połączenie iTunes.

Na stronie głównej programu iTunes Połączenie wybierz pozycję Moje aplikacje:

Wybierz aplikację i kliknij kartę Zakupy w aplikacji:

W dolnej części strony wybierz pozycję Wyświetl lub wygeneruj wspólny wpis tajny:

Aby użyć udostępnionego wpisu tajnego, dołącz go do ładunku JSON wysyłanego do serwerów firmy Apple podczas sprawdzania poprawności potwierdzenia zakupu w aplikacji dla automatycznej subskrypcji odnawialnej, w następujący sposób:

{
   "receipt-data" : "(receipt bytes here)",
   "password"     : "(shared secret bytes here)"
}

Pole stanu odpowiedzi będzie zerowe, jeśli zakup jest prawidłowy, podobnie jak w przypadku innych typów produktów.

Pobieranie elementów po początkowym okresie subskrypcji

W ramach dostarczania produktów subskrypcji kod powinien często weryfikować najnowsze znane potwierdzenie na serwerach firmy Apple. Jeśli subskrypcja została automatycznie odnowiona od ostatniej weryfikacji, odpowiedź JSON będzie zawierać dodatkowe pola, które powiadamiają o zastosowaniu transakcji, która miała miejsce (co powinno przedłużyć ważność subskrypcji). Odpowiedź JSON będzie zawierać następujące elementy:

{
   "status" : 0,
   "receipt" : { (receipt here) },
   "latest_receipt" : "(base-64 encoded receipt here)",
   "latest_receipt_info" : { (latest receipt info here) }
}

Jeśli stan ma wartość zero, subskrypcja jest nadal prawidłowa, a inne pola przechowują prawidłowe dane. Jeśli stan to 21006, subskrypcja wygasła. Aby uzyskać informacje o innych kodach błędów, zobacz dokumentację Weryfikowanie potwierdzenia automatycznego odnawiania subskrypcji.

Przywracanie automatycznych subskrypcji odnawialnych

Otrzymasz wiele transakcji — oryginalną transakcję zakupu oraz oddzielną transakcję dla każdego okresu odnowienia subskrypcji. Musisz śledzić daty rozpoczęcia i terminy, aby zrozumieć, jaki jest okres ważności.

Obiekt SKPaymentTransaction nie zawiera terminu subskrypcji — należy użyć innego identyfikatora produktu dla każdego terminu i napisać kod, który może ekstrapolować okres subskrypcji od daty zakupu transakcji.

Testowanie automatycznego odnawiania

Aby ułatwić testowanie subskrypcji, ich czasy trwania są kompresowane podczas testowania w piaskownicy. 1 tydzień subskrypcji odnawiane co 3 minuty, 1 rok subskrypcji odnawiane co godzinę. Subskrypcje będą automatycznie odnawiane maksymalnie 6 razy podczas testowania w piaskownicy.

Raportowanie

Program iTunes Połączenie (itunesconnect.apple.com) zapewnia:

Sales and Trends — wyświetla szczegóły pobierania, aktualizacji i zakupów w aplikacji.

Płatności i raporty finansowe — szczegółowe informacje o dochodach uzyskanych przez aplikacje, a także na liście płatności, które zostały ci wykonane i ile są należne.

Przykładowy raport Sales and Trends jest pokazany poniżej:

Istnieje również aplikacja ITC Połączenie Mobile dla systemu iOS. I Telefon zrzuty ekranu niektórych dostępnych statystyk są wyświetlane tutaj: