ใช้ Play Age Signals API (เบต้า)

// Create an instance of a manager
val ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext())

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener { ageSignalsResult ->
        // Store the install ID for later...
        val installId = ageSignalsResult.installId()

        if (ageSignalsResult.userStatus() == AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED) {
          // Disallow access...
        } else {
           // Do something else if the user is VERIFIED, DECLARED, SUPERVISED, etc.
        }
    }

// Create an instance of a manager
AgeSignalsManager ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext());

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener(
        ageSignalsResult -> {
          // Store the install ID for later...
          String installId = ageSignalsResult.installId();

          if (ageSignalsResult
              .userStatus()
              .equals(AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED)) {
            // Disallow access ...
          } else {
            // Do something else if the user is SUPERVISED, VERIFIED, etc.
          }
        });

(ไม่บังคับ) รับช่วงอายุที่กำหนดเอง

ช่วงอายุเริ่มต้นที่ API แสดงในเขตอำนาจศาลและภูมิภาคที่เกี่ยวข้องคือ 0-12, 13-15, 16-17 และ 18 ปีขึ้นไป

หรือหากต้องการปรับแต่งช่วงอายุเริ่มต้นตามอายุขั้นต่ำ ของแอป คุณสามารถระบุอายุขั้นต่ำเหล่านี้สำหรับแอปในหน้าสัญญาณ อายุใน Google Play Console

1. ไปที่หน้าสัญญาณอายุใน Play Console
2. ในแท็บช่วงอายุที่กำหนดเอง ให้ป้อนอายุขั้นต่ำสำหรับแอปได้สูงสุด 3 รายการ โดยอายุขั้นต่ำต้องห่างกันอย่างน้อย 2 ปี และสามารถเปลี่ยนแปลงได้ปีละครั้ง
3. คลิกบันทึก

ช่วงอายุที่แสดงจะลบล้างการตอบกลับเริ่มต้นของ API เช่น

• หากคุณตั้งอายุขั้นต่ำไว้ 1 รายการ (15 ปี) ใน Google Play Console

  • ผู้ใช้ที่มีอายุ 0-14 ปีจะได้รับ ageLower = 0 และ ageUpper = 14
  • ผู้ใช้ที่มีอายุ 15 ปีขึ้นไปจะได้รับ ageLower = 15

• หากคุณตั้งอายุขั้นต่ำไว้ 2 รายการ (13 และ 17 ปี)

  • ผู้ใช้ที่มีอายุ 0-12 ปีจะได้รับ ageLower = 0 และ ageUpper = 12
  • ผู้ใช้ที่มีอายุ 13-16 ปีจะได้รับ ageLower = 13 และ ageUpper = 16
  • ผู้ใช้ที่มีอายุ 17 ปีขึ้นไปจะได้รับ ageLower = 17

• หากคุณตั้งอายุขั้นต่ำไว้ 3 รายการ (11, 13 และ 15 ปี)

  • ผู้ใช้ที่มีอายุ 0-10 ปีจะได้รับ ageLower = 0 และ ageUpper = 10
  • ผู้ใช้ที่มีอายุ 11 หรือ 12 ปีจะได้รับ ageLower = 11 และ ageUpper = 12
  • ผู้ใช้ที่มีอายุ 13 หรือ 14 ปีจะได้รับ ageLower = 13 และ ageUpper = 14
  • ผู้ใช้ที่มีอายุ 15 ปีขึ้นไปจะได้รับ ageLower = 15

การตอบกลับของสัญญาณอายุ

การตอบกลับของ Play Age Signals API (เบต้า) จะมีช่องและค่าต่อไปนี้ ค่าอาจมีการเปลี่ยนแปลง หากต้องการค่าล่าสุด ให้ส่งคำขอการตอบกลับจาก API เมื่อแอปเปิดขึ้น คุณมีหน้าที่รับผิดชอบในการมอบประสบการณ์การใช้งานที่เหมาะสมกับวัยโดยใช้สัญญาณเหล่านี้

ตัวอย่างการตอบกลับสำหรับผู้ใช้ในบราซิล

ในบราซิล userStatus จะเป็น DECLARED, UNKNOWN หรือ null เท่านั้น

