Когда использовать restoreCompletedTransactions для покупок в приложении?

Обновление (июнь 2019 г.)

документация по этой теме была обновлена ​​в 2018 году и является довольно полной. Многие из его рекомендаций согласуются с тем, что мы в итоге выяснили. Самым большим достижением с тех пор, как этот вопрос был впервые опубликован в 2009 году, стала квитанция в App Store в iOS 7.

Если в будущем ссылка устареет, я процитирую здесь часть документации.

Восстановление приобретенных продуктов

Пользователи восстанавливают транзакции, чтобы сохранить доступ к уже приобретенному контенту. Например, при переходе на новый телефон они не теряют все товары, приобретенные на старом телефоне. Включите в свое приложение какой-либо механизм, позволяющий пользователю восстанавливать свои покупки, например кнопку «Восстановить покупки». При восстановлении покупок запрашиваются учетные данные пользователя в App Store, что прерывает работу вашего приложения: из-за этого не восстанавливаются автоматически покупки, особенно при каждом запуске вашего приложения.

В большинстве случаев все, что нужно сделать вашему приложению, - это обновить квитанцию ​​и доставить продукты в квитанции. Обновленная квитанция содержит запись о покупках пользователя в этом приложении, на этом устройстве или на любом другом устройстве. Однако некоторым приложениям необходимо использовать альтернативный подход по одной из следующих причин:

• Если вы используете контент, размещенный на сервере Apple, восстановление завершенных транзакций предоставляет вашему приложению объекты транзакций, которые оно использует для загрузки контента.
• Если вам нужна поддержка версий iOS до iOS 7, в которых квитанция приложения недоступна, восстановите завершенные транзакции.
• Если ваше приложение использует невозобновляемые подписки, ваше приложение отвечает за процесс восстановления.

При обновлении квитанции в App Store запрашивается последняя копия квитанции. Обновление квитанции не создает новых транзакций. Хотя вам следует избегать обновления несколько раз подряд, это действие приведет к тому же результату, что и обновление только один раз.

Восстановление завершенных транзакций создает новую транзакцию для каждой завершенной транзакции, выполненной пользователем, по сути воспроизводя историю для вашего наблюдателя очереди транзакций. Пока транзакции восстанавливаются, ваше приложение поддерживает собственное состояние, чтобы отслеживать, почему оно восстанавливает завершенные транзакции и как оно должно их обрабатывать. Многократное восстановление создает несколько восстановленных транзакций для каждой завершенной транзакции.

Предыдущий ответ (2009-2012)

Написав вопрос и подумав над ним, я придумал несколько решений.

Автоматически (не рекомендуется)

Один из вариантов - записать в пользовательских настройках по умолчанию, был ли restoreCompletedTransactions вызван (и успешно завершен) еще в приложении. В противном случае приложение вызывает его один раз при запуске. Поскольку этот флаг может храниться в том же месте, что и нерасходуемые платежи, если пользовательские значения по умолчанию будут удалены позже, метод восстановления будет вызываться снова при запуске приложения.

Таким образом, если существующий клиент каким-то образом выполняет новую установку приложения, он все равно автоматически восстанавливает свои покупки. Если это новый клиент, который никогда раньше не запускал приложение, операция восстановления ничего не возвращает.

В любом случае restoreCompletedTransactions вызывается только один раз, а не при каждом запуске.

Руководство (рекомендуется)

Другой вариант - предложить клиенту где-нибудь кнопку «Восстановить покупки», подключить ее к restoreCompletedTransactions и позволить ему решить, когда она может понадобиться и когда она может понадобиться.

(В комментариях ниже объясняется, почему восстановление вручную, вероятно, лучше, чем пытаться сделать это автоматически.)

Не забывайте, что один Apple ID может охватывать несколько устройств. Таким образом, поддержание флага на одном устройстве (скажем, iPhone пользователя), который сообщает вам, выполнили ли вы восстановление или нет, не позволит вам определить, совершил ли клиент покупку на другом устройстве (скажем, его iPad), которое требует для восстановления на iPhone. Поэтому ТАКЖЕ необходим ручной метод запуска восстановления, даже если у вас есть автоматический метод.

Что еще хуже, я еще не понял, как вас уведомляют, когда производятся ВОЗВРАТЫ IAP. Я подозреваю, что процесс восстановления просто вернет список невозмещенных транзакций. Итак, a) вам необходимо УДАЛИТЬ свою запись IAP пользователя, когда вы выполняете восстановление, на случай, если продукты, по которым были возвращены средства, просто не сообщаются во время восстановления, и b) вам необходимо периодически выполнять автоматическое восстановление, чтобы получить возмещение.

Все это подчеркивает проблему с Apple IAP - он плохо продуман и неадекватно документирован - и теперь он ТРЕБУЕТСЯ для поставщиков контента, таких как читатели электронных книг, у которых уже есть отлично функционирующие интернет-магазины, уже работающие в их приложениях (например, Kindle).

Всякий раз, когда у вас есть нерасходуемые покупки в приложении, например, новая гоночная трасса, вам необходимо реализовать кнопку «Восстановить» где-нибудь в приложении, чтобы пользователь мог восстановить свою покупку, если они изменят устройства или удалят приложение. Это обязательно, и раньше у меня Apple отклоняла приложение за то, что не реализовала кнопку «Восстановить».