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

เอกสารนี้อธิบายการตอบกลับสัญญาณอายุที่ 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: ผู้ใช้ประกาศอายุของตนเอง
  • TIER_B: ผู้ปกครองจัดการอายุของผู้ใช้
  • TIER_C: ระบบประเมินอายุของผู้ใช้โดยใช้บัตรเครดิต อีเมล การประเมินเซลฟี บัตรประจำตัวที่ออกโดยหน่วยงานราชการ หรือหมายเลขประจำตัวผู้เสียภาษี
  • TIER_D: ระบบตรวจสอบอายุของผู้ใช้โดยใช้การผสมผสาน ระหว่างบัตรประจำตัวที่ออกโดยหน่วยงานราชการและการประเมินเซลฟี หรือบัตรประจำตัวดิจิทัล
  • null: แสดงเมื่อ ageSignalsStatus เป็น NOT_SHARED หรือ VERIFICATION_REQUIRED
ageLower จำนวนเต็ม
  • 0 ถึง 18
  • null
 ขอบเขตล่างแบบรวมของช่วงอายุของผู้ใช้ รวมกับ ageUpper เพื่อกำหนดช่วง

แสดงผลเป็น null หาก ageSignalsStatus เป็น NOT_SHARED หรือ VERIFICATION_REQUIRED
ageUpper จำนวนเต็ม
  • 2 ถึง 18
  • null
 ขอบเขตบนแบบรวมของช่วงอายุของผู้ใช้

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

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

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

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

  • ageRangeSource คือ AgeRangeSource.TIER_D
  • ageLower เป็นตัวเลข (เช่น 18)
  • ageUpper คือ null
  • ช่องการตอบกลับอื่นๆ คือ null

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

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

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

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

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

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

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

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

  • ageRangeSource คือ null
  • ageLower คือ null
  • ageUpper คือ null
  • ช่องการตอบกลับอื่นๆ คือ null

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

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

  • ageRangeSource คือ AgeRangeSource.TIER_C
  • ageLower เป็นตัวเลข (เช่น 18)
  • ageUpper คือ null
  • ช่องการตอบกลับอื่นๆ คือ null

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

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

  • ageRangeSource คือ AgeRangeSource.TIER_B
  • ageLower เป็นตัวเลข (เช่น 13)
  • ageUpper เป็นตัวเลข (เช่น 15)
  • significantChangeStatus คือ SignificantChangeStatus.APPROVED
  • significantChangeApprovalDate คือวันที่ (เช่น "2026-01-15")
  • installId คือตัวระบุสตริง (เช่น "abc123xyz789")
ก่อนหน้า
ขอสัญญาณอายุ
ถัดไป
ทดสอบสัญญาณอายุ