دمج الإنجازات

إنشاء إنجاز

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

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

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

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

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

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

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

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

إرشادات ملف 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

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

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

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

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

ملفات الرموز

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

تعديل الإنجازات

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

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

   يؤدي ذلك إلى إعادة نشر اللعبة للجميع، بالإضافة إلى جميع الإنجازات المعدَّلة.

حذف إنجاز

يتعذّر حذف الإنجاز بعد نشره. لا يمكنك حذف إنجاز إلا في حالة النشر المُسبَق

1. في صفحة الإنجازات ضمن "خدمات ألعاب Play"، اختَر إنجازًا.
2. لحذف الإنجاز، انقر على حذف الإنجاز.

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

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

1. في صفحة الإنجازات ضمن "خدمات ألعاب Play"، اختَر إنجازًا.
2. لإعادة ضبط الإنجازات، انقر على إعادة ضبط مستوى التقدّم.
3. لإعادة ضبط بيانات الإنجازات آليًا، استخدِم طرق AchievementsManagement API.