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 Console، يمكنك إنشاء الأنواع التالية من الرموز الترويجية:
رموز تُستخدم لمرة واحدة: هذه رموز فريدة يتم إنشاؤها تلقائيًا
يمكن للمستخدمين تحصيل القيمة مرة واحدة فقط. يسترد المستخدمون قيمة هذه الرموز مباشرة من
متجر Play أو من داخل تطبيقك.
الرموز المخصّصة: يمكنك تحديد رموز مخصّصة يمكن تحصيل قيمتها عدة مرات.
مرات وصولاً إلى الحد المحدد مسبقًا. تتوفر الرموز المخصصة فقط
الاشتراكات ولا يمكن تحصيل قيمتها إلا من قبل المستخدمين الذين لم يسبق لهم
تم الاشتراك.
يمكنك استخدام الرموز الترويجية بطرق عدّة للتفاعل مع المستخدمين بطريقة إبداعية.
بما في ذلك ما يلي:
يمكنك توزيع بطاقات تتضمن رموزًا ترويجية في حدث ما، ويستطيع المستخدمون
إدخال الرموز الترويجية للحصول على عنصر خاص داخل اللعبة
يمكنك إعطاء الرموز للموظفين ليتمكنوا من مشاركتها مع أصدقائهم.
والأسرة.
يمكنك إرسال رمز ترويجي إلى المستخدمين الذين يشترون تطبيقك خلال فترة زمنية محدّدة
فترة زمنية محددة.
بالنسبة إلى الاشتراكات، يُرجى ملاحظة ما يلي:
تتيح الرموز الترويجية فترات تجريبية مجانية للاشتراكات وليس للاشتراكات المجانية.
لا تتيح العروض الترويجية تمديد الفترات التجريبية المجانية الأخرى. إذا كان الاشتراك يبدأ
فترة تجريبية مجانية بدون الحاجة إلى رمز ترويجي، سيُلغي العرض الترويجي
المدة الأصلية للفترة التجريبية المجانية.
المستخدمون الذين لن يكونوا مؤهّلين للاستفادة من الفترات التجريبية المجانية، مثل: المستخدمون
الذين اشتروا اشتراكًا في السابق ولكنهم لم يعودوا
المشتركين — لا يزالون مؤهلين للحصول على فترة تجريبية مجانية من خلال عرض ترويجي.
يمكنك إنشاء رمز ترويجي واحد فقط لكل منتج متوفّر عند الاشتراك. أي أنك
يمكنك إنشاء رمز ترويجي لخطة أساسية أو عرض واحد فقط.
يمكن للمستخدمين تحصيل قيمة الرموز الترويجية في "متجر Google Play" إلى أن يتم إطلاق عرض ترويجي.
تاريخ الانتهاء الذي تحدّده في Play Console. يمكن أن تستمر العروض الترويجية حتى
عام واحد.
قبل تطبيق عرض ترويجي، يجب مراعاة ما يلي:
بالنسبة إلى المنتجات التي يتم تحصيل سعرها مرة واحدة، يمكنك إنشاء ما يصل إلى 500 رمز ترويجي كل ربع سنوي.
على مستوى جميع المنتجات المُدارة داخل التطبيق يمكنك استخدام مجموعات مختلفة من
رموز ترويجية تتضمن منتجًا واحدًا أو أكثر يتم تحصيل سعره مرة واحدة. ومن الأمثلة على ذلك:
ما يلي:
500 رمز ترويجي لمنتج يتم تحصيل سعره مرة واحدة.
100 رمز ترويجي، لكلّ منها خمسة منتجات مختلفة يتم تحصيل سعرها مرة واحدة.
بالنسبة إلى العروض الترويجية للاشتراك، يمكنك إنشاء ما يصل إلى
10,000 رمز للاستخدام لمرة واحدة كل ربع سنوي لكل منتَج متوفّر عند الاشتراك. هذا النمط
لا يتم احتسابه ضمن الحد الأقصى لعدد الرموز الترويجية للمنتجات التي يتم تحصيل سعرها مرة واحدة.
عند إنشاء عرض ترويجي للاشتراك باستخدام رموز مخصّصة، يمكنك اختيار
حد تحصيل القيمة بين 2,000 و99,999.
إنشاء العروض الترويجية وإدارتها
للتعرّف على كيفية إعداد العروض الترويجية وإدارتها، يمكنك الاطّلاع على
إنشاء عروض ترويجية
مسار تحصيل القيمة من المستخدم
بعد حصول المستخدم على رمز ترويجي، يمكنه تحصيل قيمته بإحدى الطرق التالية:
في تطبيقك: يمكن للمستخدم بدء عملية الشراء بالنقر على الزر
السهم بجانب طريقة الدفع في شاشة الشراء على Google Play
ثم النقر على رابط تحصيل القيمة لكتابة الرمز.
في متجر Play: يمكن للمستخدم إدخال الرمز يدويًا في
"متجر Play" من خلال النقر على قائمة التنقّل اليمنى في "متجر Play" والنقر على
حصِّل قيمة الرمز.
يمكن للمستخدم أيضًا تخطي الإدخال اليدوي للرمز عن طريق اتباع
رابط لصفحة في التطبيق إلى "متجر Google Play".
على سبيل المثال، يعرض الشكل 1 شاشة شراء لأحد الاشتراكات. للدخول
رمز ترويجي، انقر على السهم بجانب طريقة الدفع الحالية لعرض
طرق الدفع، كما هو موضح في الشكل 2. انقر بعد ذلك على تحصيل قيمة الرمز.
للانتقال إلى شاشة تحصيل قيمة بطاقة هدايا أو رمز ترويجي كما هو موضّح في الشكل 3.
يمكنك بعد ذلك إدخال الرمز الترويجي على هذه الشاشة والنقر على تحصيل القيمة لإكمال العملية.
الشكل 1. مربّع حوار لشراء اشتراكالشكل 2. شاشة تسرد طرق الدفع لأحد التطبيقات داخل التطبيق
عملية الشراء.الشكل 3. شاشة الرمز الترويجي.
بالنسبة إلى الرموز الترويجية للاشتراكات، يُرجى ملاحظة ما يلي:
يمكن تحصيل قيمة الرموز المخصّصة من داخل تطبيقك فقط، في حين يمكن تحصيل قيمة الرموز التي تُستخدم لمرة واحدة.
يمكن تحصيل قيمتها من خلال كل من تطبيقك ومتجر Play.
بعد أن يحصّل المستخدم قيمة الرمز، سيظل بحاجة إلى شراء
الاشتراك مع تطبيق الرمز. يجب توفير طريقة دفع صالحة.
مقابل الاشتراك، وسيتم تجديده تلقائيًا في نهاية
الفترة التجريبية المجانية للرمز الترويجي.
في حال استخدام الإصدار 2.0 أو إصدار أحدث من Billing Library، يحصّل قيمة
يُطلب من "متجر Play" مرة واحدة شراء
اشتراكك من خلال "متجر Play". هذا الشراء خارج التطبيق، لذا احرص على
التأكد من أن تطبيقك يمكنه
التعامل مع عمليات الشراء هذه بسلاسة.
إذا لم يكن تطبيقك متوافقًا بعد مع الإصدار 2.0 من Billing Library، على المستخدم تنفيذ ما يلي:
تنزيل تطبيقك والانتقال إلى الاشتراك الصحيح ثم إجراء عملية شراء
الاشتراك من داخل تطبيقك لاستخدام الرمز الترويجي.
يمكنك أيضًا مشاركة رمز ترويجي من خلال إنشاء عنوان URL يوجّه المستخدم إلى
متجر Google Play وملء حقل إدخال الرمز تلقائيًا. يمكنك استخدام
التنسيق التالي لعنوان URL الخاص بالرمز الترويجي:
https://play.google.com/redeem?code=promo_code
يعرض الشكل 4 مربّع حوار تحصيل قيمة الرمز في تطبيق Google Play:
الشكل 4.رمز تحصيل القيمة في تطبيق Google Play
بعد أن يضغط المستخدم على تحصيل القيمة، إذا كان أحدث إصدار من تطبيقك
مثبت، سيطلب متجر Google Play من المستخدم فتح التطبيق. وإلا،
سيطلب متجر Google Play من المستخدم تحديث تطبيقك أو تنزيله.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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)."]]
