إنشاء منتج داخل التطبيق

اعتبارًا من 19 مايو 2025، لن يعود بإمكانك استيراد المنتجات أو تصديرها باستخدام ملفات CSV في Play Console. سيظل بإمكانك:

إدارة المنتجات بشكل مجمّع باستخدام Publishing API
إدارة الأسعار بشكل مجمّع باستخدام نماذج الأسعار
إدارة المنتجات باستخدام Play Console بشكلٍ فردي

باستخدام نظام الفوترة في Google Play، يمكنك إتاحة منتجات داخل التطبيقات يدفع المستخدمون مقابلها رسومًا لمرّة واحدة. وقد تتضمّن تلك المنتجات سلعًا افتراضية (مثل المستويات أو الجرعات السحرية في الألعاب) وخدمات برسوم إضافية داخل تطبيقك على Google Play.

يمكنك أيضًا إنشاء اشتراك يدفع المستخدمون مقابله رسومًا بشكل متكرر.

ملاحظة مهمة: تُطبّق سياسات المطوّرين ورسوم الخدمة في Google Play على كل من المنتجات داخل التطبيقات والاشتراكات.

مدى التوفّر

إذا كنت في موقع جغرافي تتوفّر فيه ميزة تسجيل التاجر، يمكنك استخدام نظام الفوترة في Google Play.

إذا كنت في موقع جغرافي تتوفّر فيه الخدمة وأردت بدء استخدام ميزات نظام الفوترة في Google Play في تطبيقاتك، يمكنك إعداد ملف الدفع والاطّلاع على معلومات حول ضبط إعدادات نظام الفوترة في Google Play من خلال الموقع الإلكتروني لمطوّري تطبيقات Android.

لتصبح المنتجات داخل التطبيق متاحة للشراء، يجب أن تكون تلك المنتجات نشطة وأن يستهدف التطبيق بلد المستخدم أو منطقته. وستظل المنتجات داخل التطبيق متاحة للشراء ما دامت نشطة، حتى وإن كان قد تم إلغاء نشر التطبيق. وعليك إيقاف المنتجات داخل التطبيق إذا كنت لا تريد إتاحتها للشراء.

إذا كنت تستخدم حسابًا تجريبيًا، انتقِل إلى موقع مطوّري تطبيقات Android الإلكتروني للاطّلاع على مزيد من المعلومات حول اختبار دمج Google Play Billing Library.

بعد إنشاء منتج داخل التطبيق، يُصبح متاحًا لمستخدمي أحدث إصدار من "متجر Google Play".

ملاحظة: قد يؤدي التوفّر في Play Console إلى إتاحة رمز التخزين التعريفي للمستخدمين ليتمكنوا من الشراء مباشرةً من "صفحة الألعاب الرئيسية" في "متجر Play" بدلاً من داخل التطبيق، وذلك كجزء من ميزة "التذكير بترك سلة التسوّق" التي تحثّ المستخدمين على إتمام عمليات الشراء التي لم تكتمل سابقًا. (يمكنك الاطّلاع على مزيد من المعلومات حول عمليات الشراء التي تتم خارج تطبيقك هنا.) وهذه الميزة مفعّلة تلقائيًا لجميع المطوّرين.

لإيقاف ميزة "التذكير بترك سلة التسوّق" لتطبيقك، يُرجى إرسال هذا النموذج.

الأذونات المطلوبة

لإتاحة منتج داخل التطبيق، يجب إدراج الإذن com.android.vending.BILLING في ملف بيان حزمة APK لتطبيقك. وفي حال توزيع تطبيقك على مستوى العالم، سيظل بإمكانك نشر التطبيقات التي تستخدم إذن com.android.vending.BILLING في كل البلدان.

إنشاء منتجات داخل التطبيق

إنشاء منتج واحد داخل التطبيق

قبل إنشاء منتج، احرِص على تخطيط معرّفات المنتج بعناية. يجب أن تكون معرّفات المنتجات فريدة لتطبيقك، ولا يمكن تغييرها أو إعادة استخدامها بعد إنشائها.

يجب أن تبدأ معرّفات المنتجات برقم أو حرف صغير، ويمكن أن تشتمل على أرقام (0-9) وحروف صغيرة (a-z) وشُرط سفلية (_) ونقاط (.).
لا يمكنك تغيير معرِّف منتج أو إعادة استخدامه بعد إنشاء المنتج.
ملاحظة: معرّف المنتج android.test وجميع معرّفات المنتجات التي تبدأ بالرمز android.test غير متاحة للاستخدام.

