پاداش‌های آزمایشی

آزمایشگاه «خدمات صورت‌حساب Play» برنامه‌ای همراه است که به شما کمک می‌کند یکپارچه‌سازی با سیستم صورت‌حساب Google Play را آزمایش کنید. می‌توانید از آزمایش پیش‌نمایش خرید خارج از برنامه (OOAP) در «آزمایشگاه خدمات صورت‌حساب Play» استفاده کنید تا مطمئن شوید که پسای شما به‌درستی پیکربندی شده است تا بتواند مواردی را که خارج از برنامه شما به‌دست آمده‌اند، ازجمله «پاداش‌های بازی‌های Play»، مدیریت کند.

با ویژگی پیش‌نمایشی OOAP، می‌توانید محصول یا پیشنهاد خاصی را برای نمایش در سطوح خارج از برنامه، مثل صفحه جزئیات برنامه در Google Play، انتخاب کنید و جریان دریافت و اجرای حق استفاده سرتاسری را درستی‌سنجی کنید.

پیش‌نیازها

قبل‌از استفاده از «آزمایشگاه خدمات صورت‌حساب Play» برای آزمایش جریان‌های خرید خارج از برنامه (OOAP) برای اعتبارسنجی راه‌اندازی‌تان برای «پاداش‌های بازی‌های Play»، مطمئن شوید که پیش‌نیازهای زیر را برآورده می‌کنید:

  1. در «برنامه دسترسی زودرس پاداش‌های بازی‌های Play» ثبت‌نام کنید.
  2. وضعیت آزمونگر پروانه‌دار: حساب آزمایشی شما باید به‌عنوان آزمونگر پروانه‌دار برای بازی ثبت شده باشد. برای جزئیات، به اسناد آزمایش‌کننده دارای پروانه Google Play مراجعه کنید.

    توجه: اگرچه هر کاربری می‌تواند برنامه «آزمایشگاه خدمات صورت‌حساب Play» را مشاهده کند، اما فقط آزمایش‌کنندگان دارای پروانه توسعه‌دهندگان «برنامه دسترسی زودرس» در فهرست مجاز می‌توانند جایگزینی‌های OOAP را پیکربندی و راه‌اندازی کنند.

  3. سازگاری حساب در سطوح مختلف: باید بااستفاده از همان حساب آزمونگر پروانه‌دار به سیستم «آزمایشگاه خدمات صورت‌حساب Play» و «فروشگاه Google Play» وارد شوید. اگر حساب‌ها مطابقت نداشته باشند، ممکن است «فروشگاه Play» محصول یا پیشنهاد آزمایشی لغوشده را نشان ندهد یا خرید آزمایشی را تکمیل نکند.

بارگیری و نصب

می‌توانید «آزمایشگاه خدمات صورت‌حساب Play» را از Google Play بارگیری و نصب کنید:

راهنمای گام‌به‌گام ادغام و آزمایش EAP

مراحل زیر نحوه ادغام و آزمایش «پاداش‌های بازی‌های Play» را بااستفاده از «آزمایشگاه خدمات صورت‌حساب Play» شرح می‌دهد.

مرحله ۱: «آزمایشگاه خدمات صورت‌حساب Play» را راه‌اندازی کنید و به سیستم وارد شوید

وقتی «آزمایشگاه خدمات صورت‌حساب Play» را برای اولین‌بار پس‌از نصب باز می‌کنید:

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

مرحله ۳: نام بسته برنامه و شناسه محصول را مشخص کنید

در صفحه راه‌اندازی OOAP، شناسه‌های برنامه موردنیاز را وارد کنید:

  1. نام بسته: نام دقیق بسته Android برنامه‌تان (برای مثال، com.example.app).
  2. نوع محصول: از منوِ کرکره‌ای برای انتخاب محصول یک‌باره (محصول درون‌برنامه) یا اشتراک استفاده کنید.
  3. شناسه محصول (SKU): شناسه محصول اشتراک یا محصول درون‌برنامه‌ای که می‌خواهید آزمایش کنید.
