فهم الردود على مؤشرات الفئات العمرية

توضّح هذه المقالة الردود على مؤشرات الفئات العمرية التي تعرضها واجهة Play Age Signals API.

(اختياري) تلقّي فئات عمرية مخصّصة

إنّ الفئات العمرية التلقائية التي تعرضها واجهة برمجة التطبيقات هي 0-12 و13-15 و16-17 و18+.

بدلاً من ذلك، لتخصيص الفئات العمرية التلقائية وفقًا للحدّ الأدنى للعمر المسموح به في تطبيقك، يمكنك تقديم هذه الفئات العمرية لتطبيقك على صفحة مؤشرات الفئات العمرية في Google Play Console.

  1. انتقِل إلى صفحة "مؤشرات الفئات العمرية" في Play Console.
  2. في علامة التبويب فئات عمرية مخصّصة ، أدخِل ما يصل إلى ثلاث فئات عمرية مختلفة ضمن الحدّ الأدنى للعمر المسموح به في تطبيقك. يجب ألا يقل الفارق العمري عن سنتَين، ويمكن تغييره مرة واحدة سنويًا.
  3. انقر على حفظ.

ستحلّ الفئات العمرية المعروضة محلّ الردّ التلقائي من واجهة برمجة التطبيقات. على سبيل المثال:

  • إذا ضبطت فئة عمرية واحدة ضمن الحدّ الأدنى للعمر (15) في Google Play Console:
    • سيتم عرض ageLower = 0 وageUpper = 14 للمستخدمين الذين تتراوح أعمارهم بين 0 و14 عامًا.
    • سيتم عرض ageLower = 15 للمستخدمين الذين تبلغ أعمارهم 15 عامًا أو أكثر.
  • إذا ضبطت فئتَين عمريتَين ضمن الحدّ الأدنى للعمر (13 و17):
    • سيتم عرض ageLower = 0 وageUpper = 12 للمستخدمين الذين تتراوح أعمارهم بين 0 و12 عامًا.
    • سيتم عرض ageLower = 13 وageUpper = 16 للمستخدمين الذين تتراوح أعمارهم بين 13 و16 عامًا.
    • سيتم عرض ageLower = 17 للمستخدمين الذين تبلغ أعمارهم 17 عامًا أو أكثر.
  • إذا ضبطت ثلاث فئات عمرية مختلفة ضمن الحدّ الأدنى للعمر (11 و13 و15):
    • سيتم عرض ageLower = 0 وageUpper = 10 للمستخدمين الذين تتراوح أعمارهم بين 0 و10 أعوام.
    • سيتم عرض ageLower = 11 وageUpper = 12 للمستخدمين الذين تبلغ أعمارهم 11 أو 12 عامًا.
    • سيتم عرض ageLower = 13 وageUpper = 14 للمستخدمين الذين تبلغ أعمارهم 13 أو 14 عامًا.
    • سيتم عرض ageLower = 15 للمستخدمين الذين تبلغ أعمارهم 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 تعداد
  • موافَق عليه
  • في انتظار المراجعة
  • لا
  • null
 لا يتم عرض قيمة غير خالية إلا في نطاقات السلطة التي تنطبق فيها التغييرات المهمة.
  • موافَق عليه: تمت الموافقة على آخر تغيير مهم (وجميع التغييرات السابقة).
  • في انتظار المراجعة: لم يوافق أحد الوالدَين بعد على تغيير واحد أو أكثر من التغييرات المهمة المعلّقة.
  • لا: رفض أحد الوالدَين الموافقة على تغيير واحد أو أكثر من التغييرات المهمة.
  • null: يتم عرض هذه القيمة في الحالات التالية:
    • جميع الحسابات غير الخاضعة للإشراف
    • الحسابات الخاضعة للإشراف التي لم يتم تسجيل أي تغييرات مهمة فيها بعد
significantChangeApprovalDate التاريخ
  • تاريخ
  • 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").
السابق
طلب إشارات الفئات العمرية
التالي
اختبار مؤشرات الفئات العمرية