สำหรับผู้ใช้ที่ประกาศอายุและแชร์อายุกับแอป คุณจะได้รับข้อมูลต่อไปนี้

• userStatus จะเป็น AgeSignalsVerificationStatus.DECLARED
• ageLower จะเป็นตัวเลข (เช่น 13)
• ageUpper จะเป็นตัวเลขหรือ null (เช่น 15)
• ช่องการตอบกลับอื่นๆ จะเป็น null

สำหรับผู้ใช้ที่ไม่ทราบอายุ คุณจะได้รับข้อมูลต่อไปนี้

• userStatus จะเป็น AgeSignalsVerificationStatus.UNKNOWN
• ช่องการตอบกลับอื่นๆ จะเป็น null

สำหรับผู้ใช้ที่ไม่ได้แชร์อายุกับแอป คุณจะได้รับข้อมูลต่อไปนี้

• userStatus จะเป็น null
• ช่องการตอบกลับอื่นๆ จะเป็น null

สถานะผู้ใช้อาจเปลี่ยนเป็น DECLARED เมื่ออายุของผู้ใช้พร้อมให้แชร์

ตัวอย่างการตอบกลับสำหรับผู้ใช้ในรัฐต่างๆ ของสหรัฐอเมริกา

ในรัฐที่เกี่ยวข้องของสหรัฐอเมริกา userStatus จะเป็น VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN, หรือ null

สำหรับผู้ใช้ที่ยืนยันแล้ว คุณจะได้รับข้อมูลต่อไปนี้

• userStatus จะเป็น AgeSignalsVerificationStatus.VERIFIED
• ageLower จะเป็นตัวเลข (เช่น 18)
• ageUpper จะเป็นตัวเลขหรือ null (เช่น null)
• ช่องการตอบกลับอื่นๆ จะเป็น null

สำหรับผู้ใช้ภายใต้การควบคุมดูแล คุณจะได้รับข้อมูลต่อไปนี้

• userStatus จะเป็น AgeSignalsVerificationStatus.SUPERVISED
• ageLower จะเป็นตัวเลข (เช่น 13)
• ageUpper จะเป็นตัวเลขหรือ null (เช่น 15)
• mostRecentApprovalDate จะเป็นออบเจ็กต์วันที่ Java (เช่น 2026-01-01) หรือ null (หากไม่มี การเปลี่ยนแปลงที่สำคัญ ได้รับการอนุมัติ)
• installID จะเป็นรหัสตัวอักษรและตัวเลขที่สร้างโดย Play (เช่น 550e8400-e29b-41d4-a716-446655441111)

สำหรับผู้ใช้ภายใต้การควบคุมดูแลที่มีการอนุมัติการเปลี่ยนแปลงที่สำคัญรอดำเนินการ คุณจะได้รับข้อมูลต่อไปนี้

• userStatus จะเป็น AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING
• ageLower จะเป็นตัวเลข (เช่น 13)
• ageUpper จะเป็นตัวเลขหรือ null (เช่น 15)
• mostRecentApprovalDate จะเป็นออบเจ็กต์วันที่ Java (เช่น 2026-01-01) หรือ null (หากไม่มี การเปลี่ยนแปลงที่สำคัญ ได้รับการอนุมัติ)
• installID จะเป็นรหัสตัวอักษรและตัวเลขที่สร้างโดย Play (เช่น 550e8400-e29b-41d4-a716-446655441111)

จัดการรหัสข้อผิดพลาดของ API

หากแอปของคุณส่งคำขอ Play Age Signals API และการเรียกใช้ไม่สำเร็จ แอปจะได้รับรหัสข้อผิดพลาด ข้อผิดพลาดเหล่านี้อาจเกิดขึ้นได้จากหลายสาเหตุ เช่น แอป Play Store ล้าสมัย

กลยุทธ์การลองใหม่

ในสถานการณ์ที่ผู้ใช้อยู่ในเซสชัน เราขอแนะนำให้ใช้กลยุทธ์การลองใหม่โดยกำหนดจำนวนครั้งที่ลองสูงสุดเป็นเงื่อนไขการออก เพื่อให้ข้อผิดพลาดรบกวนประสบการณ์ของผู้ใช้น้อยที่สุด