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

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

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

يتضمّن ردّ واجهة Play Age Signals API (الإصدار التجريبي) الحقول والقيم التالية. وتقع على عاتقك مسؤولية تقديم تجارب مناسبة للفئة العمرية باستخدام هذه الإشارات.

حقل الردّ النوع القيم الوصف
ageRangeSource Enum
  • 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 عدد صحيح
  • من 0 إلى 18
  • null
 الحدّ الأدنى الشامل للفئة العمرية للمستخدم ويمكنك دمجها مع ageUpper لتحديد النطاق.

تعرض القيمة null إذا كانت قيمة ageSignalsStatus هي NOT_SHARED أو VERIFICATION_REQUIRED.
ageUpper عدد صحيح
  • من 2 إلى 18
  • null
 الحدّ الأقصى الشامل للفئة العمرية للمستخدم

تعرض هذه السمة القيمة null لأعلى فئة عمرية (على سبيل المثال، 18 عامًا أو أكثر) أو إذا كانت قيمة ageSignalsStatus هي NOT_SHARED أو VERIFICATION_REQUIRED.
significantChangeStatus Enum
  • موافَق عليه
  • في انتظار المراجعة
  • لا
  • null
 لا يعرض هذا الحقل سوى قيمة غير فارغة في نطاقات السلطة التي تسري فيها تغييرات مهمة.
  • تمّت الموافقة: تمت الموافقة على آخر تغيير مهم (وجميع التغييرات السابقة).
  • PENDING: لم يوافق أحد الوالدَين بعد على تغيير واحد أو أكثر من التغييرات المهمة المعلّقة.
  • DECLINED: رفض الوالدان الموافقة على تغيير واحد أو أكثر من التغييرات المهمة.
  • null: يتم عرضها في الحالات التالية:
    • جميع الحسابات غير الخاضعة للإشراف
    • الحسابات الخاضعة للإشراف التي لم يتم تسجيل أي تغييرات مهمة فيها بعد
significantChangeApprovalDate التاريخ
  • DateStamp
  • null
 تاريخ سريان آخر تغيير مهم تمت الموافقة عليه تتم أيضًا الموافقة على جميع التغييرات التي لها تواريخ سريان قبل هذا التاريخ. تعرض null في حال عدم توفّر أي تغييرات.

يمكنك دمجها مع `significantChangeStatus` للحصول على حالة الموافقة على هذا التغيير المهم
installId سلسلة
  • حروف أبجدية رقمية
  • null
 معرّف يخصّصه Google Play لعمليات التثبيت التي يجريها المستخدمون تحت الإشراف، ويُستخدَم لإعلامك بإلغاء الموافقة على التطبيق. راجِع المستندات المتعلّقة بالموافقات على التطبيقات التي تم إبطالها.

مثال 1

بالنسبة إلى المستخدم البالغ الذي أثبت عمره باستخدام مستند تعريف رقمي، ستتلقّى ما يلي:

  • في منطقة خاضعة للوائح التنظيمية حيث يكون التحقّق من العمر إلزاميًا:

    • ‫"ageRangeSource" AgeRangeSource.TIER_D.
    • ‫ageLower هو رقم (مثلاً، 18).
    • ‫"ageUpper" null.
    • حقول الردود الأخرى هي null.

  • في كل الأماكن الأخرى:

    • ‫"ageRangeSource" AgeRangeSource.TIER_A.
    • ‫ageLower هو رقم (مثلاً، 18).
    • ‫"ageUpper" null.
    • حقول الردود الأخرى هي null.

مثال 2

بالنسبة إلى المستخدم البالغ الذي أثبت عمره باستخدام طرق تقدير العمر (مثل تقييم صورة السيلفي أو بطاقة الائتمان أو المعرّف الضريبي)، ستتلقّى ما يلي:

  • في منطقة خاضعة للوائح التنظيمية حيث يكون التحقّق من العمر إلزاميًا:

    • ‫"ageRangeSource" AgeRangeSource.TIER_C.
    • ‫ageLower هو رقم (مثلاً، 18).
    • ‫"ageUpper" null.
    • حقول الردود الأخرى هي null

  • في كل الأماكن الأخرى:

    • ‫"ageRangeSource" AgeRangeSource.TIER_A.
    • ‫ageLower هو رقم (مثلاً، 18).
    • ‫"ageUpper" null.
    • حقول الردود الأخرى هي null.

مثال 3

بالنسبة إلى المستخدم المقيم في منطقة لا يكون فيها التحقّق من العمر إلزاميًا ويشارك عمره مع التطبيقات، ستتلقّى ما يلي:

  • ‫"ageRangeSource" AgeRangeSource.TIER_A.
  • ‫ageLower هو رقم (مثلاً، 18).
  • ‫"ageUpper" null.
  • حقول الردود الأخرى هي null.

مثال 4

بالنسبة إلى مستخدم قاصر خاضع للإشراف يدير الوصي عمره ويشاركه مع التطبيقات، ستتلقّى ما يلي:

  • ‫"ageRangeSource" AgeRangeSource.TIER_B.
  • ‫ageLower هو رقم (مثلاً، 13).
  • ‫ageUpper هو رقم (على سبيل المثال، 15).
  • حقول الردود الأخرى هي null.

مثال 5

بالنسبة إلى المستخدم الذي لم يوافق (أو لم يوافق أحد والدَيه) على مشاركة العمر في منطقة لا يكون فيها التحقّق من العمر إلزاميًا، ستتلقّى ما يلي:

  • ‫"ageRangeSource" null.
  • ‫"ageLower" null.
  • ‫"ageUpper" null.
  • حقول الردود الأخرى هي null.

المثال 6

بالنسبة إلى المستخدم القاصر الخاضع للإشراف والذي يدير أحد الأوصياء عمره، مع تغيير كبير معتمَد وتتبُّع عمليات التثبيت النشطة، ستتلقّى ما يلي:

  • ‫"ageRangeSource" AgeRangeSource.TIER_B.
  • ‫ageLower هو رقم (مثلاً، 13).
  • ‫ageUpper هو رقم (على سبيل المثال، 15).
  • ‫"significantChangeStatus" SignificantChangeStatus.APPROVED.
  • ‫significantChangeApprovalDate هو تاريخ (على سبيل المثال، "‎2026-01-15").
  • ‫installId هو معرّف سلسلة (على سبيل المثال، "abc123xyz789").
السابق
طلب إشارات الفئات العمرية
التالي
اختبار مؤشرات الفئات العمرية