الإنجازات

يمكن أن تكون الإنجازات وسيلة رائعة لزيادة تفاعل المستخدمين مع لعبتك. يمكنك تنفيذ الإنجازات في لعبتك لتشجيع اللاعبين على تجربة ميزات قد لا يستخدمونها عادةً أو على تجربة أساليب لعب مختلفة تمامًا. ويمكن أن تكون الإنجازات أيضًا طريقة ممتعة للمستخدمين لمقارنة مستوى تقدّمهم مع بعضهم البعض والمشاركة في منافسة ودية.

للتعرّف على كيفية تنفيذ الإنجازات على منصتك، اطّلِع على عمليات التنفيذ من جهة العميل.

السمات

لفهم طريقة عمل الإنجازات، عليك التعرّف على بعض السمات المرتبطة بها.

ترتبط هذه العناصر الأساسية بكل إنجاز:

• المعرّف هو سلسلة فريدة تنشئها أداة Google Play Console. ستستخدم هذا المعرّف الفريد للإشارة إلى الإنجاز في برامج ألعابك.
• الاسم هو اسم قصير للإنجاز (مثلاً، "صانع الفطائر"). يمكن أن يصل طول القيمة إلى 100 حرف.
• الوصف هو وصف موجز لإنجازك. عادةً ما يوضّح هذا الحقل للاعب كيفية تحقيق الإنجاز (على سبيل المثال، "خبز فطيرة المارينغ بالليمون قبل غروب الشمس"). يمكن أن تصل القيمة إلى 500 حرف.
• الرمز هو رمز مربّع مرتبط بإنجازك. للحصول على أفضل الممارسات عند إنشاء رموز الإنجازات، راجِع قسم إرشادات الرموز.
• ترتيب القائمة هو الترتيب الذي تظهر به الإنجازات المقفلة عندما يعرض أحد اللاعبين الإنجازات المرتبطة بلعبتك. يمكنك ترتيبها بأي طريقة تريدها. تظهر الإنجازات التي تم فتحها في أعلى القائمة بالترتيب الذي تم تحقيقها به.

الولاية

يمكن أن تكون الإنجازات في إحدى الحالات الثلاث المختلفة التالية:

• يعني الإنجاز المخفي أنّ تفاصيل الإنجاز مخفية عن اللاعب. توفّر "خدمات ألعاب Play" وصفًا عامًا وعنصرًا نائبًا ورمزًا للإنجاز عندما يكون في حالة مخفية. ننصحك بإخفاء الإنجاز إذا كان يتضمّن تفاصيل مفسِدة لا تريد الكشف عنها في وقت مبكر جدًا (على سبيل المثال، "اكتشف أنّك كنت شبحًا طوال الوقت").
• يعني الإنجاز المكشوف أنّ اللاعب على علم بالإنجاز، ولكنّه لم يحقّقه بعد. تبدأ معظم الإنجازات في حالة الإفصاح.
• يعني الإنجاز المكتسب أنّ اللاعب قد حقّق الإنجاز بنجاح. يمكن فتح إنجاز بلا اتصال بالإنترنت. عندما تصبح اللعبة متاحة على الإنترنت، تتم مزامنتها مع "خدمات ألعاب Play" لتعديل حالة الإنجاز إلى "تم إحرازه".

إنجازات تدريجية

يمكن تصنيف الإنجازات على أنّها عادية أو تزايدية. بشكل عام، يتضمّن الإنجاز التدريجي إحراز اللاعب تقدّمًا تدريجيًا نحو الحصول على الإنجاز على مدار فترة زمنية أطول. عندما يحرز اللاعب تقدّمًا نحو تحقيق الإنجاز التدريجي، يمكنك إبلاغ "خدمات ألعاب Play" بمستوى تقدّمه الجزئي.

تتتبّع خدمة Google Play معلومات مستوى التقدّم، وتنبّه اللعبة عندما يستوفي اللاعب المعايير اللازمة لإحراز هذا الإنجاز، وتخبره بمستوى تقدّمه نحو تحقيق هذا الهدف.

