مقدمة



تتيح واجهة برمجة التطبيقات لمشاركة خطة بيانات الجوّال للمشتركين في خدمات الجوّال الاطّلاع على معلومات خطتهم ضمن "الإعدادات" باستخدام أنماط واجهة مستخدم Android المُنشأة. ويتيح أيضًا للمستخدمين بشكل اختياري عرض خطتهم وإدارتها باستخدام مساحات عرض أخرى، مثل "مساعد Google". سيتم تعريف العديد من المستخدمين على "خطة بيانات الهاتف الجوّال" أولاً من خلال إشعار يخبرهم بإمكانية عرض خطتهم وإدارتها. بعد الموافقة على مشاركة خطة البيانات بين مشغّل شبكة الجوّال وGoogle، سيتمكّن المشتركون من عرض "خطة بيانات الجوّال" مع المعلومات المُرسَلة من خلال واجهة برمجة التطبيقات.
واجهة المستخدم على اليسار هي مثال على الشكل الذي يمكن أن يبدو عليه الدمج اعتبارًا من الإصدار 20.1 من "خدمات Google Play". مرِّر سريعًا داخل الصورة للاطّلاع على المزيد.
المبادئ التوجيهية
-
الدقة
يقدّم المشغّل معلومات دقيقة وفي الوقت المناسب باستخدام واجهة برمجة التطبيقات بأفضل ما لديه من إمكانات. وستؤثر أي معلومات غير دقيقة سلبًا في مصداقية ميزة "خطة بيانات الجوّال" وستؤدي إلى تدهور تجربة المستخدم مع تطبيقات Google التي تستخدم هذه المعلومات. -
الوضوح
يمكن للمستخدم الاطّلاع على ما اشترك فيه أو اشتراه باستخدام بنية واجهة برمجة التطبيقات الخاصة بالخطة والوحدة. تمت كتابة اسم الخطة والوحدة وأوصافهما لتكون واضحة قدر الإمكان. توقَّع أنّ بعض المستخدمين لن يكونوا على دراية كافية بالتكنولوجيا الرقمية أو أنّ لغة هواتفهم ستكون مختلفة عن لغتهم الأم. بدلاً من استخدام مصطلحات فنية مثل "محدود السرعة"، استخدِم كلمة غير فنية عند الاقتضاء، مثل "سيتم تخفيض سرعة بياناتك إلى…". -
الإيجاز
غالبًا ما يتصفّح المستخدمون النص بدلاً من قراءته بحثًا عن المعلومات الأساسية. ضَع الكلمات الرئيسية في بداية الجُمل وأزِل الكلمات التي لا تغيّر معناها واستفِد من السياق. على سبيل المثال، عندما يكون السياق هو رصيد حساب المستخدم، يمكن اختصار الجملة "عندما تشحن حسابك، سيتم تمديد صلاحية رصيد حسابك" إلى "تمديد الصلاحية عن طريق شحن رصيدك".
خيارات الإعداد

1 الشعار 2 اسم العلامة التجارية لمشغّل شبكة الجوّال
Logo
قبل اختبار عملية الدمج، سيطلب منك أحد أعضاء الفريق تقديم مادة عرض صورة للشعار الذي سيظهر بجانب اسمك. راجِع إرشادات العلامة التجارية الخاصة بمشغّلك لمعرفة الاستخدامات المسموح بها لشعارك. يُرجى تقديم شعار مربّع بحجم 600 × 600 بكسل أو أكبر على خلفية غير شفافة، ويُفضّل أن يكون بتنسيق PNG أو SVG، ولكن يمكن أيضًا استخدام ملف JPG عالي الجودة.
إنّ شعار مشغّل شبكة الجوّال مع اسم علامته التجارية يشيران إلى المستخدمين بأنّه يمكن الوثوق في خطتهم ومعلومات حسابهم. من المهم اختيار الشعار المناسب لواجهة المستخدم لأنّه يجب أن يكون قابلاً للتمييز بنظرة سريعة حتى عند الأحجام الصغيرة. العلامات التجارية هي الأنسب لهذه الأسباب. إذا كان اللون مرتبطًا بشكل كبير بعلامتك التجارية، ننصحك باستخدام نسخة من شعارك تستفيد منه بشكل كامل. تجنَّب استخدام العلامات اللفظية إذا أمكن لأنّها قد لا تكون مقروءة جدًا عند عرضها بحجم صغير وسيظهر اسم المشغّل بجانبها. لا تدمج العلامة التجارية والشعارات النصية في صورة واحدة لأنّ ذلك سيجعلها أقل وضوحًا.

