เอกสารนี้อธิบายการตอบกลับสัญญาณอายุที่แสดงผลโดย Play Age Signals API
(ไม่บังคับ) รับช่วงอายุที่กำหนดเอง
ช่วงอายุเริ่มต้นที่ API แสดงผลคือ 0-12, 13-15, 16-17 และ 18+
หรือหากต้องการปรับแต่งช่วงอายุเริ่มต้นตามอายุขั้นต่ำของแอป คุณสามารถระบุอายุขั้นต่ำเหล่านี้สำหรับแอปได้ในหน้าสัญญาณอายุใน Google Play Console
- ไปที่หน้าสัญญาณอายุใน Play Console
- ในแท็บช่วงอายุที่กำหนดเอง ให้ป้อนอายุขั้นต่ำสำหรับแอปของคุณได้สูงสุด 3 รายการ อายุขั้นต่ำต้องห่างกันอย่างน้อย 2 ปี และสามารถเปลี่ยนแปลงได้ปีละครั้ง
- คลิกบันทึก
ช่วงอายุที่แสดงผลจะลบล้างการตอบกลับจาก API เริ่มต้น เช่น
- หากคุณตั้งอายุขั้นต่ำไว้ 1 ค่า (15 ปี) ใน Google Play Console จะเป็นดังนี้
- ผู้ที่มีอายุ 0-14 ปีจะแสดงผลเป็น
ageLower = 0และageUpper = 14 - ผู้ที่มีอายุตั้งแต่ 15 ปีขึ้นไปจะได้รับผลลัพธ์เป็น
ageLower = 15
- ผู้ที่มีอายุ 0-14 ปีจะแสดงผลเป็น
- หากคุณตั้งอายุขั้นต่ำไว้ 2 ช่วง (13 และ 17 ปี)
- เด็กอายุ 0-12 ปีจะแสดงผล
ageLower = 0และageUpper = 12 - ผู้ใช้ที่มีอายุ 13-16 ปีจะแสดงผลเป็น
ageLower = 13และageUpper = 16 - ผู้ที่มีอายุตั้งแต่ 17 ปีขึ้นไปจะเห็น
ageLower = 17
- เด็กอายุ 0-12 ปีจะแสดงผล
- หากคุณตั้งอายุขั้นต่ำไว้ 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
- เด็กอายุ 0 ถึง 10 ปีจะแสดงผลเป็น
ช่องการตอบกลับสัญญาณอายุ
การตอบกลับของ Play Age Signals API (เบต้า) ประกอบด้วยช่องและค่าต่อไปนี้ คุณมีหน้าที่รับผิดชอบในการมอบประสบการณ์การใช้งานที่เหมาะสมกับวัยโดยใช้สัญญาณเหล่านี้
| ช่องคําตอบ | ประเภท | ค่า | คำอธิบาย |
|---|---|---|---|
| ageRangeSource | ค่าแจกแจง |
|
|
| ageLower | จำนวนเต็ม |
|
ขอบเขตล่างแบบรวมของช่วงอายุของผู้ใช้ ใช้ร่วมกับ ageUpper เพื่อกำหนดช่วงอายุ
แสดงผลเป็น null หาก ageSignalsStatus เป็น NOT_SHARED หรือ VERIFICATION_REQUIRED |
| ageUpper | จำนวนเต็ม |
|
ขอบเขตบนแบบรวมของช่วงอายุของผู้ใช้
แสดงผลเป็น null สำหรับช่วงอายุสูงสุด (เช่น 18 ปีขึ้นไป) หรือหาก ageSignalsStatus เป็น NOT_SHARED หรือ VERIFICATION_REQUIRED |
| significantChangeStatus | ค่าแจกแจง |
|
ซึ่งจะแสดงผลค่าที่ไม่ใช่ Null ในเขตอำนาจศาลที่มีการเปลี่ยนแปลงที่สำคัญเท่านั้น
|
| significantChangeApprovalDate | วันที่ |
|
วันที่มีผลของการเปลี่ยนแปลงที่สำคัญซึ่งได้รับอนุมัติล่าสุด การเปลี่ยนแปลงทั้งหมดที่มีวันที่มีผลก่อนวันที่นี้จะได้รับอนุมัติด้วย แสดงผล null หากไม่มีการเปลี่ยนแปลง
รวมเข้ากับ `significantChangeStatus` เพื่อดูสถานะการอนุมัติสำหรับการเปลี่ยนแปลงที่สำคัญนี้ |
| installId | สตริง |
|
รหัสที่ Google Play กำหนดให้กับการติดตั้งของผู้ใช้ภายใต้การควบคุมดูแล ซึ่งใช้เพื่อวัตถุประสงค์ในการแจ้งให้คุณทราบเกี่ยวกับการอนุมัติแอปที่ถูกเพิกถอน อ่านเอกสารประกอบเกี่ยวกับการอนุมัติแอปที่ถูกเพิกถอน |
ตัวอย่างที่ 1
สำหรับผู้ใช้ที่เป็นผู้ใหญ่ซึ่งยืนยันอายุโดยใช้บัตรประจำตัวดิจิทัล คุณจะได้รับข้อมูลต่อไปนี้
ในภูมิภาคที่มีการกำกับดูแลซึ่งกำหนดให้มีการยืนยันอายุ
ageRangeSourceAgeRangeSource.TIER_DageLowerคือตัวเลข (เช่น 18)ageUppernull- ช่องคำตอบอื่นๆ คือ
null
ในพื้นที่อื่นๆ
ageRangeSourceAgeRangeSource.TIER_AageLowerคือตัวเลข (เช่น 18)ageUppernull- ช่องคำตอบอื่นๆ คือ
null
ตัวอย่างที่ 2
สำหรับผู้ใช้ที่เป็นผู้ใหญ่ซึ่งยืนยันอายุโดยใช้วิธีการประมาณอายุ (เช่น การประเมินด้วยเซลฟี บัตรเครดิต หรือหมายเลขประจำตัวผู้เสียภาษี) คุณจะได้รับข้อมูลต่อไปนี้
ในภูมิภาคที่มีการกำกับดูแลซึ่งกำหนดให้มีการยืนยันอายุ
ageRangeSourceAgeRangeSource.TIER_CageLowerคือตัวเลข (เช่น 18)ageUppernull- ช่องคำตอบอื่นๆ คือ
null
ในพื้นที่อื่นๆ
ageRangeSourceAgeRangeSource.TIER_AageLowerคือตัวเลข (เช่น 18)ageUppernull- ช่องคำตอบอื่นๆ คือ
null
ตัวอย่างที่ 3
สำหรับผู้ใช้ที่อยู่ในภูมิภาคที่การยืนยันอายุไม่บังคับและแชร์ข้อมูลกับแอป คุณจะได้รับข้อมูลต่อไปนี้
ageRangeSourceAgeRangeSource.TIER_AageLowerคือตัวเลข (เช่น 18)ageUppernull- ช่องคำตอบอื่นๆ คือ
null
ตัวอย่างที่ 4
สำหรับผู้ใช้ที่เป็นผู้เยาว์ภายใต้การควบคุมดูแลซึ่งมีอายุที่จัดการโดยผู้ปกครองที่แชร์อายุกับแอป คุณจะได้รับข้อมูลต่อไปนี้
ageRangeSourceAgeRangeSource.TIER_BageLowerคือตัวเลข (เช่น 13)ageUpperคือตัวเลข (เช่น 15)- ช่องคำตอบอื่นๆ คือ
null
ตัวอย่างที่ 5
สำหรับผู้ใช้ที่ไม่ได้ยินยอม (หรือผู้ปกครองไม่ได้ยินยอม) ให้แชร์อายุในภูมิภาคที่ไม่ได้กำหนดให้ต้องมีการยืนยันอายุ คุณจะได้รับข้อมูลต่อไปนี้
ageRangeSourcenullageLowernullageUppernull- ช่องคำตอบอื่นๆ คือ
null
ตัวอย่างที่ 6
สำหรับผู้ใช้ที่เป็นผู้เยาว์ภายใต้การควบคุมดูแลซึ่งมีผู้ปกครองเป็นผู้จัดการอายุ โดยมีการเปลี่ยนแปลงที่สำคัญที่ได้รับอนุมัติและจำนวนการติดตั้งที่มีการใช้งาน คุณจะได้รับข้อมูลต่อไปนี้
ageRangeSourceAgeRangeSource.TIER_BageLowerคือตัวเลข (เช่น 13)ageUpperคือตัวเลข (เช่น 15)significantChangeStatusSignificantChangeStatus.APPROVEDsignificantChangeApprovalDateคือวันที่ (เช่น "2026-01-15")installIdคือตัวระบุสตริง (เช่น "abc123xyz789")