يُرجى اتّباع الخطوات التالية لإنشاء منتج داخل التطبيق:

افتح Play Console.
انتقِل إلى صفحة المنتجات داخل التطبيق (تحقيق الربح المادي باستخدام Play > المنتجات > المنتجات داخل التطبيق).
انقر على إنشاء منتج.
أدخِل تفاصيل منتجك.
- معرّف المنتج: وهو معرّف فريد للمنتج داخل التطبيق.
- العنوان: اسم مختصر للمنتج (55 حرفًا بحد أقصى، لكن ننصح بألا يزيد العنوان عن 25 حرفًا لعرضه بشكل صحيح في جميع السياقات)، مثل "جرعة النوم السحرية".
- الوصف: وصف طويل للمنتج (200 حرف بحد أقصى)، مثل "تُؤدي إلى نوم الشخصيات على الفور".
- الرمز: وهو صورة فريدة ودقيقة لمنتجك. ويجب ألا تتضمّن نصوصًا أو عروضًا ترويجية أو علامات تجارية. يظهر رمز المنتج في بطاقة بيانات المتجر وخلال مسار الشراء.
  - ‫32 بت بتنسيق PNG
  - ‫512 × 512 بكسل
  - حتى 1 ميغابايت
- السعر: أدخِل السعر بعملتك المحلية أو اختَر نموذج أسعار.
- تعدُّد الكميات: اسمح بالدفع مقابل عمليات شراء هذا المنتج بكميات متعدّدة. سيتمكّن المستخدمون من شراء كميات متعدّدة في نطاق حدود بلدهم أو منطقتهم. يُرجى مراعاة ما يلي:
  - لضبط إعدادات الدفع مقابل شراء المنتج عدّة مرّات في Play Console، يحتاج تطبيقك إلى الإصدار 4.0 من Google Play Billing Library. يُرجى زيارة موقع مطوّري تطبيقات Android الإلكتروني للتعرّف على كيفية دمج Google Play Billing Library في تطبيقك.
  - لا تتوفّر إمكانية الدفع مقابل كميات متعددة في بعض البلدان أو المناطق.
  - في معظم البلدان أو المناطق التي تتوفّر فيها إمكانية الدفع مقابل كميات متعددة، يبلغ الحدّ الأدنى لسعر رمز التخزين التعريفي 100 دولار أمريكي تقريبًا. لإتاحة الدفع مقابل كميات متعددة، يجب تعديل السعر (قبل احتساب الضريبة) ليكون أقلّ من الحدّ الأدنى في كل بلد أو منطقة.
- عرض حصري من خلال برنامج Play Points: يمكنك إتاحة منتجك مقابل نقاط برنامج Google Play Points فقط.
احفظ التغييرات التي أجريتها وانقر على تفعيل لإتاحة المنتج داخل التطبيق للمستخدمين.

اللغات والترجمات

تستخدم المنتجات داخل التطبيقات اللغة التلقائية نفسها المستخدمة في التطبيق. ولإضافة ترجمات بلغات معيّنة، اختَر منتجًا داخل التطبيق، ثمّ انقر على إدارة الترجمات وأدرِج اللغات التي تريدها. للاطّلاع على مزيد من المعلومات حول كيفية توفير تجربة ملائمة للغة المستخدمين وثقافتهم، يُرجى الاطّلاع على مقالة ترجمة تطبيقك وأقلمته.

إنشاء مجموعة منتجات متعددة داخل التطبيق

إدارة المنتجات بشكل مجمّع باستخدام Publishing API
إدارة الأسعار بشكل مجمّع باستخدام نماذج الأسعار
إدارة المنتجات باستخدام Play Console بشكلٍ فردي

لإنشاء عدة منتجات داخل التطبيق في الوقت نفسه، يمكنك تحميل ملف CSV يتضمّن تفاصيل كل منتج من منتجاتك.

تستخدم ملفات CSV الفواصل (,) والفواصل المنقوطة (;) لفصل قيم البيانات. تفصل الفواصل بين قيم البيانات الأساسية، وتفصل الفواصل المنقوطة بين القيم الفرعية.

عند إنشاء ملف CSV يحتوي على منتجات داخل التطبيق، يجب تحديد بنية CSV في الصف الأول ثم إتباعها بتفاصيل المنتجات في الصفوف التالية.

