ทำความเข้าใจการตอบกลับสัญญาณอายุ

เอกสารนี้อธิบายการตอบกลับสัญญาณอายุที่แสดงผลโดย Play Age Signals API

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

ช่วงอายุเริ่มต้นที่ 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 (เบต้า) ประกอบด้วยช่องและค่าต่อไปนี้ คุณมีหน้าที่รับผิดชอบในการมอบประสบการณ์การใช้งานที่เหมาะสมกับวัยโดยใช้สัญญาณเหล่านี้

ช่องคําตอบ ประเภท ค่า คำอธิบาย
ageRangeSource ค่าแจกแจง
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A: ผู้ใช้ได้ให้ข้อมูลอายุแก่ Google แล้ว Google อาจยืนยันหรือไม่ยืนยันข้อมูลนี้
  • TIER_B: อายุของผู้ใช้ได้รับการจัดการโดยพ่อแม่หรือผู้ปกครอง
  • TIER_C*: อายุของผู้ใช้ได้รับการประเมินโดยใช้บัตรเครดิต อีเมล การประเมินด้วยเซลฟี บัตรประจำตัวที่ออกโดยหน่วยงานราชการ หรือหมายเลขประจำตัวผู้เสียภาษี
  • TIER_D*: อายุของผู้ใช้ได้รับการตรวจสอบโดยใช้บัตรประจำตัวที่ออกโดยหน่วยงานราชการและการประเมินเซลฟีร่วมกัน หรือบัตรประจำตัวดิจิทัล
  • null: แสดงผลเมื่อ ageSignalsStatus เป็น NOT_SHARED หรือ VERIFICATION_REQUIRED
* แสดงผลเฉพาะในภูมิภาคที่มีการกำกับดูแลซึ่งต้องมีการยืนยันอายุ (เช่น US-TX)
ageLower จำนวนเต็ม
  • 0 ถึง 18
  • null
ขอบเขตล่างแบบรวมของช่วงอายุของผู้ใช้ ใช้ร่วมกับ ageUpper เพื่อกำหนดช่วงอายุ

แสดงผลเป็น null หาก ageSignalsStatus เป็น NOT_SHARED หรือ VERIFICATION_REQUIRED

ageUpper จำนวนเต็ม
  • 2 ถึง 18
  • null
ขอบเขตบนแบบรวมของช่วงอายุของผู้ใช้

แสดงผลเป็น null สำหรับกลุ่มอายุสูงสุด (เช่น 18 ปีขึ้นไป) หรือหาก ageSignalsStatus เป็น NOT_SHARED หรือ VERIFICATION_REQUIRED

significantChangeStatus ค่าแจกแจง
  • APPROVED
  • รอดำเนินการ
  • ไม่ไป
  • null
ซึ่งจะแสดงผลค่าที่ไม่ใช่ Null ในเขตอำนาจศาลที่มีการเปลี่ยนแปลงที่สำคัญเท่านั้น
  • APPROVED: การเปลี่ยนแปลงที่สำคัญล่าสุด (และการเปลี่ยนแปลงก่อนหน้าทั้งหมด) ได้รับอนุมัติแล้ว
  • PENDING: ผู้ปกครองยังไม่ได้อนุมัติการเปลี่ยนแปลงที่สำคัญที่รอดำเนินการอย่างน้อย 1 รายการ
  • DECLINED: ผู้ปกครองปฏิเสธการอนุมัติการเปลี่ยนแปลงที่สำคัญอย่างน้อย 1 รายการ
  • null: แสดงผลสำหรับ
    • บัญชีที่ไม่ได้อยู่ภายใต้การควบคุมดูแลทั้งหมด
    • บัญชีที่มีการควบคุมดูแลซึ่งยังไม่มีการบันทึกการเปลี่ยนแปลงที่สำคัญ
significantChangeApprovalDate วันที่
  • DateStamp
  • null
วันที่มีผลของการเปลี่ยนแปลงที่สำคัญซึ่งได้รับอนุมัติล่าสุด การเปลี่ยนแปลงทั้งหมดที่มีวันที่มีผลก่อนวันที่นี้จะได้รับอนุมัติด้วย แสดงผล null หากไม่มีการเปลี่ยนแปลง

รวมเข้ากับ `significantChangeStatus` เพื่อดูสถานะการอนุมัติสำหรับการเปลี่ยนแปลงที่สำคัญนี้

installId สตริง
  • ตัวอักษรและตัวเลข
  • null
รหัสที่ Google Play กำหนดให้กับการติดตั้งของผู้ใช้ภายใต้การควบคุมดูแล ซึ่งใช้เพื่อวัตถุประสงค์ในการแจ้งให้คุณทราบเกี่ยวกับการอนุมัติแอปที่ถูกเพิกถอน อ่านเอกสารประกอบเกี่ยวกับการอนุมัติแอปที่ถูกเพิกถอน

ตัวอย่างที่ 1

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

  • ในภูมิภาคที่มีการกำกับดูแลซึ่งกำหนดให้มีการยืนยันอายุ

    • ageRangeSource AgeRangeSource.TIER_D
    • ageLower คือตัวเลข (เช่น 18)
    • ageUpper null
    • ช่องคำตอบอื่นๆ คือ null
  • ในพื้นที่อื่นๆ

    • ageRangeSource AgeRangeSource.TIER_A
    • ageLower คือตัวเลข (เช่น 18)
    • ageUpper null
    • ช่องคำตอบอื่นๆ คือ null

ตัวอย่างที่ 2

สำหรับผู้ใช้ที่เป็นผู้ใหญ่ซึ่งยืนยันอายุโดยใช้วิธีการประมาณอายุ (เช่น การประเมินด้วยเซลฟี บัตรเครดิต หรือหมายเลขประจำตัวผู้เสียภาษี) คุณจะได้รับข้อมูลต่อไปนี้

  • ในภูมิภาคที่มีการกำกับดูแลซึ่งกำหนดให้มีการยืนยันอายุ

    • ageRangeSource AgeRangeSource.TIER_C
    • ageLower คือตัวเลข (เช่น 18)
    • ageUpper null
    • ช่องคำตอบอื่นๆ คือ null
  • ในพื้นที่อื่นๆ

    • ageRangeSource AgeRangeSource.TIER_A
    • ageLower คือตัวเลข (เช่น 18)
    • ageUpper null
    • ช่องคำตอบอื่นๆ คือ null

ตัวอย่างที่ 3

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

  • ageRangeSource AgeRangeSource.TIER_A
  • ageLower คือตัวเลข (เช่น 18)
  • ageUpper null
  • ช่องคำตอบอื่นๆ คือ null

ตัวอย่างที่ 4

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

  • ageRangeSource AgeRangeSource.TIER_B
  • ageLower คือตัวเลข (เช่น 13)
  • ageUpper คือตัวเลข (เช่น 15)
  • ช่องคำตอบอื่นๆ คือ null

ตัวอย่างที่ 5

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

  • ageRangeSource null
  • ageLower null
  • ageUpper null
  • ช่องคำตอบอื่นๆ คือ null

ตัวอย่างที่ 6

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

  • ageRangeSource AgeRangeSource.TIER_B
  • ageLower คือตัวเลข (เช่น 13)
  • ageUpper คือตัวเลข (เช่น 15)
  • significantChangeStatus SignificantChangeStatus.APPROVED
  • significantChangeApprovalDate คือวันที่ (เช่น "2026-01-15")
  • installId คือตัวระบุสตริง (เช่น "abc123xyz789")