استخدام علامات العلامات التجارية أو علامات الكلمات المختصرة

تجنُّب العلامات اللفظية الطويلة بسبب سهولة القراءة والتكرار

لا تستخدِم شعارات مجمّعة أو شعارات تتضمّن عناصر إضافية
اسم العلامة التجارية لمشغّل شبكة الجوّال
يجب أن يكون اسم علامتك التجارية هو الاسم الذي سيتعرّف عليه المستخدمون بسهولة، وأن يكون أيضًا أقصر نسخة منه. لا تستخدِم جملًا ترويجية أو تكتب الاختصارات بشكل كامل عندما يكون من الممكن استخدام نسخة أقصر. في ما يلي بعض الأمثلة:
جيد: "MyTelco" و"ACG"
تجنَّب: "MyTelco Wireless"، "American Cellular Group"
سيئ: "MyTelco - Innovation unbound" و"ACG Inc."
إرشادات الكتابة
- الاختصار
المساحة محدودة وسيسهل على المستخدمين قراءة المحتوى. وهذا مهم بشكل خاص للمستخدمين الذين يتصلون بالإنترنت لأول مرة. - لا تستخدِم الأحرف الكبيرة بالكامل
قد يشعر المستخدمون وكأنّك تصرخ في وجوههم، كما أنّ قراءة النص أو فحصه يصبح أكثر صعوبة. ولا ينطبق ذلك على الاختصارات أو أسماء العلامات التجارية. - تجنُّب علامات الترقيم غير الضرورية
لا تبالغ في استخدامها. يجب دائمًا إنهاء الجملة الأخيرة بنقطة. لا تستخدِم النقاط إذا كانت هناك جملة أو عبارة واحدة فقط. - عدم تضمين عناوين URL
لن تكون هذه العناوين قابلة للنقر في واجهة المستخدم ما لم يُذكر خلاف ذلك في مرجع واجهة برمجة التطبيقات.
نوع الخطة
بالنسبة إلى معظم مشغّلي شبكات الجوّال، يكون هذا النوع ببساطة "مدفوع مسبقًا" أو "مدفوع لاحقًا"، ولكن في بعض الأحيان يحدّد المستخدمون نوع خطة فريدًا أو مسوّقًا اشتركوا فيه. لا تستخدِم اسم خطة وصفيًا يمكن أن يتغيّر من شهر إلى آخر أو يتضمّن تفاصيل الخطة، مثل أسعار المكالمات أو الرسائل القصيرة. يمكن أيضًا ترك هذا الحقل فارغًا إذا لم تكن هناك حاجة إليه.

1 planStatus.title
2 planStatus.updateTime
الإجراءات المقترَحة | ما ننصحك بتجنّبه: | عدد الأحرف | الاقتطاع |
دفع مسبق
الدفع عند الاستخدام SuperMetro GoJUMP |
مكالمات غير محدودة على الشبكة، 0.20 ريال سعودي/رسالة SMS
ما مِن خطة Super Internet 5GB 129b |
ننصح بأن يكون عدد الأحرف أقل من 50 حرفًا | علامة الحذف بعد سطرَين |
اسم الوحدة
مرجع واجهة برمجة التطبيقات: PlanModule.moduleName