نام بسته برنامه و شناسه محصول را مشخص کنید
نام بسته برنامه و شناسه محصول را مشخص کنید.

مرحله ۴: انتخاب پیشنهاد واجدشرایط

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

  • برای محصولات یک‌باره: گزینه خرید یا پیشنهاد ویژه مربوطه را انتخاب کنید.

    انتخاب کردن پیشنهاد ویژه واجدشرایط
    پیشنهاد واجدشرایطی را انتخاب کنید.

مرحله ۵: شروع آزمایش OOAP

پس‌از انتخاب پیشنهاد، روی شروع آزمایش تک‌ضرب بزنید. پیکربندی ذخیره می‌شود و با سرورهای زیرینه Google Play همگام‌سازی می‌شود.

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

  • پنجره آزمایش: پیکربندی‌های آزمایش OOAP فعال به‌طور پیش‌فرض ۲ ساعت فعال می‌مانند و سپس به‌طور خودکار منقضی می‌شوند.
  • لغو باطن: وقتی فعال باشد، پیکربندی به‌عنوان بالاترین اولویت در سطوح مختلف OOAP (مثل صفحه جزئیات برنامه در «فروشگاه Play») نشان داده می‌شود.

    شروع آزمایش OOAP
    آزمایش OOAP را شروع کنید.

مرحله ۶: آزمایش جریان جذب سرتاسر برای پیشنهادهای خارج از برنامه

درحالی‌که آزمایش OOAP در «آزمایشگاه خدمات صورت‌حساب Play» فعال است، برنامه فروشگاه Google Play را باز کنید و با همان حساب آزمونگر پروانه‌دار به سیستم وارد شوید:

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

    • قیمت، ابزار پرداخت (ابزار آزمایشی برای آزمایش‌کنندگان دارای پروانه)، و جزئیات پیشنهاد را مرور کنید.
    • برای تکمیل تراکنش، روی خرید با یک ضربه تک‌ضرب بزنید.
    آزمایش کردن جریان جذب سرتاسر
    جریان جذب سرتاسر را آزمایش کنید.
  5. درستی‌سنجی یکپارچه‌سازی پس‌نگر:

    • پس‌از خرید موفق، بررسی کنید که Google Play «اعلان بی‌درنگ توسعه‌دهنده» (RTDN) به سرور زیرینه شما ارسال کند.
      • توجه: «پاداش‌ها» نیز RTDN ارسال می‌کند.
    • تأیید کنید که سرورتان Google Play Developer API را برای تأیید خرید و اعطای حق استفاده به کاربر فراخوانی می‌کند.
    • سابقه خرید کاربر را در برنامه «فروشگاه Play» بررسی کنید تا مطمئن شوید سفارش آزمایشی ثبت شده است.

مرحله ۷: توقف و پاک کردن آزمایش OOAP

پس‌از اتمام آزمایش:

  1. به صفحه خرید خارج از برنامه بروید.
  2. برای متوقف کردن آزمایش OOAP و پاک کردن تنظیمات آزمایش OOAP، روی پاک کردن آزمایش تک‌ضرب بزنید.
توقف و پاک کردن آزمایش OOAP
پاک کردن آزمایش OOAP.

درحال تغییر دادن پیکربندی‌های آزمایشی

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

برای انجام این کار باید آزمایش OOAP فعلی را متوقف و پاک کنید

نحوه ویرایش محصول یا پیشنهاد ویژه

اگر درحال‌حاضر آزمایش OOAP اجرا می‌کنید و می‌خواهید محصول یا پیشنهاد دیگری را آزمایش کنید:

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

نحوه آزمایش قیمت‌گذاری بومی‌سازی‌شده با لغو کشور

