درک پاسخ‌های نشان‌های سن

این سند پاسخ‌های نشان سن را که توسط Play Age Signals API برگردانده شده است توضیح می‌دهد.

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

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

یا برای سفارشی‌سازی کردن گروه‌های سنی پیش‌فرض براساس حداقل سن‌های برنامه‌تان، می‌توانید این حداقل سن‌ها را برای برنامه‌تان در صفحه نشان‌های سن در «کنسول Google Play» ارائه دهید.

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

گروه‌های سنی برگردانده‌شده پاسخ پیش‌فرض میانای برنامه‌سازی کاربردی را لغو خواهد کرد. برای مثال:

  • اگر یک حداقل سن (۱۵) در «کنسول Google Play» تنظیم کنید:
    • ‫۰ تا ۱۴ سال 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 را برمی‌گرداند.

فیلدهای پاسخ نشان‌های سن

پاسخ 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 عدد صحیح
  • ‫۰ تا ۱۸
  • null
 کران پایین شامل محدوده سنی کاربر. آن را با ageUpper ترکیب کنید تا باند را تعیین کنید.

اگر ageSignalsStatus برابر با NOT_SHARED یا VERIFICATION_REQUIRED باشد، null برمی‌گرداند.
ageUpper عدد صحیح
  • ‫۲ تا ۱۸
  • تهی
 کران بالای شامل محدوده سنی کاربر.

برای بالاترین باند (برای مثال، بالای ۱۸ سال) یا اگر ageSignalsStatus برابر با NOT_SHARED یا VERIFICATION_REQUIRED باشد، null برمی‌گرداند.
significantChangeStatus شمارشی
  • تأییدشده
  • درانتظار
  • پذیرفته نشد
  • null
 این فقط در حوزه‌های قضایی که تغییرات قابل‌توجهی در آن‌ها اعمال می‌شود، مقدار غیرتهی برمی‌گرداند.
  • تأییدشده: جدیدترین تغییر قابل‌توجه (و همه تغییرات قبلی) تأیید شده است.
  • درانتظار: ولی هنوز یک یا چند تغییر قابل‌توجه معلقه را تأیید نکرده است.
  • ردشده: والدین یک یا چند تغییر اساسی را تأیید نکرده‌اند.
  • null: Returned for:
    • همه حساب‌های بدون نظارت
    • حساب‌های تحت نظارتی که هنوز هیچ تغییر قابل‌توجهی برای آن‌ها ثبت نشده است.
significantChangeApprovalDate تاریخ
  • مهر تاریخ
  • null
 تاریخ اعمال جدیدترین تغییر مهم تأییدشده. همه تغییرات با تاریخ‌های اجرا قبل‌از این تاریخ نیز تأیید شده‌اند. اگر تغییری وجود نداشته باشد، null را برمی‌گرداند.

آن را با `significantChangeStatus` ترکیب کنید تا وضعیت تأیید این تغییر قابل‌توجه را دریافت کنید
installId رشته
  • حرفی عددی
  • null
 شناسه‌ای که Google Play به نصب‌های کاربر تحت نظارت اختصاص می‌دهد و برای اطلاع‌رسانی به شما درباره تأییدیه برنامه باطل‌شده استفاده می‌شود. اسناد مربوط به تأییدیه‌های لغوشده برنامه را مرور کنید.

مثال ۱

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

  • 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»).
قبلی
درخواست نشان‌های سن
بعدی
آزمایش کردن نشان‌های سن