1 PlanModule.moduleName
2 Plan.expirationTime
3 PlanModule.description
احرص على أن تكون أسماء الوحدات قصيرة باستخدام أسماء فريدة عند أخذ جميع أسماء الخطط المحتملة التي يمكن أن تظهر هنا في الاعتبار. استخدِم وصف الوحدات لإيصال تفاصيل الخطة. تجنَّب وضع الحصة أو الصلاحية في العنوان لأنّهما سيظهران مكرّرَين في شريط البيانات وفوقه.
إذا ترك اسم الوحدة فارغًا، ستكون الإعدادات التلقائية لواجهة المستخدم هي "البيانات" للبيانات المحدودة و "بيانات غير محدودة" للبيانات غير المحدودة.
الإجراءات المقترَحة | ما ننصحك بتجنّبه: | عدد الأحرف | الاقتطاع |
الحد الأقصى لسرعة الإنترنت
Social Fun Pack ليلة مشاهدة الأفلام بيانات شبكة الجيل الثالث بيانات غير محدودة بسرعة 1 ميغابت في الثانية |
إضافة سرعة إنترنت قدرها 1 غيغابايت
فيديوهات غير محدودة مع iFlix وNetflix وYouTube وLINE TV وJOOX وApple Music وFungjai وTIDAL وAtimeOnline وDeezer وCat Radio وCOOLISM وBEC TERO RADIO |
ننصح باستخدام أقل من 24 حرفًا | لا ينطبق |
وصف الوحدة
مرجع واجهة برمجة التطبيقات: PlanModule.description
قدِّم وصفًا لأي تفاصيل لم يتم تضمينها في العنوان. على سبيل المثال، اشرح مزايا "حزمة الترفيه الفائق" بطريقة موجزة. تجنَّب استخدام لغة تسويقية أو ترويجية أو تكرار اسم الخطة أو تفاصيل المكالمات الهاتفية أو الرسائل القصيرة.
الإجراءات المقترَحة | ما ننصحك بتجنّبه: | عدد الأحرف | الاقتطاع |
بث ترفيهي بلا حدود بسرعة 2 ميغابت في الثانية على YouTube وLINE TV وJOOX وApple Music وFungjai وTIDAL وAtimeOnline وDeezer وCat Radio وCOOLISM وBEC TERO RADIO | استمتع بأوقاتك مع 12 ساعة من الإنترنت غير المحدود و24 ساعة من المكالمات غير المحدودة.
تضمن خطط SuperMetro الجديدة أن يظل حسابك نشطًا دائمًا طوال فترة اشتراكك. |
ننصح بعدم تجاوز 180 حرفًا | لا ينطبق |
رصيد الحساب
مرجع واجهة برمجة التطبيقات: AccountInfo
يمكن لمستخدمي الدفع المُسبَق الاطّلاع على رصيد حسابهم الحالي وصلاحيته، ويمكنهم أيضًا الاطّلاع على نص يصف أي سياسات قد يفرضها مشغّل شبكتك بشأن صلاحية الرصيد واستخدامه.

1 AccountInfo.accountBalance
2 AccountInfo.validUntil
3 نص مساعِد لرصيد الحساب (يجب التواصل مع فريق الدعم لإعداد الحساب)
أرصدة القروض
مرجع واجهة برمجة التطبيقات: AccountInfo
يمكن عرض حالة القرض إلى جانب رصيد الحساب للمستخدمين الذين يدفعون مسبقًا. ويشمل ذلك مبلغ القرض وأي رصيد قرض متاح يمكن إنفاقه. يجب تقديم وصف موجز للمستخدم حول كيفية تحصيل مبلغ القرض.

1 AccountInfo.accountBalance
+ AccountInfo.loanBalance
2 AccountInfo.unpaidLoan
3 AccountInfo.loanBalance
4 نص المساعدة بشأن القروض (يجب التواصل مع فريق الدعم لإعداد هذه الميزة)
اسم العرض
مرجع واجهة برمجة التطبيقات: Offer.planName
يجب أن يكون هذا الاسم قصيرًا قدر الإمكان باستخدام اسم فريد أو وصفي عند التفكير في جميع أسماء خطط العروض الترويجية المحتملة. الاعتماد على وصف العرض الترويجي لتوضيح تفاصيله، مثل سياسة الاستخدام العادل أو القيود الأخرى لا تستخدِم عبارات ترويجية أو تسويقية غير ضرورية عندما يكون الاسم الوصفي كافيًا، وتجنَّب تضمين السعر في الاسم لأنّه يظهر بجانب العرض.

