Reminder: By Aug 31, 2025, all new apps and updates to existing apps must use Billing Library version 7 or newer. If you need more time to update your app, you can request an extension until Nov 1, 2025. Learn about Play Billing Library version deprecation.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
تبلیغات، یا کدهای تبلیغاتی ، به شما امکان می‌دهند تا محصولات یا آزمایش‌های یک‌باره را به اشتراک‌ها به صورت رایگان در اختیار تعداد محدودی از کاربران قرار دهید. کاربر یک کد تبلیغاتی را در برنامه شما یا در برنامه فروشگاه Google Play وارد می‌کند و مورد یا نسخه آزمایشی اشتراک را بدون هزینه دریافت می‌کند.
در کنسول Play، می‌توانید انواع کدهای تبلیغاتی زیر را ایجاد کنید:
کدهای یکبار مصرف : اینها کدهای منحصر به فرد تولید شده به صورت خودکار هستند که کاربران فقط یک بار می توانند از آنها استفاده کنند. کاربران این کدها را مستقیماً از فروشگاه Play یا از داخل برنامه شما بازخرید می کنند.
کدهای سفارشی : می توانید کدهای سفارشی را مشخص کنید که می توانند چندین بار تا سقف از پیش تعریف شده شما بازخرید شوند. کدهای سفارشی فقط برای اشتراک ها در دسترس هستند و فقط برای کاربرانی که قبلا مشترک نشده اند می توانند از آنها استفاده کنند.
می‌توانید از کدهای تبلیغاتی به روش‌های مختلفی برای تعامل خلاقانه با کاربران استفاده کنید، از جمله موارد زیر:
ممکن است در یک رویداد کارت هایی با کدهای تبلیغاتی توزیع کنید و کاربران کدهای تبلیغاتی خود را وارد کنند تا قفل یک آیتم ویژه درون بازی را باز کنند.
ممکن است کدهایی را به کارمندان بدهید تا بتوانند آنها را با دوستان و خانواده خود به اشتراک بگذارند.
ممکن است برای افرادی که برنامه شما را در مدت زمان معینی خریداری می کنند یک کد تبلیغاتی ارسال کنید.
برای اشتراک به موارد زیر توجه کنید:
کدهای تبلیغاتی نسخه آزمایشی رایگان را برای اشتراک‌ها ارائه می‌کنند نه اشتراک رایگان.
تبلیغات دیگر دوره های آزمایشی رایگان را تمدید نمی کند. اگر یک اشتراک با یک دوره آزمایشی رایگان و بدون نیاز به کد تبلیغاتی شروع شود، یک تبلیغ بر طول دوره آزمایشی رایگان اصلی لغو می شود.
کاربرانی که در غیر این صورت واجد شرایط استفاده آزمایشی رایگان نیستند - برای مثال، کاربرانی که در گذشته اشتراکی خریداری کرده بودند اما دیگر مشترک نیستند - هنوز واجد شرایط استفاده آزمایشی رایگان از طریق تبلیغات هستند.
شما می توانید تنها یک کد تبلیغاتی برای هر محصول اشتراک ایجاد کنید. یعنی می توانید یک کد تبلیغاتی فقط برای یک طرح یا پیشنهاد پایه ایجاد کنید.
کاربران می‌توانند کدهای تبلیغاتی را در فروشگاه Google Play تا تاریخ پایان تبلیغاتی که در کنسول Play مشخص کرده‌اید بازخرید کنند. تبلیغات می تواند تا یک سال ادامه داشته باشد.
قبل از اجرای تبلیغات، حتما موارد زیر را در نظر بگیرید:
برای محصولات یکبار مصرف، می‌توانید حداکثر 500 کد تبلیغاتی در هر سه ماهه در همه محصولات مدیریت‌شده در یک برنامه ایجاد کنید. می توانید از ترکیب های مختلفی از کدهای تبلیغاتی استفاده کنید که شامل یک یا چند محصول یک بار مصرف می شود. به عنوان مثال می توان به موارد زیر اشاره کرد:
500 کد تبلیغاتی برای یک محصول یکبار مصرف.
100 کد تبلیغاتی، هر کدام برای پنج محصول مختلف یک بار مصرف.
برای تبلیغات اشتراک، می‌توانید تا 10000 کد یکبار مصرف در هر سه ماهه برای هر محصول اشتراک ایجاد کنید. این محدودیت در محدودیت کدهای تبلیغاتی برای محصولات یکبار مصرف حساب نمی شود.
هنگام ایجاد یک تبلیغ اشتراک با کدهای سفارشی، می توانید محدودیت بازخرید را بین 2000 تا 99999 انتخاب کنید.
ایجاد و مدیریت تبلیغات
برای آشنایی با نحوه تنظیم و مدیریت تبلیغات، به ایجاد تبلیغات مراجعه کنید.
جریان بازخرید کاربر
هنگامی که کاربر یک کد تبلیغاتی دارد، می تواند آن را به یکی از روش های زیر بازخرید کند:
در برنامه شما: کاربر می تواند با کلیک بر روی فلش رو به پایین در کنار فرم پرداخت در صفحه خرید Google Play و سپس کلیک کردن روی پیوند بازخرید برای تایپ کد، خرید را آغاز کند.
در فروشگاه Play: کاربر می‌تواند با کلیک بر روی منوی پیمایش سمت چپ Play Store و ضربه زدن روی Redeem Code ، کد را در فروشگاه Google Play وارد کند.
کاربر همچنین می‌تواند با دنبال کردن یک پیوند عمیق به فروشگاه Google Play، وارد کردن کد دستی را رد کند.
به عنوان مثال، شکل 1 صفحه خرید اشتراک را نشان می دهد. برای وارد کردن یک کد تبلیغاتی، روی پیکان کنار روش پرداخت فعلی ضربه بزنید تا صفحه روش‌های پرداخت نمایش داده شود، همانطور که در شکل 2 نشان داده شده است. سپس روی بازخرید کد ضربه بزنید تا به صفحه بازخرید کارت هدیه یا کد تبلیغاتی بروید، همانطور که در شکل نشان داده شده است. 3. سپس می‌توانید کد تبلیغاتی خود را در این صفحه وارد کنید و روی Redeem ضربه بزنید تا تمام شود.
شکل 1. گفتگوی خرید اشتراک. شکل 2. صفحه ای که روش های پرداخت را برای خرید درون برنامه ای فهرست می کند. شکل 3. صفحه کد تبلیغاتی.
برای کدهای تبلیغاتی اشتراک، به موارد زیر توجه کنید:
کدهای سفارشی را می توان فقط از داخل برنامه شما بازخرید کرد، در حالی که کدهای یکبار مصرف را می توان هم از طریق برنامه شما و هم از فروشگاه Play استفاده کرد.
پس از اینکه کاربر کد را بازخرید کرد، همچنان باید اشتراک را با کد اعمال شده خریداری کند. یک روش پرداخت معتبر برای اشتراک مورد نیاز است و اشتراک در پایان دوره آزمایشی رایگان کد تبلیغاتی به طور خودکار تمدید می شود.
در صورت استفاده از Billing Library نسخه 2.0 یا بالاتر، از کاربری که یک کد یکبار مصرف را از فروشگاه Play استفاده می‌کند، فوراً درخواست می‌شود که اشتراک را از طریق فروشگاه Play خریداری کند. این یک خرید خارج از برنامه است، بنابراین مطمئن شوید که برنامه شما می تواند این خریدها را به خوبی انجام دهد .
اگر برنامه شما هنوز از Billing Library 2.0 پشتیبانی نمی کند، کاربر باید برنامه شما را دانلود کند، به اشتراک صحیح بروید و سپس اشتراک را از داخل برنامه خود خریداری کند تا از کد تبلیغاتی استفاده کند.
همچنین می‌توانید با ایجاد یک URL که کاربر را به فروشگاه Google Play می‌فرستد و فیلد Enter کد را به‌طور خودکار پر می‌کند، یک کد تبلیغاتی را به اشتراک بگذارید. از قالب زیر برای URL کد تبلیغاتی استفاده کنید:
https://play.google.com/redeem?code=promo_code
شکل 4 گفتگوی Redeem Code برنامه Google Play را نشان می دهد:
شکل 4. گفتگوی Redeem Code برنامه Google Play.
پس از اینکه کاربر Redeem را فشار داد، اگر آخرین نسخه برنامه شما نصب شده باشد، فروشگاه Google Play از کاربر می خواهد که برنامه را باز کند. در غیر این صورت، فروشگاه Google Play از کاربر می‌خواهد برنامه شما را به‌روزرسانی یا دانلود کند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Promo codes\n\nPromotions, or *promo codes*, enable you to give one-time products or trials\nto subscriptions free-of-charge to a limited number of users. The user enters\na promo code, either in your app or in the Google Play Store app, and receives\nthe item or subscription trial at no cost.\n\nWithin the Play Console, you can create the following types of promo codes:\n\n- **One-time use codes**: These are automatically-generated unique codes that users can redeem only once. Users redeem these codes either directly from the Play Store or from within your app.\n- **Custom codes**: You can specify custom codes that can be redeemed multiple times up to your predefined limit. Custom codes are available only for subscriptions and can be redeemed only by users who have not previously subscribed.\n\nYou can use promo codes in many ways to creatively engage with users,\nincluding the following:\n\n- You might distribute cards with promo codes at an event, and users would enter their promo codes to unlock a special in-game item.\n- You might give codes to employees so they can share them with their friends and family.\n- You might send a promo code to people who buy your app during a certain period of time.\n\nFor subscriptions, note the following:\n\n- Promo codes offer free trials to subscriptions and not free subscriptions.\n- Promotions do not extend other free trials. If a subscription begins with a free trial without requiring a promo code, a promotion would override the original free trial length.\n- Users who would otherwise not be eligible for free trials---for example, users who had purchased a subscription in the past but are no longer subscribed---are still eligible for a free trial through a promotion.\n- You can create only one promo code per subscription product. That is, you can create a promo code only for a single base plan or offer.\n\nUsers can redeem promo codes in the Google Play Store up until a promotion\nend date that you specify in the Play Console. Promotions can last up to\none year.\n\nBefore implementing a promotion, be sure to consider the following:\n\n- For one-time products, you can create up to **500 promo codes per quarter** across all managed products in an app. You can use different combinations of promo codes that include one or more one-time products. Examples include the following:\n - 500 promo codes for a single one-time product.\n - 100 promo codes, each for five different one-time products.\n- For subscription promotions, you can create up to **10,000 *one-time use codes* per quarter per subscription product**. This limit does not count toward the limit of promo codes for one-time products.\n- When creating a subscription promotion with custom codes, you can choose a redemption limit between 2,000 and 99,999.\n\n| **Note:** Once you create a promotion, you can't change the number of promo codes in that promotion, and you can't switch those promo codes to a different type.\n| **Note:** If you don't use all of your promo codes in a quarter, you lose access to them. Unused codes don't carry over to the next quarter.\n\nCreating and managing promotions\n--------------------------------\n\nTo learn how to set up and manage promotions, see\n[Create Promotions](https://support.google.com/googleplay/android-developer/answer/6321495).\n\nUser redemption flow\n--------------------\n\nOnce a user has a promo code, they can redeem it in one of the following ways:\n\n- **In your app:** The user can initiate the purchase by clicking the down arrow next to the form of payment in the Google Play purchase screen and then clicking the **Redeem** link to type in the code.\n- **In the Play store:** The user can manually enter the code in the Google Play Store by clicking the Play Store left navigation menu and tapping **Redeem Code** .\n - The user can also skip manual code entry by instead following a [deep link](#deep-link) to the Google Play Store.\n\nAs an example, figure 1 shows a purchase screen for a subscription. To enter\na promo code, tap the arrow next to the current payment method to show the\n**Payment methods** screen, as shown in figure 2. Next, tap **Redeem code**\nto go to the **Redeem a gift card or promo code** screen, as shown in figure 3.\nYou can then enter your promo code on this screen and tap *Redeem* to finish.\n**Figure 1.** A subscription purchase dialog. **Figure 2.** Screen that lists payment methods for an in-app purchase. **Figure 3.** Promo code screen.\n\nFor subscription promo codes, note the following:\n\n- Custom codes can be redeemed only from within your app, while one-time codes can be redeemed through both your app and the Play store.\n- After the user redeems the code, they still need to purchase the subscription with the code applied. A valid form of payment is required for the subscription, and the subscription will auto-renew at the end of the promo code free trial period.\n- If using Billing Library version 2.0 or higher, a user who redeems a one-time code from the Play store is immediately asked to purchase the subscription through the Play store. This is an out-of-app purchase, so be sure that your app can [handle these purchases gracefully](/google/play/billing/integrate#ooap).\n - If your app does not yet support Billing Library 2.0, the user must download your app, navigate to the correct subscription, and then purchase the subscription from within your app to use the promotion code.\n\nImplementing promo codes\n------------------------\n\nTo ensure your app is ready to handle promo codes, your app needs to\nproperly handle redemptions that occur outside of your app. To learn more,\nsee [Processing purchases](/google/play/billing/integrate#process),\n[Fetching purchases](/google/play/billing/integrate#fetch), and\n[Handling purchases made outside of your app](/google/play/billing/integrate#ooap)\nin [Integrate the Google Play Billing Library into your app](/google/play/billing/integrate).\n\nDeep link\n---------\n\nYou can also share a promo code by generating a URL that sends the user to\nthe Google Play Store and auto-populates the **Enter code** field. Use the\nfollowing format for a promo code URL: \n\n https://play.google.com/redeem?code=promo_code\n\nFigure 4 shows the Google Play app's **Redeem Code** dialog:\n**Figure 4.** Google Play app's **Redeem Code** dialog.\n\nAfter the user presses **Redeem**, if the latest version of your app is\ninstalled, the Google Play Store prompts the user to open the app. Otherwise,\nthe Google Play Store prompts the user to update or download your app.\n\nTesting promo codes\n-------------------\n\nTo test your promo code implementation, see\n[Test promo codes](/google/play/billing/test#promo)."]]
