درک پاسخ‌های سیگنال‌های سنی

این سند پاسخ‌های سیگنال سن برگردانده شده توسط API سیگنال‌های سن بازی را توضیح می‌دهد.

(اختیاری) دریافت محدوده‌های سنی سفارشی

محدوده‌های سنی پیش‌فرض که API برمی‌گرداند 0-12 ، 13-15 ، 16-17 و 18+ هستند.

روش دیگر، برای سفارشی‌سازی محدوده‌های سنی پیش‌فرض با توجه به حداقل سن برنامه‌تان، می‌توانید این حداقل سن‌ها را برای برنامه‌تان در صفحه Age signals در کنسول گوگل پلی خود ارائه دهید.

  1. به صفحه سیگنال‌های سنی در کنسول Play خود بروید.
  2. در برگه «محدوده‌های سنی سفارشی» ، حداکثر سه سن حداقلی برای برنامه خود وارد کنید. حداقل سن باید حداقل ۲ سال فاصله داشته باشد و می‌تواند سالی یک بار تغییر کند.
  3. روی ذخیره کلیک کنید.

محدوده‌های سنی برگردانده شده، پاسخ پیش‌فرض API را نادیده می‌گیرند. برای مثال:

  • اگر در کنسول گوگل پلی یک حداقل سن (۱۵ سال) تعیین کنید:
    • برای یک کودک ۰ تا ۱۴ ساله، ageLower = 0 و ageUpper = 14 برگردانده می‌شود.
    • یک فرد ۱۵ سال به بالا ageLower = 15 برمی‌گرداند.
  • اگر دو حداقل سن (۱۳ و ۱۷) تعیین کنید:
    • برای یک کودک ۰ تا ۱۲ ساله، ageLower = 0 و ageUpper = 12 را برمی‌گرداند.
    • یک فرد ۱۳ تا ۱۶ ساله ageLower = 13 و ageUpper = 16 را برمی‌گرداند.
    • یک فرد ۱۷ ساله یا بیشتر، ageLower = 17 برمی‌گرداند.
  • اگر سه حداقل سن (۱۱، ۱۳ و ۱۵) تعیین کنید:
    • یک کودک ۰ تا ۱۰ ساله ageLower = 0 و ageUpper = 10 را برمی‌گرداند.
    • یک کودک ۱۱ یا ۱۲ ساله ageLower = 11 و ageUpper = 12 را برمی‌گرداند.
    • یک فرد ۱۳ یا ۱۴ ساله ageLower = 13 و ageUpper = 14 را برمی‌گرداند.
    • یک فرد ۱۵ سال به بالا ageLower = 15 برمی‌گرداند.

میدان‌های پاسخ سیگنال‌های سنی

پاسخ API سیگنال‌های سن بازی (بتا) شامل فیلدها و مقادیر زیر است. شما مسئول ارائه تجربیات متناسب با سن با استفاده از این سیگنال‌ها هستید.

فیلد پاسخ نوع ارزش‌ها توضیحات
محدوده سنی منبع شمارشی
  • سطح A
  • TIER_B
  • TIER_C
  • TIER_D
  • تهی
  • TIER_A : کاربر سن خود را اعلام کرده است.
  • TIER_B : سن کاربر توسط والدین یا قیم او مدیریت می‌شود.
  • TIER_C : سن کاربر با استفاده از کارت اعتباری، آدرس ایمیل، ارزیابی سلفی، کارت شناسایی دولتی یا کارت شناسایی مالیاتی ارزیابی می‌شود.
  • TIER_D : سن کاربر با استفاده از ترکیبی از کارت شناسایی دولتی و ارزیابی سلفی یا کارت شناسایی دیجیتال بررسی می‌شود.
  • null : زمانی که ageSignalsStatus برابر با NOT_SHARED یا VERIFICATION_REQUIRED باشد، بازگردانده می‌شود.
سنپایین تر عدد صحیح
  • ۰ تا ۱۸
  • تهی
 حد پایینِ فراگیرِ محدوده سنی کاربر. آن را با ageUpper ترکیب کنید تا محدوده را تعیین کنید.

اگر ageSignalsStatus برابر با NOT_SHARED یا VERIFICATION_REQUIRED باشد، مقدار null را برمی‌گرداند.

سنبالا عدد صحیح
  • ۲ تا ۱۸
  • تهی
 حد بالای فراگیر محدوده سنی کاربر.

برای بالاترین باند (برای مثال، ۱۸+) یا اگر ageSignalsStatus برابر NOT_SHARED یا VERIFICATION_REQUIRED باشد، مقدار null را برمی‌گرداند.