1 Offer.planName
2 Offer.planDescription
3 PlanOffer.FormOfPayment 4 بنود الشراء
الإجراءات المقترَحة | ما ننصحك بتجنّبه: | عدد الأحرف | الاقتطاع |
Go No Limit 1 Mbps Day Pass
إضافة رصيد بسعة 1 غيغابايت غيغابايت واحد من بيانات شبكة الجيل الثالث تذكرة يومية لاستخدام الإنترنت بلا حدود |
أفضل باقة 4 غيغابايت
إضافة 1 غيغابايت بسعر مخفّض |
ننصح بأن يكون طول العنوان أقل من 40 حرفًا. | لا ينطبق |
وصف العرض التجاري
مرجع واجهة برمجة التطبيقات: Offer.planDescription
يجب أن تكون الرسالة قصيرة ومحدّدة قدر الإمكان لتوضيح القيود المفروضة على الاستخدام، مثل السرعة أو تاريخ انتهاء الصلاحية أو الحدود الزمنية، إذا كان ذلك منطبقًا. تجنَّب استخدام عبارات ترويجية وتسويقية مفرطة.
الإجراءات المقترَحة | ما ننصحك بتجنّبه: | عدد الأحرف | الاقتطاع |
بيانات شبكة الجيل الرابع بسرعة 10 ميغابت في الثانية كحد أقصى صالحة لمدة 24 ساعة. | أسرع إنترنت من الجيل الرابع احصل على المنتج اليوم!
بيانات LTE غير محدودة على أفضل مشغّل شبكة جوّال في البلد |
ننصح بأن يتضمّن العنوان 50 حرفًا كحد أقصى لكي يظهر في قائمة العروض. | علامة الحذف على سطرَين في قائمة العروض
عدم الاقتطاع في مربّع حوار العرض |
لوحة العرض الدوّارة الخاصة بإعادة الشراء
عند الإشارة إلى العروض على أنّها عمليات إعادة شراء، تظهر فوق جميع العروض الأخرى، ما يسهّل على المستخدمين العثور على خططهم وحِزمهم المفضّلة وتجديدها بسرعة. الاطّلاع على شكلها في المقدمة
تحديد طريقة استلام الدفعات
يتم ترجمة هذا النص الذي توفّره GTAF وإضافته إلى وصف العرض، ويتم ضبطه لجميع العروض المُرسَلة إلى المستخدم. على سبيل المثال، "تم الخصم من رصيد الحساب" لمعظم مستخدمي الدفع المسبق أو "تم تحصيل الرسوم باستخدام طريقة الدفع المحفوظة" في الحالات التي يتم فيها حفظ بطاقة ائتمان أو بطاقة سحب آلي. قد تتغيّر الرسائل الدقيقة. الاطّلاع على خيارات أخرى
بنود الشراء
يمكن أن تدعم "خطة بيانات الجوّال" أي بنود أو شروط شراء تظهر حاليًا مع العروض في القنوات الأخرى التي يتم بيعها فيها. على سبيل المثال، إذا كانت ضريبة القيمة المضافة مستبعدة عادةً من السعر، يمكنك كتابة "السعر لا يشمل ضريبة القيمة المضافة بنسبة% 7". يتم إعداد ذلك عند إعداد المشغّل.
الحصة والاستخدام
توفّر "خطة بيانات الجوّال" طريقة تتيح للمستخدمين تتبُّع استخدامهم وحصتهم المتبقية بسهولة. بعض الحقول مطلوبة، ولكن على جميع المشغّلين ملء أكبر عدد ممكن من الحقول لمساعدة المستخدم في تتبُّع ما استخدمه وما تبقى لديه. في واجهة المستخدم الموضّحة أدناه، يتم تنسيق كل العناصر وترجمتها بواسطة Google باستثناء عنوان الوحدة "حصة الإنترنت".