تتراكم الإنجازات التدريجية على مستوى جميع جلسات اللعب، ولا يمكن إزالة مستوى التقدّم أو إعادة ضبطه من داخل اللعبة. على سبيل المثال، يُعدّ الإنجاز "الفوز في 50 لعبة" إنجازًا تدريجيًا. لن يكون هذا الإنجاز متاحًا، لأنّه ستتم إعادة ضبط مستوى تقدّم اللاعب عند خسارة إحدى المباريات. لن يكون الإنجاز "الحصول على 5,000 رقاقة بوكر" مؤهلاً أيضًا، لأنّ اللاعب يمكنه كسب رقائق وخسارتها أثناء اللعب. بالنسبة إلى الإنجازَين الأخيرَين، يعود إليك تتبُّع حالة "الفوز المتتالي" أو إجمالي عدد الرقائق التي حصل عليها اللاعب، وفتح الإنجازات العادية عندما يحقّقها اللاعب.

عند إنشاء إنجاز تراكمي، يجب تحديد إجمالي عدد الخطوات المطلوبة لفتحه (يجب أن يكون هذا العدد بين 2 و10,000). عندما يحرز المستخدم تقدّمًا نحو فتح الإنجاز، عليك إبلاغ "خدمات ألعاب Play" بعدد الخطوات الإضافية التي اتّخذها المستخدم. وبمجرد أن يصل إجمالي عدد الخطوات إلى قيمة فتح الإنجاز، يتم فتح الإنجاز (حتى إذا كان مخفيًا). ليس عليك تخزين مستوى تقدّم المستخدم التراكمي.

النقاط

تتضمّن الإنجازات قيمة نقاط مرتبطة بها. يجب أن تكون نتيجة اللاعب من مضاعفات الرقم 5، ولا يمكن أن يتجاوز إجمالي النقاط في اللعبة 1000 نقطة لكل الإنجازات (مع أنّه يمكن أن يكون أقل). بالإضافة إلى ذلك، لا يمكن أن يحصل إنجاز واحد على أكثر من 200 نقطة.

تتبُّع مكافآت الخبرة (XP)

يمكن للاعبين الانتقال إلى مستويات أعلى في ملفهم التعريفي كلاعب عند تحقيق إنجازات في الألعاب المتوافقة مع "ألعاب Play". مقابل كل نقطة مرتبطة بأحد الإنجازات، يحصل اللاعب على 100 نقطة خبرة (XP) عند تحقيق هذا الإنجاز. بعبارة أخرى:

XP for an achievement = 100 * (point value for the achievement)

تتتبّع "خدمات ألعاب Play" نقاط الخبرة التي يكسبها كل لاعب وترسل إشعارًا إلى تطبيق "ألعاب Google Play" عندما يجمع اللاعب نقاطًا كافية "لرفع المستوى". يمكن للاعبين الاطّلاع على مستوى حساباتهم وسجلّ نقاط الخبرة من صفحة "الملف الشخصي" في تطبيق "ألعاب Google Play".

الحدّ الأدنى من الإنجازات

يجب أن تتضمّن اللعبة التي تدمج الإنجازات خمسة إنجازات على الأقل قبل نشرها. يمكنك إجراء الاختبار باستخدام أقل من خمس إنجازات، ولكن يُنصح بإنشاء خمس إنجازات على الأقل قبل نشر لعبتك.

الحدّ الأقصى للإنجازات

يخضع عدد الإنجازات لحدود النقاط وتوزيعها. وبما أنّ الحد الأقصى لعدد النقاط هو 1,000 نقطة، ويتم تخصيص 5 نقاط لكل إنجاز، فإنّ الحد الأقصى لعدد الإنجازات هو 200 إنجاز. ومع ذلك، إذا تم تخصيص المزيد من النقاط للإنجازات، سينخفض عدد الإنجازات المتاحة نتيجةً لذلك.

إضافة إنجازات

هناك طريقتان لإنشاء الإنجازات لأول مرة باستخدام Google Play Console:

• إنشاء إنجاز: أضِف التعريفات والبيانات الوصفية لكل إنجاز على حدة.
• استيراد الإنجازات: يمكنك استيراد التعريفات والبيانات الوصفية الأخرى لعدة إنجازات معًا في خطوة واحدة.

إنشاء إنجاز

لإنشاء إنجاز للعبة جديدة لم يتم نشرها، أكمِل الخطوات التالية:

1. اختَر لعبة في Google Play Console.
2. في صفحة الإنجازات ضمن خدمات ألعاب Google Play (النمو > خدمات ألعاب Google Play > الإعداد والإدارة > الإنجازات)، اختَر إنشاء إنجاز.
3. في صفحة إضافة إنجازات، املأ النموذج.
4. انقر على حفظ كمسوّدة.
5. بعد إنشاء إنجاز، يجب نشر لعبتك.

إضافة المزيد من الإنجازات

إذا كانت لديك إنجازات حالية وتريد إضافة غيرها:

