Apple Family Sharing позволяет распространять встроенные покупки между членами семьи. Это удобный способ для пользователей групповых приложений — например, стриминговых сервисов и детских приложений — делить подписки, не передавая свой Apple ID. Поддерживая до пяти членов семьи в рамках одной подписки, Family Sharing способна повысить вовлечённость и удержание пользователей вашего приложения.

В этом гайде мы расскажем, как подключить подписки к Family Sharing и как Adapty обрабатывает покупки, расшаренные внутри семьи.

Чтобы включить Family Sharing для конкретного продукта, перейдите в App Store Connect. По умолчанию Family Sharing отключена для всех новых и существующих встроенных покупок, поэтому её нужно включать отдельно для каждой. Для этого откройте страницу своего приложения, перейдите на страницу нужной встроенной покупки и в разделе Family Sharing нажмите Turn On.

Имейте в виду: после включения Family Sharing для продукта её нельзя отключить, так как это нарушит работу для пользователей, уже поделившихся подпиской с семьёй. Также учтите, что шеринг доступен только для нерасходуемых покупок и подписок.

В появившемся модальном окне нажмите Confirm, чтобы завершить настройку. После этого раздел Family Sharing должен обновиться и отобразить сообщение: «This subscription can be shared by everyone in a family group». Это подтверждает, что подписка включена для Family Sharing и может быть доступна до пяти членам семьи.

Adapty поддерживает Family Sharing без каких-либо дополнительных настроек. Просто настройте продукты из App Store, и как только вы включите Family Sharing в App Store Connect, она автоматически заработает в Adapty — соответствующее событие придёт на вебхук.

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

Когда пользователь приобретает продукт с поддержкой Family Sharing, транзакция появляется в его чеке как обычно, но с новым полем in_app_ownership_type со значением PURCHASED. Для каждого члена семьи при этом создаётся отдельная транзакция с другим web_order_line_item_id и original_transaction_id, а также с полем in_app_ownership_type со значением FAMILY_SHARED.

Для корректного подсчёта дохода Adapty учитывает только транзакции с in_app_ownership_type равным PURCHASED. Значения FAMILY_SHARED не включаются в аналитику и не порождают события.

Чтобы найти других членов семьи в Adapty, воспользуйтесь деталями события. Найдите оригинальную транзакцию семейной покупки, а затем в деталях события ищите записи с тем же продуктом, датой покупки и датой истечения. Так вы сможете определить остальные транзакции, связанные с этой покупкой в рамках Family Sharing.