Запрос сигналов о возрасте

В этом документе описано, как запрашивать сигналы о возрасте с помощью 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, в противном случае – 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 и другие значения значительных изменений.