В этом документе описано, как запрашивать сигналы о возрасте с помощью Play Age Signals API.
В Play Age Signals SDK 0.0.4 представлена архитектура с двумя функциями, которая упрощает запросы индикаторов возраста и поддерживает нашу модель, основанную на выборе пользователя. Чтобы запросить сигналы о возрасте, выполните следующие действия:
Вызовите метод requestAgeSignalsAccess(Activity), который возвращает ageSignalsStatus. Значение ageSignalsStatus может быть SHARED, NOT_SHARED или VERIFICATION_REQUIRED.
- Если
ageSignalsStatus == NOT_SHARED, то приложение не получит сигналы о возрасте в ответе API. - Если
ageSignalsStatus == SHARED, вызовите методcheckAgeSignals(). Если пользователь или родитель согласился поделиться индикаторами возраста, вы получите их в ответе API и сможете решить, как их обработать. - Если
ageSignalsStatus == VERIFICATION_REQUIRED: возраст пользователя неизвестен, и пользователь находится в юрисдикции или регионе, где подтверждение возраста и передача сигналов о возрасте обязательны. Чтобы получить сигнал о возрасте из Google Play в этих регионах, попросите пользователя перейти в Google Play и подтвердить свой статус.
Метод requestAgeSignalsAccess(Activity) возвращает разные значения в зависимости от того, требуется ли в регионе обязательная передача данных о возрасте.
- Если пользователь находится в штате США, где магазины приложений обязаны предоставлять разработчикам подтвержденную информацию о возрасте, запрос в приложении не показывается.
Вместо этого пользователям будет предложено подтвердить возраст или настроить родительский контроль при входе в Google Play. Чтобы определить статус проверки, используйте значение
ageSignalsStatus:- Если пользователь подтвердил свой возраст или включен родительский контроль, значение
ageSignalsStatusбудетSHARED. - Если пользователь ещё не подтвердил возраст или не настроил родительский контроль, значение
ageSignalsStatusбудетVERIFICATION_REQUIRED. Подробную информацию вы найдете в статье Обновления Google Play, связанные с предстоящими изменениями в законодательстве определенных штатов США относительно покупок в магазине приложений.
- Если пользователь подтвердил свой возраст или включен родительский контроль, значение
- Для пользователей из других регионов, где передача данных о возрасте зависит от выбора пользователя или родителя:
- Если у пользователя выбран вариант Спрашивать перед отправкой, в приложении появится запрос. Если пользователь соглашается сообщить свой возраст, значение
ageSignalsStatus–SHARED, в противном случае –NOT_SHARED. - Если пользователь выбрал вариант Всегда делиться, запрос в приложении не показывается, а значение
ageSignalsStatus–SHARED. - Если пользователь выбрал вариант Никогда, запрос в приложении не показывается, а значение
ageSignalsStatus–NOT_SHARED. - Родители могут разрешить или запретить передачу данных о возрасте в настройках приложения Family Link. Если родители разрешат передавать возраст, значением
ageSignalsStatusбудетSHARED, а если нет –NOT_SHARED.
- Если у пользователя выбран вариант Спрашивать перед отправкой, в приложении появится запрос. Если пользователь соглашается сообщить свой возраст, значение
Чтобы узнать, как в Google Play передаются данные о возрастном диапазоне, в том числе о запросах в приложениях и настройках доступа, прочитайте эту статью.
В примере ниже показано, как запросить сигналы о возрасте:
Kotlin
// 1. Initialize the AgeSignalsManager (usually in onCreate or class initialization)
val ageSignalsManager = AgeSignalsManagerFactory.create(applicationContext)
// 2. Request or check for age signals access.
// Passing the current Activity allows the Play Store to render the age sharing prompt UI if required.
val accessRequest = AgeSignalsAccessRequest.builder()
.setActivity(this)
.build()
ageSignalsManager.requestAgeSignalsAccess(accessRequest)
.addOnSuccessListener { accessResult ->
if (accessResult.ageSignalsStatus() == AgeSignalsStatus.SHARED) {
// The user (or parent) has agreed to share age range, or is in an eligible auto-share region.
// Retrieve the actual age signals.
retrieveAgeSignals(ageSignalsManager)
} else {
// Age signals are not shared (user didn't share age range, parent rejected the request, or not eligible).
}
}
.addOnFailureListener { exception ->
// Handle API/Play Store connection and system errors
handleAgeSignalsError(exception)
}
private fun retrieveAgeSignals(manager: AgeSignalsManager) {
// 3. Perform the actual age signals query once sharing is active.
manager.checkAgeSignals(AgeSignalsRequest.builder().build())
.addOnSuccessListener { ageSignalsResult ->
val installId = ageSignalsResult.installId()
val ageLower = ageSignalsResult.ageLower()
val ageUpper = ageSignalsResult.ageUpper()
val significantChangeDate = ageSignalsResult.significantChangeApprovalDate()
val ageRangeSource = ageSignalsResult.ageRangeSource()
if (ageLower != null) {
if (ageUpper != null) {
// The user is in a specific closed age range [ageLower, ageUpper] (e.g. [13, 15])
} else {
// The user is in the highest open-ended age band [ageLower, null] (e.g. [18, null])
}
} else {
// Both bounds are null: The user is not sharing their age
}
}
.addOnFailureListener { exception ->
handleAgeSignalsError(exception)
}
}
Java
// 1. Initialize the AgeSignalsManager (usually in onCreate or class initialization)
AgeSignalsManager ageSignalsManager = AgeSignalsManagerFactory.create(getApplicationContext());
// 2. Request or check for age signals access.
// Passing the current Activity allows the Play Store to render the age sharing prompt UI if required.
AgeSignalsAccessRequest accessRequest = AgeSignalsAccessRequest.builder()
.setActivity(this)
.build();
ageSignalsManager.requestAgeSignalsAccess(accessRequest)
.addOnSuccessListener(accessResult -> {
Integer status = accessResult.ageSignalsStatus();
if (status == AgeSignalsStatus.SHARED) {
// The user (or parent) has agreed to share age range, or is in an eligible auto-share region.
// Retrieve the actual age signals.
retrieveAgeSignals(ageSignalsManager);
} else {
// Age signals are not shared (user didn't share age range, parent rejected the request, or not eligible).
}
})
.addOnFailureListener(exception -> {
// Handle API/Play Store connection and system errors
});
private void retrieveAgeSignals(AgeSignalsManager manager) {
// 3. Perform the actual age signals query once sharing is active.
manager.checkAgeSignals(AgeSignalsRequest.builder().build())
.addOnSuccessListener(ageSignalsResult -> {
String installId = ageSignalsResult.installId();
Integer ageLower = ageSignalsResult.ageLower();
Integer ageUpper = ageSignalsResult.ageUpper();
Date significantChangeDate = ageSignalsResult.significantChangeApprovalDate();
@AgeRangeSource Integer ageRangeSource = ageSignalsResult.ageRangeSource();
if (ageLower != null) {
if (ageUpper != null) {
// The user is in a specific closed age range [ageLower, ageUpper] (e.g. [13, 15])
} else {
// The user is in the highest open-ended age band [ageLower, null] (e.g. [18, null])
}
} else {
// Both bounds are null: The user is not sharing their age (e.g. they are a verified adult)
}
})
.addOnFailureListener(exception -> {
handleAgeSignalsError(exception);
});
}
Основные сведения о коде
- Метод
requestAgeSignalsAccess(Activity)выполняет блокирующую проверку текущих сигналов о возрасте пользователя и статуса передачи этих сигналов. - После вызова
requestAgeSignalsAccess(Activity)Google Play показывает встроенную подсказку в приложении только пользователям, для которых не настроен родительский контроль. Родители контролируемых пользователей могут разрешить или запретить передачу данных о возрасте ребенка в настройках приложения Family Link. - Если пользователь отклонит запрос или закроет его, он будет показан ещё несколько раз, а затем перестанет появляться.
- Метод
checkAgeSignals()получает значение сигналов возраста в ответе API. Этот метод возвращаетageRangeSource,ageUpper,ageLowerи другие значения значительных изменений.