1رمز يستند إلى نوع البيانات المحدّد في PlanModuleTrafficCategory
ستظهر الرموز أدناه مع فئات الزيارات المحدّدة. يجب عدم ضبط فئة حركة المرور بشكل عشوائي لفرض ظهور رمز معيّن.
quotaBytes
أقل من remainingBytes
2
3لا يظهر شريط التقدّم إلا إذا تم ملء quotaBytes
وremainingBytes
تم ضبط 7planState
على INACTIVE
في الحالات التي تكون فيها ميزات الخطة غير نشطة مؤقتًا
الإشعارات
تُعدّ الإشعارات مهمة للمستخدمين لإدارة بياناتهم على الأجهزة الجوّالة بفعالية. يمكن للمشغّلين إرسال إشعارات محدّدة إلى المشتركين بشأن خططهم من خلال واجهة برمجة التطبيقات. يتم إنشاء نص الإشعار وترجمته وإرساله بواسطة GTAF استنادًا إلى حقول واجهة برمجة التطبيقات المطلوبة. للاطّلاع على قائمة حديثة بالإشعارات المتوافقة والحقل المطلوب لكل منها، يُرجى الاطّلاع على دليل واجهة برمجة التطبيقات للإشعارات. ويتبع تصميمها إرشادات إشعارات Android في Material Design بهدف تقديم إشعارات دقيقة ومحدّدة وفي الوقت المناسب وذات صلة بالسياق، ما يتيح للمستخدمين إدارة بياناتهم.

أمثلة على الإشعارات المتوافقة: (قد يتغيّر المحتوى)
1 رصيد بيانات منخفض 2 نفاد البيانات 3 تذكير بشأن انتهاء الصلاحية 4 إشعار الترحيب 5 تحذير بشأن الدفع أثناء الاستخدام 6 إعادة تعبئة رصيد الحساب
صفحة الدعم
يمكن إعداد صفحة دعم للمساعدة في توجيه المستخدمين إلى قنوات الدعم بدلاً من إرسالها إلى أداة الملاحظات من Google. بدءًا من الإصدار 15.3 من "خدمات Google Play" والإصدارات الأحدث، يمكن للمستخدمين الوصول إلى هذه الميزة من قائمة "المزيد من الخيارات" في أعلى "خطة بيانات الجوّال". تواصَل مع أحد أعضاء فريق "مشاركة خطة بيانات الجوّال" لإعداد الميزة.

1 مساعدة الدعم 2 عنوان الرابط 3 العنوان الفرعي للرابط
يمكن للمستخدمين الاطّلاع على قائمة بخيارات الدعم عبر البريد الإلكتروني والرسائل القصيرة والمكالمات والويب، بالإضافة إلى مقتطف نصي لتحديد السياق للمستخدم. لا يُسمح بالربط بتطبيقات أخرى أو تنزيل تطبيقات أخرى من "متجر Play". يتم تحديد عنوان الرابط وعنوانه الفرعي باللغة الإنجليزية وتترجمهما Google.
يمكن ملء نوايا البريد الإلكتروني والرسائل القصيرة بنص أساسي وسطر موضوع (البريد الإلكتروني فقط). استخدِم هذه الروابط إذا كنت تريد توجيه المستخدم لتقديم المعلومات المناسبة للتعامل مع طلب الدعم.
نصائح حول صفحة الدعم
عندما يصل المستخدمون إلى هذه الصفحة، كيف يمكنهم معرفة الخيار الذي يجب اختياره؟ إذا كانت بعض الخيارات مخصّصة لأنواع حسابات معيّنة، يجب توضيح ذلك. استخدِم العنوان الفرعي لتقديم فكرة للمستخدمين عن الوقت أو السبب الذي يجب أن يستخدموا فيه هذا الخيار، وذلك باستخدام أوقات الرد المتوقّعة أو ساعات العمل أو غير ذلك من المعلومات المفيدة.