ملاحظة مهمة: يجب أن يظهر كل منتج بالكامل في سطر واحد داخل ملف CSV.

تحميل ملف CSV للمنتجات داخل التطبيق

لتحميل ملف CSV، اتّبِع الخطوات التالية:

افتح Play Console.
انتقِل إلى صفحة المنتجات داخل التطبيقات (تحقيق الربح المادي باستخدام Play > المنتجات > المنتجات داخل التطبيق).
انقر على استيراد.
- سيؤدي استيراد منتجات متعددة عن طريق تحميل ملف CSV إلى استبدال المنتجات الموجودة فقط إذا كانت قيمة معرّف المنتج في ملف CSV تتطابق مع معرّف المنتج لمنتج داخل التطبيق موجود في قائمة المنتجات. لا يؤدي استبدال منتج إلى حذف المنتجات داخل التطبيق غير الموجودة في ملف CSV.
أفلِت ملف CSV لتحميله أو انقر على تحميل.

تصدير ملف CSV لمنتجات حالية داخل التطبيق

لتصدير ملف CSV، اتّبِع الخطوات التالية:

افتح Play Console.
انتقِل إلى صفحة المنتجات داخل التطبيقات (تحقيق الربح المادي باستخدام Play > المنتجات > المنتجات داخل التطبيق).
انقر على تصدير.

عرض مثال على ملف CSV

في ما يلي مثال على بنية ملف CSV لاستخدامها وثلاثة أمثلة على منتجات داخل التطبيق:

يحدّد المثال الأول عنوانًا ووصفًا بلغتَين مختلفتَين (en_US وes_ES). ويُحدَّد سعر المنتج بحسب نموذج الأسعار.
لا يستخدم المثال الثاني نموذج أسعار. ولكنه يحدّد سعرًا للبلد التلقائيّ (الولايات المتحدة). وتعتمد أداة Play Console على أسعار الصرف الحاليّة وأنماط التسعير المناسبة محليًّا لتحديد الأسعار تلقائيًّا في جميع البُلدان الأخرى التي يوزَّع التطبيق فيها.
لا يستخدم المثال الثالث نموذج أسعار أيضًا، ويُحدد سعر المنتج يدويًا لكل بلد يُوزع فيه التطبيق.

مثال على بنية CSV

Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID

أمثلة على المنتجات داخل التطبيق

مثال 1

basic_sleeping_potion,published,managed_by_android,false,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,,4637138456024710495

مثال 2

standard_sleeping_potion, published,managed_by_android,false,en_US; Standard Sleeping Potion; Puts all creatures to sleep for 2 minutes.,true, 1990000,

مثال 3

invisibility_potion,published, managed_by_android,false,en_US; Invisibility Potion; Invisible to all enemies for 5 minutes.,false, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

قيم البيانات في ملفات CSV

يمكن أن يحتوي كل صف في ملف CSV للمنتجات داخل التطبيق على القيم التالية، إلا أنّ قيمة واحدة على الأقل من هذه القيم تكون غير محددة في كل صف:

`معرّف المنتج`	ينتج عن ضبط هذه القيمة في ملف CSV التأثير نفسه الناتج عن إدخال معرّف المنتج عند إنشاء منتج جديد داخل التطبيق. في حال تحديد `معرّف منتج` معيّن لمنتج داخل التطبيق موجود بالفعل في قائمة منتجات، يتم استبدال بيانات المنتج داخل التطبيق الموجود بالقيم التي تحدّدها في ملف CSV.
`حالة النشر`	يجب ضبط هذه القيمة على `منشور` أو `غير منشور`. ويشبه هذا الأمر ضبط منتج داخل التطبيق على نشط أو غير نشط.
`نوع الشراء`	يجب ضبط هذه القيمة على `managed_by_android`.
`الترجمة التلقائية`	يجب ضبط هذه القيمة على `false`، إذ لا تتوفّر الترجمة التلقائية لتفاصيل المنتجات داخل التطبيق. إذا أردت تقديم ترجمات لعنوان ووصف المنتج داخل التطبيق، يجب تحديد هذه الترجمات بشكل واضح ضمن قيمة `اللغة`.
`اللغة` و`العنوان` و`الوصف`	في حال إضافة لغة واحدة فقط لأحد المنتجات، يجب تحديد لغة التطبيق التلقائية وكذلك العنوان والوصف التلقائيان للمنتج: `app_default_locale; item_default_title; item_default_description;` عند ضبط قيمة `اللغة`، يمكنك استخدام أيّ من رموز اللغات التي تظهر عند إضافة ترجمات لبطاقة بيانات المتجر. ملاحظة: عند تحديد قيمتَي `العنوان` و`الوصف`، استخدِم الشُرط المائلة للخلف بدلاً من الفاصلة المنقوطة (`\;`) والشرطة المائلة للخلف (`\\`). إذا كنت تريد إضافة نُسخ مترجمة من عنوان المنتج ووصفه، يجب عليك إدراج اللغة التلقائية والعنوان والوصف ثم إدراج اللغات والعناوين والأوصاف لكل ترجمة بعد ذلك. في المثال التالي، يستخدم المنتج داخل التطبيق `en_US` (الإنجليزية (الولايات المتحدة)) بصفتها اللغة التلقائية و`es_ES` (الإسبانية (إسبانيا)) بصفتها الترجمة: `en_US; Invisibility Cloak; Makes you invisible.; es_ES; Capote Invisible; Se vuelven invisible.` ملاحظة: يحتوي التطبيق على لغة تلقائية واحدة، ولكن يحتفظ كل منتج داخل التطبيق بقائمته الخاصة من الترجمات. رغم أنّ اللغة الأولى في قيمة `اللغة` لكل منتج يجب أن تكون واحدة في ملف CSV بأكمله، يمكن أن تختلف اللغات الأخرى من منتج إلى آخر.
`ملء الأسعار تلقائيًا` و`البلد` و`السعر`	يمكنك ضبط `ملء الأسعار تلقائيًا` على `true` أو `false`. إذا كان المنتج داخل التطبيق يستخدم نموذج أسعار، عليك ضبط `ملء الأسعار تلقائيًا` على `false`، ويجب عدم تحديد قيمة في `السعر`. ملاحظة: عند تحديد سعر منتج في ملف CSV، عليك توفير السعر بوحدات ميكرو، حيث أن 1,000,000 وحدة ميكرو تساوي وحدة واحدة من العملة الحقيقية. استخدام أسعار الملء التلقائي توضّح الأقسام التالية كيفية تأثير قيمة `ملء الأسعار تلقائيًا` في بنية ومعنى قيمتَي `البلد` و`السعر`. إذا ضبطت ميزة `الملء التلقائي للأسعار` على `true`، يتم تحديد السعر التلقائي للمنتج فقط، ولن تُدرج قيمة `البلد`. على سبيل المثال، في حال استيفاء الشروط التالية: اللغة التلقائية لتطبيقك هي `en_US`. السعر التلقائي للمنتج داخل التطبيق غير شامل الضريبة هو 1.99 دولار أمريكي. تريد ملء بيانات الأسعار في البلدان الأخرى تلقائيًا. يمكنك ضبط قيم `أسعار الملء التلقائي` و`السعر` في نهاية أحد الصفوف في ملف CSV على النحو التالي: `true,1990000,‎` تحديد السعر لكل بلد وإذا ضبطت `أسعار الملء التلقائي` على `false` بدلاً من ذلك، يمكنك تحديد سلسلة من قيم `البلد` و`السعر` لكل البلدان التي توزّع فيها تطبيقك، بما في ذلك البلد المناظر للّغة التلقائية لتطبيقك. أمّا قيمة `البلد` فهي رمز البلد وفق المنظمة الدولية للمعايير (ISO) المكوّن من حرفَين كبيرَين والذي يمثّل بلدًا يتم توزيع تطبيقك فيه. ملاحظة: يجب تقديم رمز البلد والسعر لكل بلد يستهدفه تطبيقك. للاطّلاع على قائمة البلدان التي يستهدفها تطبيقك وتعديلها، استخدِم علامة التبويب البلدان/ المناطق في صفحة مرحلة الإنتاج. تمثّل كل قيمة `سعر` تكلفة المنتج بوحدات ميكرو تعادل العملة المستخدَمة في ذلك البلد. على سبيل المثال، إذا كنت تعرض تطبيقك بالأسعار التالية (جميع الضرائب مضمّنة) في بلدان أخرى: ‫6.99 ريال برازيلي في البرازيل ‫129 روبل روسي في روسيا ‫130 روبيه هندية في الهند ‫27,000 روبية إندونيسية في إندونيسيا ‫37 بيزو مكسيكي في المكسيك يمكنك ضبط قيم `أسعار الملء التلقائي` و`البلد` و`السعر` في نهاية الصف في ملف CSV على النحو التالي: `false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;`
`رقم تعريف نموذج الأسعار`	إذا كان المنتج مرتبطًا بنموذج أسعار، يجب ضبط `الملء التلقائي للأسعار` على`false`، ويجب عدم تحديد قيمة لعمود `السعر`. وإذا لم يكن المنتج مرتبطًا بنموذج أسعار، يجب عدم تحديد قيمة لـ `معرّف نموذج الأسعار`. بدلاً من ذلك، يجب ضبط `أسعار الملء التلقائي` و`البلد` و`السعر` استنادًا إلى الطريقة التي تريد بها ضبط أسعار المنتج داخل التطبيق. في حال استيراد ملف CSV، يمكنك تعديل الروابط بين المنتجات داخل التطبيق ونماذج الأسعار. لربط المنتج بنموذج أسعار معيّن، اضبط قيمة `رقم تعريف نموذج الأسعار` على رقم تعريف نموذج الأسعار ذلك. لإلغاء ربط منتج داخل التطبيق من جميع نماذج الأسعار، لا تضبط قيمة في `رقم تعريف نموذج الأسعار`. يمكنك ربط ما يصل إلى 1,000 سعر للتطبيقات أو للمنتجات داخل التطبيق بنموذج أسعار معيّن. ولذلك، لا تحدِّد قيمة `رقم تعريف نموذج الأسعار` نفسها في أكثر من 1,000 صف من ملف CSV.
`نوع حق الانسحاب في المنطقة الاقتصادية الأوروبية`	في حال توزيع التطبيق على المستخدمين في المنطقة الاقتصادية الأوروبية (EEA)، يجب ضبط القيمة هنا إما على `DIGITAL_CONTENT` أو `SERVICE`.
`تخفيض معدّلات ضريبة القيمة المضافة`	إذا كنت تبيع أخبارًا رقمية أو مجلّات أو صحفًا أو كتبًا أو فيديوهات أو موسيقى أو ملفات صوتية أو كتبًا مسموعة في بلدان أو مناطق مختلفة، قد تكون مؤهلاً لخفض معدّلات ضريبة القيمة المضافة. بالنسبة إلى الأسعار المخفّضة، ستتّبع القيم الموجودة في هذا الحقل التنسيق التالي: CountryCode;VATRate; يجب أن يتبع كل بلد أو سعر فاصلة منقوطة قبل إضافة بلد جديد أو سعر جديد. على سبيل المثال: ‫`CA;BOOK_1` لضبط معدّل الضريبة المخفَّض لفئة "الكتب 1" في كندا ‫`FR;NEWS_1; GR;NEWS_2` لضبط معدّل الضريبة المخفَّض لفئة "الأخبار 1" في فرنسا وفئة "الأخبار 2" في اليونان. يمكن ضبط الفئات على النحو التالي: `BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1` (بأحرف كبيرة أو صغيرة).
`الضرائب على خدمات الاتصالات والترفيه`	إذا كنت تريد تحصيل ضرائب الولاية على الاتصالات والترفيه، عليك تحديد ما إذا كان التطبيق أو المنتج عبارة عن منتج بث وضبط هذا الحقل على `مؤهَّل`، أو اترك الحقل فارغًا إن لم يكن كذلك. في الوقت الحالي، البلد الوحيد المسموح فيه تحصيل هذا النوع من الضرائب هو الولايات المتحدة. يتم دائمًا ضبط قيمة هذا الحقل على: CountryCode;Eligibility;Rate على سبيل المثال: `US;ELIGIBLE;VIDEO_RENTAL` إذا كان التطبيق مؤهَّلاً، يمكنك ضبط الحقل وفقًا للفئات التالية: ‫`VIDEO_RENTAL` لبث الفيديو: اشتراك أو استئجار أو الدفع لكل مشاهدة ‫`VIDEO_SALES` لبث الفيديو: المبيعات ‫`VIDEO_MULTI_CHANNEL` لبث الفيديو: قنوات متعددة ‫`AUDIO_RENTAL` للبث الصوتي: اشتراكات أو استئجار ‫`AUDIO_SALES` للبث الصوتي: المبيعات ‫`AUDIO_MULTI_CHANNEL` للبث الصوتي: قنوات متعددة

هل كان ذلك مفيدًا؟

كيف يمكننا تحسينها؟