وضعیت تغییر قابل توجه شمارشی
  • تایید شده
  • در حال بررسی
  • رد شد
  • تهی
 این فقط در حوزه‌های قضایی که تغییرات قابل توجهی اعمال می‌شود، مقداری غیر تهی برمی‌گرداند.
  • تأیید شده : جدیدترین تغییر مهم (و تمام تغییرات قبلی) تأیید شده است.
  • در حال بررسی : والد هنوز یک یا چند تغییر مهم در حال بررسی را تأیید نکرده است.
  • رد شد : والدین از تأیید یک یا چند تغییر مهم خودداری کردند.
  • null : برای موارد زیر برگردانده می‌شود:
    • همه حساب‌های بدون نظارت
    • حساب‌های تحت نظارت که هنوز هیچ تغییر قابل توجهی در آنها ثبت نشده است.
تاریخ تأیید تغییر قابل توجه تاریخ
  • مهر تاریخ
  • تهی
 تاریخ اجرای آخرین تغییر مهم تأیید شده. تمام تغییراتی که تاریخ اجرای آنها قبل از این تاریخ است نیز تأیید می‌شوند. در صورت عدم وجود تغییر، مقدار null را برمی‌گرداند.

آن را با `significantChangeStatus` ترکیب کنید تا وضعیت تأیید این تغییر مهم را دریافت کنید.

شناسه نصب رشته
  • الفبایی-عددی
  • تهی
 شناسه‌ای که توسط گوگل پلی به نصب‌های تحت نظارت کاربران اختصاص داده شده و برای اطلاع‌رسانی در مورد لغو تأیید برنامه استفاده می‌شود. مستندات مربوط به لغو تأیید برنامه‌ها را بررسی کنید.

مثال ۱

برای کاربری که سن خود را با استفاده از شناسه دیجیتال تأیید کرده و آن را با برنامه‌ها به اشتراک گذاشته است، موارد زیر را دریافت می‌کنید:

  • ageRangeSource AgeRangeSource.TIER_D است.
  • ageLower یک عدد است (برای مثال، ۱۸).
  • ageUpper null است.
  • سایر فیلدهای پاسخ null هستند.

مثال ۲

برای یک کاربر بزرگسال که سن خود را اعلام کرده (خوداظهاری کرده) و آن را با برنامه‌ها به اشتراک می‌گذارد، موارد زیر را دریافت می‌کنید:

  • ageRangeSource AgeRangeSource.TIER_A است.
  • ageLower یک عدد است (برای مثال، ۱۸).
  • ageUpper null است.
  • فیلدهای پاسخ دیگر null هستند.

مثال ۳

برای یک کاربر خردسال تحت نظارت که سن او توسط قیم او که آن را با برنامه‌ها به اشتراک گذاشته است، مدیریت می‌شود، موارد زیر را دریافت می‌کنید:

  • ageRangeSource AgeRangeSource.TIER_B است.
  • ageLower یک عدد است (مثلاً ۱۳).
  • ageUpper یک عدد است (برای مثال، ۱۵).
  • فیلدهای پاسخ دیگر null هستند.

مثال ۴

برای کاربری که با اشتراک‌گذاری سنی موافقت نکرده است (یا والدینش موافقت نکرده‌اند)، موارد زیر را دریافت خواهید کرد:

  • ageRangeSource null است.
  • ageLower null است.
  • ageUpper null است.
  • فیلدهای پاسخ دیگر null هستند.

مثال ۵

برای یک کاربر بزرگسال که سنش با استفاده از روش‌های تخمین سن (مانند ارزیابی سلفی، کارت اعتباری یا شناسه مالیاتی) تأیید شده و آن را با برنامه‌ها به اشتراک می‌گذارد، موارد زیر را دریافت می‌کنید:

  • ageRangeSource AgeRangeSource.TIER_C است.
  • ageLower یک عدد است (برای مثال، ۱۸).
  • ageUpper null است.
  • فیلدهای پاسخ دیگر null هستند.

مثال ۶

برای یک کاربر خردسال تحت نظارت که سن او توسط قیم مدیریت می‌شود، با یک تغییر قابل توجه تأیید شده و ردیابی نصب فعال، موارد زیر را دریافت می‌کنید:

  • ageRangeSource AgeRangeSource.TIER_B است.
  • ageLower یک عدد است (مثلاً ۱۳).
  • ageUpper یک عدد است (برای مثال، ۱۵).
  • significantChangeStatus به SignificantChangeStatus.APPROVED است.
  • significantChangeApprovalDate یک تاریخ است (برای مثال، "2026-01-15").
  • installId یک شناسه رشته‌ای است (برای مثال، "abc123xyz789").
قبلی
درخواست سیگنال سن
بعدی
سیگنال‌های سنی را آزمایش کنید