1. اختَر لعبة في Google Play Console.
2. في صفحة الإنجازات ضمن خدمات ألعاب Google Play (النمو > خدمات ألعاب Google Play > الإعداد والإدارة > الإنجازات)، اختَر إضافة إنجازات.

استيراد الإنجازات

لإضافة عدة إنجازات إلى لعبتك في آنٍ واحد، اتّبِع الخطوات التالية:

1. أنشئ ملف ZIP يحتوي على الإنجازات.
2. حمّل الملف.

لمزيد من المعلومات عن ملف ZIP، يُرجى الاطّلاع على إرشادات ملف ZIP.

لاستيراد الإنجازات:

1. اختَر لعبة في Google Play Console.
2. في صفحة الإنجازات ضمن خدمات ألعاب Google Play (النمو > خدمات ألعاب Google Play > الإعداد والإدارة > الإنجازات)، اختَر استيراد الإنجازات.
3. في صفحة استيراد الإنجازات، انقر على تحميل.
4. اختَر ملف ZIP الذي تريد تحميله.
5. انقر على حفظ كمسوّدة.
6. بعد استيراد الإنجازات، يجب نشر لعبتك.

نشر اللعبة

بعد اختبار لعبتك ونشرها، يتم نشر جميع إنجازات اللعبة معها.

تعديل إنجاز

لتعديل إنجاز سبق لك إنشاؤه، اختَر الإنجاز في علامة التبويب الإنجازات في Google Play Console. وفي هذه المرحلة، سيظهر لك النموذج نفسه الذي استخدمته عند إنشاء الإنجاز لأول مرة، ما يتيح لك تعديل أيّ من الحقول حسب الحاجة.

عند الانتهاء من تعديل إنجاز، انقر على زر حفظ كمسوّدة. سيصبح الإنجاز الذي تم تعديله حديثًا في مرحلة "جاهز للاختبار"، وستتمكّن من اختباره. إذا كان يعمل بشكل صحيح، فاختَر إعادة النشر من القائمة المنسدلة. يؤدي ذلك إلى إعادة نشر اللعبة للجميع، بالإضافة إلى جميع الإنجازات المعدَّلة.

التراجع عن تعديل

إذا لم ينل إعجابك الإنجاز الحالي وأردت العودة إلى الإنجاز كما كان سابقًا، فاختَر إلغاء التغييرات الأخيرة من القائمة المنسدلة في Google Play Console، وستتم إعادة جميع إنجازاتك إلى الإصدار المنشور في السابق.

حذف إنجاز

يتعذّر حذف الإنجاز بعد نشره.

فلا يمكنك حذف إنجاز إلا في حالة النشر المُسبَق، وذلك بالنقر على زر حذف في أسفل نموذج هذا الإنجاز.

إعادة ضبط إنجاز

لا يمكنك إعادة ضبط بيانات مستوى تقدّم اللاعبين إلا في ما يتعلّق بالإنجازات التي تكون في وضع المسوّدة.

• لإعادة ضبط الإنجازات في Google Play Console، انقر على زر إعادة ضبط مستوى تقدّم الإنجازات في أسفل نموذج هذا الحدث.
• لإعادة ضبط بيانات الإنجازات آليًا، استخدِم طرق Management APIAchievements.

إرشادات الرموز

يجب إنشاء الرموز بتنسيق PNG أو JPEG أو JPG بحجم 512 × 512. ما عليك سوى تزويدنا برمز الإنجاز المتاح. وسننشئ تلقائيًا نسخة بالتدرّج الرمادي للرمز الذي تم إظهاره. لهذا السبب، ننصحك بتضمين عناصر ملونة في رموز الإنجازات حتى يتمكّن المستخدمون من التمييز بين الإنجازات الظاهرة والمفتوحة.

عند عرض رمز إنجاز في إشعار منبثق على Android، يتم وضع دائرة فوق الرمز ويتم إخفاء زواياه الخارجية. لذا، تأكَّد من أنّ الرمز لا يزال يبدو جيدًا في هذه الحالات.

يُستخدم الرمز نفسه مع جميع اللغات، لذا ننصحك بعدم تضمين أي نص أو محتوى بلغة معيّنة في الرمز.

إرشادات ملف ZIP

يمكنك استيراد إنجازات متعددة في آنٍ واحد باستخدام ملف ZIP. اطّلِع على الجدول لمعرفة أسماء الملفات المحددة التي يجب استخدامها في ملف ZIP:

متطلبات ملف ZIP:

• يجب ألا يتضمّن أي أدلة فرعية.
• يجب أن تكون أسماء الملفات فريدة.
• يجب أن تكون الملفات بتنسيقات CSV أو PNG أو JPEG أو JPG فقط.
• يجب ألا تحتوي ملفات CSV على صف للعنوان.
• يجب ألا يزيد حجم كل ملف عن 1 ميغابايت.
• يجب ألا يحتوي ملف ZIP على أكثر من 203 ملفات.
• يجب أن يكون إجمالي حجم ملف ZIP أقل من 200 ميغابايت.

تنسيق ملف AchievementsMetadata.csv

يحتوي ملف AchievementsMetadata.csv على البيانات الوصفية لكل إنجاز. يجب أن يتضمّن المعلومات في شكل قيم مفصولة بفواصل بالترتيب التالي:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

يتم وصف هذه الحقول في الجدول التالي:

متطلبات ملف AchievementsMetadata.csv:

• يجب أن يحتوي كل صف على سبع قيم. إذا أردت حذف قيمة، فاترك الحقل فارغًا.
• يتم استخدام الحقلَين Name وDescription كلغة تلقائية.
• يجب أن يكون حقل Name مميزًا في جميع الإنجازات.
• يجب ألّا يحتوي الحقلَين التاليَين على فواصل: Name وDescription.

نموذج لملف AchievementsMetadata.csv:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

تنسيق AchievementsLocalizations.csv

ملف AchievementsLocalizations.csv هو ملف اختياري يحتوي على جميع البيانات اللازمة لوصف كل إنجاز للمستخدمين بلغات مختلفة. تتم ترجمة الإنجازات بما يتوافق مع اللغات المحدّدة للعبة.

يجب أن يتضمّن المعلومات في شكل قيم مفصولة بفواصل بالترتيب التالي:

   Name, Localized name, Localized description, locale

يتم وصف هذه الحقول في الجدول التالي:

متطلبات ملف AchievementsLocalizations.csv:

• يجب أن تكون أسماء الإنجازات في اللعبة فريدة لكل لغة. على سبيل المثال، إذا كانت اللعبة تتيح استخدام اللغتَين en-US وfr-FR، يمكن أيضًا تسمية الإنجاز الذي يحمل الاسم "Achievement1" باللغة en-US باسم "Achievement1" باللغة fr-FR.
• يجب أن يحتوي كل صف على أربع قيم. إذا أردت حذف قيمة الوصف المترجَم، فاترك الحقل فارغًا.

نموذج لملف AchievementsLocalizations.csv:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

تنسيق ملف AchievementsIconMappings.csv

ملف AchievementsIconMappings.csv هو ملف اختياري يُستخدم لربط إنجازاتك بالرمز المحدّد. يجب أن يتضمّن المعلومات في شكل قيم مفصولة بفواصل بالترتيب التالي:

Name, icon filename

يتم وصف هذه الحقول في الجدول التالي:

متطلبات ملف AchievementsIconMappings.csv:

• يجب أن يحتوي كل صف على قيمتَين.
• يمكن أن تكون ملفات الرموز بتنسيق PNG أو JPEG فقط.

نموذجAchievementsIconMappings.csv ملف:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

ملفات الرموز

يجب أن تكون الرموز التي تشير إليها في ملف AchievementsIconMappings.csv متوفّرة في أرشيف ZIP الحالي الذي تستورده. لمزيد من المعلومات، يُرجى الاطّلاع على إرشادات الرموز.

إضافة ترجمات إلى الإنجازات

يمكنك تحديد ترجماتك الخاصة للإنجازات المرتبطة بلعبتك. قبل إجراء ذلك، احرِص أولاً على إكمال الخطوات الموضّحة في مقالة كيفية إضافة ترجمات إلى اللعبة.

تتوفّر طريقتان لإضافة ترجمات إلى لعبتك:

• يمكنك استخدام خيار استيراد الإنجازات لتحميل ترجمات للعديد من الإنجازات الجديدة في آنٍ واحد. ومع ذلك، لا يمكنك استخدام هذا الخيار لتحميل ترجمات الإنجازات الحالية.

• يمكنك إضافة ترجمات إلى كل إنجاز في لعبتك. لإضافة ترجمتك الخاصة لكل إنجاز، اتّبِع الخطوات التالية:

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

عمليات التنفيذ من جهة العميل

للتعرّف على كيفية تنفيذ الإنجازات على منصتك، اطّلِع على المراجع التالية:

• Android
• Unity
• الويب
• أفضل الممارسات لتنفيذ الإنجازات