ادغام کردن جوایز

این سند توضیح می‌دهد که چگونه بااستفاده از «کنسول Google Play» یا فراخوانی‌های API، موفقیت‌ها را در بازی خود ادغام کنید. این بخش عناصر و حالت‌های ضروری موفقیت‌ها را پوشش می‌دهد و نحوه ایجاد، وارد کردن، و مدیریت آن‌ها را شرح می‌دهد.

قبل‌از شروع

ایجاد یا وارد کردن جایزه‌های جدید

برای پیاده‌سازی موفقیت‌ها از ابتدا، این مراحل را دنبال کنید:

افزودن جوایز

دو روش برای ایجاد اولین موفقیت‌ها بااستفاده از «کنسول Google Play» وجود دارد:

  • ایجاد موفقیت: تعاریف و فراداده‌ها را برای هر موفقیت به‌صورت جداگانه اضافه کنید.
  • وارد کردن جوایز: تعاریف و فراداده‌های دیگر را برای چندین جایزه به‌طور هم‌زمان در یک مرحله وارد کنید.

ایجاد جایزه

برای ایجاد جایزه برای بازی جدید و منتشرنشده، این مراحل را تکمیل کنید:

  1. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  2. در صفحه سرویس‌های بازی‌های Play - جایزه‌ها (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > جایزه‌ها)، ایجاد جایزه را انتخاب کنید.
  3. در صفحه افزودن موفقیت‌ها، فرم را تکمیل کنید.
  4. روی ذخیره به‌عنوان پیش‌نویس کلیک کنید.
  5. پس‌از ایجاد جایزه، باید جایزه‌هایتان را منتشر کنید.
وارد کردن جوایز

برای افزودن هم‌زمان چند جایزه به بازی‌تان، از مراحل زیر استفاده کنید:

  1. یک فایل zip حاوی جایزه‌هایتان ایجاد کنید.
  2. فایل را بارگذاری کنید.

برای اطلاعات بیشتر درباره فایل zip، به رهنمودهای فایل Zip مراجعه کنید.

برای وارد کردن جایزه‌ها:

  1. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  2. در صفحه سرویس‌های بازی‌های Play - جایزه‌ها (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > جایزه‌ها)، وارد کردن جایزه‌ها را انتخاب کنید.
  3. در صفحه وارد کردن جوایز، روی بارگذاری کلیک کنید.
  4. فایل zip را برای بارگذاری انتخاب کنید.
  5. روی ذخیره به‌عنوان پیش‌نویس کلیک کنید.
  6. پس‌از وارد کردن جایزه‌های کسب‌شده، باید بازی‌تان را منتشر کنید.

دستورالعمل‌های فایل ZIP

می‌توانید چندین جایزه را به‌طور هم‌زمان بااستفاده از فایل zip وارد کنید. برای نام دقیق فایل‌هایی که باید در فایل zip استفاده کنید، به جدول مراجعه کنید:

نام فایل الزامی یا اختیاری مقادیر قابل قبول
AchievementsMetadata.csv الزامی فراداده برای هر جایزه. مشخصه‌ها را ببینید.
AchievementsLocalizations.csv اختیاری ترجمه‌هایی برای نام جوایز و توضیحات ارائه می‌دهد.
AchievementsIconsMappings.csv اختیاری دستاوردها را به فایل‌های نماد آن‌ها نگاشت می‌کند.
فایل‌های نماد اختیاری نمادها در قالب PNG،‏ JPEG، یا JPG.

الزامات فایل ZIP:

  • بدون زیرفهرست راهنما.
  • نام‌های فایل یکتا.
  • فقط فایل‌های CSV،‏ PNG،‏ JPEG، یا JPG.
  • فایل‌های CSV نباید ردیف سرصفحه داشته باشند.
  • اندازه هر فایل باید کمتر از ۱ مگابایت باشد.
  • فایل zip نباید حاوی بیش‌از ۴۰۳ فایل باشد.
  • اندازه کل فایل zip باید کمتر از ۸۰۰ مگابایت باشد.
قالب AchievementsMetadata.csv

فایل AchievementsMetadata.csv حاوی فراداده برای هر موفقیت است. این فایل باید حاوی اطلاعات به‌صورت مقادیر جداشده با کاما به ترتیب زیر باشد:

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

