Функция семейного доступа Apple позволяет распределять встроенные покупки между членами семьи — это удобный способ для пользователей групповых приложений (например, стриминговых сервисов и детских приложений) пользоваться одной подпиской без необходимости делиться Apple ID. Позволяя до пяти членов семьи пользоваться подпиской, Family Sharing способен повысить вовлечённость и удержание пользователей вашего приложения. В этом гайде мы расскажем, как подключить подписки к Family Sharing и как Adapty управляет покупками, которые используются в рамках семейного доступа. Чтобы включить Family Sharing для конкретного продукта, перейдите в App Store Connect. По умолчанию Family Sharing отключён как для новых, так и для существующих встроенных покупок, поэтому его нужно включать отдельно для каждой встроенной покупки. Сделать это просто: откройте страницу приложения, перейдите на страницу нужной встроенной покупки и выберите опцию Turn On в разделе Family Sharing. Имейте в виду: после включения 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 исключаются из метрик выручки и конверсии.

События для транзакций Family Sharing.

Для транзакций FAMILY_SHARED отправляется только событие Access level updated. События подписки для конкретных продуктов для участников семейного доступа не отправляются.

Событие	FAMILY_SHARED	PURCHASED
Access level updated	Да	Да
Subscription started	Нет	Да
Trial started	Нет	Да
Subscription renewed	Нет	Да
Subscription expired	Нет	Да
Subscription refunded	Нет	Да
Billing issue detected	Нет	Да

Если ваша аналитика ориентируется на Subscription started, участники семейной подписки там не появятся. Используйте Access level updated, чтобы отслеживать активных участников семейного доступа. Чтобы найти других участников семейной подписки в Adapty, нужно открыть детали события. Сначала найдите оригинальную транзакцию семейной покупки, затем в деталях события найдите другие транзакции с тем же продуктом, датой покупки и датой истечения срока. Так вы определите все семейные транзакции, связанные с исходной покупкой.