آزمایشگاه «خدمات صورت‌حساب Play» به شما امکان می‌دهد کشور «فروشگاه Google Play» خود را لغو کنید تا قیمت‌گذاری منطقه‌ای و قالب‌بندی واحد پول را آزمایش کنید. اما تغییرات کشور باید به‌طور کامل با آزمایش OOAP همگام‌سازی شود:

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

  2. تنظیم لغو کشور: پس‌از توقف آزمایش OOAP، می‌توانید تنظیمات کشور را در صفحه تنظیمات پیکربندی ویرایش کنید. کشور هدف (برای مثال، ژاپن، پادشاهی متحد) را انتخاب کنید و روی اعمال تک‌ضرب بزنید.

  3. راه‌اندازی مجدد آزمایش خرید خارج از برنامه: وقتی لغو کشور فعال شد، به کارت خرید خارج از برنامه برگردید، محصول و پیشنهاد ویژه‌تان را انتخاب کنید، و روی شروع آزمایش تک‌ضرب بزنید.

    داشبورد شما اکنون هم «لغو کشور» فعال و هم «آزمایش OOAP» فعال را نشان می‌دهد.

  4. درستی‌سنجی قیمت بومی‌سازی‌شده در «فروشگاه Play»: «فروشگاه Play» را باز کنید و به صفحه جزئیات برنامه‌تان بروید. کارت میانای کاربری ظاهرشده و برگه پایین Play Express اکنون قیمت محصول را با قالب‌بندی ارز محلی کشور لغوشده شما نمایش خواهند داد!

آزمایش قیمت‌گذاری بومی‌سازی‌شده با لغو کشور
قیمت‌گذاری بومی‌سازی‌شده را با لغو کشور آزمایش کنید.

عیب‌یابی و پرسشگان

چرا پیشنهاد آزمایشی پیکربندی‌شده من در صفحه جزئیات برنامه‌ام در «فروشگاه Play» نشان داده نمی‌شود؟

  • سازگاری حساب: بررسی کنید حسابی که به سیستم برنامه «فروشگاه Play» وارد شده است دقیقاً همان حسابی باشد که به سیستم «آزمایشگاه خدمات صورت‌حساب Play» وارد شده است.
  • فهرست مجاز EAP و وضعیت آزمایش‌کننده دارای پروانه: بررسی کنید که حساب توسعه‌دهنده شما در فهرست مجاز Play Billing Lab OOAP Preview EAP قرار داشته باشد و حسابتان به‌عنوان آزمایش‌کننده دارای پروانه فعال در «کنسول Play» فهرست شده باشد.
  • انقضا: آزمایش‌های فعال OOAP پس‌از ۲ ساعت منقضی می‌شوند. آزمایشگاه «خدمات صورت‌حساب Play» را باز کنید تا ببینید برچسب آزمایشی شما به منقضی‌شده تغییر کرده است یا نه. دراین‌صورت، آزمایش جدیدی را شروع کنید.

چرا هنگام راه‌اندازی محصول در «آزمایشگاه خدمات صورت‌حساب Play» نمی‌توانم هیچ پیشنهادی را انتخاب کنم یا ببینم؟

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

چرا خرید آزمایشی من در هم‌پوشانی Play Express ناموفق بود؟

  • مطمئن شوید که دستگاه آزمایشی شما Android 12 (سطح API‏ ۳۱) یا بالاتر را اجرا می‌کند و جدیدترین نسخه «فروشگاه Google Play» روی آن نصب شده است.
  • وب‌قلاب RTDN زیرینه برنامه و ادغام API را بررسی کنید. هنگام آزمایش ازطریق «فروشگاه Play»، خریدها خارج از واسط کاربر استاندارد برنامه شما انجام می‌شود. سرور زیرینه شما باید پیام‌های RTDN را به‌طور قابل‌اعتماد از Google Play دریافت کند و خریدها را به‌طور ناهمگام تأیید کند.

چگونه می‌توانم آزمایش فعال را قبل‌از منقضی شدن زمان‌سنج ۲ ساعته متوقف یا پاک کنم؟

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