این فیلدها در جدول زیر شرح داده شده‌اند:

سرستون‌های CSV الزامی یا اختیاری مقادیر قابل قبول
نام الزامی حداکثر ۱۰۰ نویسه داشته باشد
شرح اختیاری حداکثر ۵۰۰ نویسه
مقدار افزایشی الزامی True یا False
مراحل لازم اگر Incremental Value True. باشد، الزامی است عدد (بدون کسر یا اعشار). حداکثر مقدار ۱۰۰۰۰ است.
وضعیت اولیه الزامی Hidden یا Revealed
امتیاز الزامی عددی که مضرب ۵ باشد و مقدار آن باید بین ۵ تا ۲۰۰ باشد
ترتیب فهرست اختیاری عدد (بدون کسر یا اعشار، و بزرگ‌تر از صفر)

الزامات فایل 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

این فیلدها در جدول زیر شرح داده شده‌اند:

سرستون‌های CSV الزامی یا اختیاری شرح مقادیر قابل قبول
نام الزامی باید با ستون Name از AchievementsMetadata.csv مطابقت داشته باشد. حداکثر ۱۰۰ نویسه داشته باشد
نام بومی‌سازی‌شده الزامی نام بومی‌سازی‌شده برای جایزه. حداکثر ۱۰۰ نویسه داشته باشد
شرح بومی‌سازی‌شده اختیاری شرح بومی‌سازی‌شده برای جایزه در منطقه زبانی مشخص‌شده. حداکثر ۵۰۰ نویسه
منطقه زبانی الزامی کد منطقه زبانی، مثلاً en-US. ترجمه‌های بازی‌تان را قبل‌از مشخص کردن منطقه زبانی اضافه کنید. توجه داشته باشید که نمی‌توانید منطقه زبانی پیش‌فرض را مشخص کنید.

کدهای منطقه زبانی پشتیبانی‌شده را می‌توانید در فهرست زبان‌های پشتیبانی‌شده پیدا کنید.

الزامات فایل 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
قالب AchievementsIconsMappings.csv

فایل AchievementsIconsMappings.csv فایلی اختیاری است که برای نگاشت کردن موفقیت‌هایتان با نماد ارائه‌شده استفاده می‌شود. این فایل باید حاوی اطلاعات به‌صورت مقادیر جداشده با کاما و به‌ترتیب زیر باشد:

Name, icon filename

این فیلدها در جدول زیر شرح داده شده‌اند

سرستون‌های CSV الزامی یا اختیاری شرح
نام الزامی باید با ستون Name از AchievementsMetadata.csv مطابقت داشته باشد.
نام فایل نماد الزامی نام فایل نماد شما.

الزامات فایل AchievementsIconsMappings.csv:

  • هر ردیف باید دو مقدار داشته باشد.
  • فایل‌های نماد فقط می‌توانند در قالب PNG یا JPEG باشند.

نمونه فایل AchievementsIconsMappings.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 با ابعاد ۵۱۲ × ۵۱۲ ایجاد شوند. فقط باید نماد مربوط به جایزه بازشده را به ما ارائه دهید. ما به‌طور خودکار یک نسخه خاکستری برای نماد آشکارشده تولید خواهیم کرد. به همین دلیل، توصیه می‌کنیم نمادهای موفقیت شما شامل عناصر رنگارنگ باشد تا کاربران بتوانند موفقیت‌های آشکارشده و بازشده را از هم تشخیص دهند.

وقتی نماد جایزه در [اعلان موقت][a] Android نمایش داده می‌شود، نماد با دایره‌ای پوشانده می‌شود و گوشه‌های بیرونی آن پنهان می‌شود. مطمئن شوید که نمادتان در این شرایط همچنان خوب به‌نظر می‌رسد.

نماد جایزه نمونه.
نمونه نماد جایزه.

از یک نماد در همه منطقه‌ها استفاده می‌شود، بنابراین توصیه می‌کنیم هیچ نوشتار یا محتوای بومی‌سازی‌شده‌ای را در نماد قرار ندهید.

فایل‌های نماد

نمادهایی که در فایل AchievementsIconsMappings.csv به آن‌ها ارجاع می‌دهید باید در بایگانی zip فعلی که وارد می‌کنید وجود داشته باشند.

به‌روزرسانی بازی‌ها با موفقیت‌های موجود

