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

این سند پاسخ‌های نشان سن را که توسط 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: کاربر اطلاعات سن خود را به Google ارائه کرده است. Google ممکن است این اطلاعات را تأیید کرده یا نکرده باشد.
  • TIER_B: سن کاربر توسط ولی یا سرپرست مدیریت می‌شود.
  • TIER_C*: سن کاربر بااستفاده از کارت اعتباری، نشانی ایمیل، ارزیابی سلفی، مدرک شناسایی دولتی، یا شناسه مالیاتی ارزیابی می‌شود.
  • TIER_D*: سن کاربر بااستفاده از ترکیبی از مدرک شناسایی دولتی و ارزیابی سلفی، یا شناسه دیجیتال بررسی می‌شود.
  • null: وقتی ageSignalsStatus برابر با NOT_SHARED یا VERIFICATION_REQUIRED باشد، برگردانده می‌شود.
* فقط در مناطق تحت نظارت قانون که درستی‌سنجی سن در آن‌ها اجباری است (برای مثال، US-TX) برگردانده می‌شود.
ageLower عدد صحیح
  • ‫۰ تا ۱۸
  • null
کران پایین شامل محدوده سنی کاربر. آن را با ageUpper ترکیب کنید تا باند را تعیین کنید.

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

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

برای بالاترین محدوده (مثلاً ۱۸+) یا اگر 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_C است.
    • ageLower یک عدد است (برای مثال، ۱۸).
    • ageUpper null است.
    • فیلدهای پاسخ دیگر null است
  • هرجای دیگر:

    • ageRangeSource AgeRangeSource.TIER_A است.
    • 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_B است.
  • ageLower یک عدد است (برای مثال، ۱۳).
  • ageUpper یک عدد است (برای مثال، ۱۵).
  • significantChangeStatus SignificantChangeStatus.APPROVED است.
  • ‫significantChangeApprovalDate تاریخ است (برای مثال، «2026-01-15»).
  • installId شناسه رشته است (برای مثال، «abc123xyz789»).