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

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

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

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

مدى التوفّر

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عرض مثال على ملف 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 للبث الصوتي: قنوات متعددة