می‌توانید در «کنسول Google Play» موفقیت‌های بیشتری به بازی اضافه کنید و موفقیت‌های موجود را به‌روز کنید.

افزودن جایزه‌های بیشتر

اگر ازقبل موفقیت‌هایی دارید و می‌خواهید موفقیت‌های بیشتری اضافه کنید:

  1. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  2. در صفحه سرویس‌های بازی‌های Play - جایزه‌ها (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > جایزه‌ها)، افزودن جایزه را انتخاب کنید.
ویرایش کردن جایزه‌ها

اگر ازقبل موفقیت‌هایی دارید و می‌خواهید آن‌ها را ویرایش کنید:

  1. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  2. در صفحه سرویس‌های بازی‌های Play - جایزه‌ها (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > جایزه‌ها)، جایزه‌ای را انتخاب کنید.
  3. می‌توانید هرکدام از فیلدها را ویرایش کنید.
  4. روی ذخیره به‌عنوان پیش‌نویس کلیک کنید.
  5. در صفحه سرویس‌های بازی‌های Play - جایزه‌ها، جایزه ویرایش‌شده در وضعیت «دردسترس برای آزمایش‌کنندگان» قرار دارد.
  6. پس‌از آزمایش کردن موفقیت، روی مرور و انتشار کلیک کنید.

    با این کار، بازی شما به‌همراه همه جایزه‌های به‌روزشده‌تان دوباره منتشر می‌شود.

حذف کردن جایزه

وقتی موفقیت شما منتشر شد، نمی‌توان آن را حذف کرد. فقط می‌توانید موفقیت را در حالت پیش‌از انتشار حذف کنید

  1. در صفحه سرویس‌های بازی‌های Play - جایزه‌ها، جایزه‌ای را انتخاب کنید.
  2. برای حذف موفقیت، روی حذف موفقیت کلیک کنید.
بازنشانی موفقیت

فقط می‌توانید داده‌های پیشرفت بازیکن را برای جوایز پیش‌نویس بازنشانی کنید.

  1. در صفحه سرویس‌های بازی‌های Play - جایزه‌ها، جایزه‌ای را انتخاب کنید.
  2. برای بازنشانی کردن موفقیت‌ها، روی بازنشانی پیشرفت کلیک کنید.
  3. برای بازنشانی داده‌های جایزه به‌صورت برنامه‌ریزی‌شده، روش‌های Management API Achievements را فراخوانی کنید.

افزودن ترجمه برای جوایز

می‌توانید ترجمه‌های خودتان را برای جایزه‌هایی که با بازی‌تان مرتبط هستند مشخص کنید. قبل‌از انجام این کار، ابتدا مطمئن شوید که مراحل شرح‌داده‌شده در افزودن ترجمه برای بازی را تکمیل کرده‌اید.

دو روش برای افزودن ترجمه برای بازی‌تان وجود دارد:

  • می‌توانید از گزینه وارد کردن موفقیت‌ها برای بارگذاری ترجمه چندین موفقیت جدید به‌طور هم‌زمان استفاده کنید. نمی‌توانید از این گزینه برای بارگذاری ترجمه برای موفقیت‌های موجود استفاده کنید.

  • می‌توانید برای هر موفقیت در بازی‌تان ترجمه اضافه کنید. برای افزودن ترجمه خودتان برای هر جایزه:

    1. در «کنسول Google Play»، برگه موفقیت‌ها را برای بازی‌تان باز کنید، سپس یکی از موفقیت‌های موجود را انتخاب کنید.
    2. در صفحه جزئیات جایزه‌ها، برگه مربوط به زبانی را که قبلاً در برگه جزئیات بازی اضافه کرده‌اید انتخاب کنید.
    3. در صفحه جزئیات جایزه برای آن زبان، فرم را با ترجمه‌هایتان برای آن جایزه ویرایش کنید.
    4. روی ذخیره کلیک کنید تا جزئیات ترجمه‌شده موفقیت ذخیره شود.

پیاده‌سازی‌های کارخواه

برای آشنایی با نحوه پیاده‌سازی جایزه‌ها برای پلاتفرمتان، منابع زیر را ببینید:

درحال آزمایش جوایز

برای تأیید اینکه موفقیت‌ها طبق انتظار کار می‌کنند، مراحل آزمایش آن‌ها را دنبال کنید:

  • دسته هدف آزمایشی داخلی راه‌اندازی کنید.
  • حساب‌های آزمایشی را برای آزمایش‌کنندگان به پروژه بازی‌تان اضافه کنید.
  • بااستفاده از برنامه «بازی‌های Play»، نمایه «سرویس‌های بازی‌های Play» را برای یکی از حساب‌های آزمایشی ایجاد کنید.
  • بازی را بااستفاده از همان حساب آزمایشی که برای آن نمایه «سرویس‌های بازی‌های Play» ایجاد کرده‌اید باز کنید.
  • تأیید کنید که «پیام خوشامدگویی» سرویس‌های بازی‌های Play به‌عنوان تأیید اصالت‌سنجی خودکار موفقیت‌آمیز در راه‌اندازی بازی روی صفحه نشان داده می‌شود.
  • بازی کنید و مراحل لازم را برای باز کردن قفل جایزه‌ها تکمیل کنید.
  • برای درستی‌سنجی کردن موفقیت‌ها:

    • بررسی کنید که وقتی جایزه تکمیل می‌شود، بالاپر «جایزه قفل‌گشایی شد» روی صفحه‌نمایش نشان داده شود.

    • برنامه فروشگاه Play را باز کنید و درستی‌سنجی کنید که بخش جایزه‌ها در YouTab جایزه‌های تکمیل‌شده و همچنین جایزه‌های درحال انجام (با جزئیات پیشرفت) را نشان می‌دهد.

پیگیری عملکرد جایزه در «کنسول Play»

در اینجا نحوه پیدا کردن آمار سریع برای موفقیت‌های فردی آورده شده است:

  • در کنسول Google Play.
  • به تنظیمات> پروژه‌های بازی بروید.
  • بازی انتخاب کنید؛
  • در منو سمت راست، روی موفقیت‌ها کلیک کنید.
  • در صفحه جایزه‌ها، می‌توانید آمار را ببینید تا متوجه شوید که آیا بازیکنان شما قفل جایزه‌ها را باز می‌کنند یا نه.

همچنین می‌توانید عملکرد سری زمانی جایزه‌ها را در صفحه رشد دادن تعداد کاربران > خدمات بازی‌های Play > آمار بازی پیگیری کنید.

انتشار جایزه‌ها

پس‌از تکمیل آزمایش، باید بازی‌تان را منتشر کنید. همه جایزه‌های بازی‌تان با آن منتشر می‌شود. انتشار موفقیت‌ها مرحله‌ای الزامی برای عملکرد صحیح موفقیت‌ها است.

برای انتشار، این مراحل را دنبال کنید:

  1. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  2. در صفحه سرویس‌های بازی‌های Play - موفقیت‌ها (افزایش کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > موفقیت‌ها)، روی بازبینی و انتشار کلیک کنید.
  3. در صفحه سرویس‌های بازی‌های Play - انتشار (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > انتشار)، اقدامات را مرور کنید و مشکلات را برطرف کنید.
  4. روی منتشر کردن کلیک کنید.

    همه جایزه‌های بازی‌تان منتشر شده است.

اشتباهات رایجی که باید از آن‌ها اجتناب کرد

این نکات اشتباهات رایجی را که باید هنگام پیاده‌سازی جایزه‌ها در بازی از آن‌ها اجتناب کنید برجسته می‌کند. آن‌ها بر اهمیت موارد زیر تأکید می‌کنند:

  • در «کنسول Play»، به رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > جایزه‌ها بروید.

    • قبل‌از انتشار، بررسی کنید که موفقیت‌های پیکربندی‌شده در «کنسول Play» در وضعیت «پیش‌نویس» نباشند.
    • مقادیر شناسه موفقیت را از «کنسول Play» به کد بازی اضافه نکنید. درعوض از پیاده‌سازی‌های کارخواه استفاده کنید.
  • مطمئن شوید که منطق باز کردن قفل را در کارخواه خود نیز پیاده‌سازی کرده‌اید.

    • بازیکنان نمی‌توانند مرحله راه‌اندازی را که در آن میانای برنامه‌سازی کاربردی باز کردن قفل فراخوانی می‌شود رد کنند. برای مثال، تکمیل آموزش یک موفقیت است، اما بازیکنان می‌توانند خود آموزش را رد کنند.