تطبيقك الأول على زد: من حساب الشريك إلى تثبيت مُختبَر

ابدأ بحساب الشريك

كل ما تبنيه على زد، من تطبيقات وثيمات، تديره من لوحة الشركاء (Partner Dashboard). منها تنشئ تطبيقاتك، وتفتح متاجر التطوير، وتتابع التثبيتات والاشتراكات، ثم ترسل تطبيقك للمراجعة.

للتسجيل، افتح بوابة مطوّري زد واضغط Sign Up، ثم املأ البيانات التالية:

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

أنشئ مسودة تطبيقك

1. من لوحة الشركاء افتح My Apps واضغط Create Application، ثم اختر تطبيقًا عامًا أو خاصًا.
2. أدخل المعلومات الأساسية التي سيراها التاجر: اسم التطبيق بالعربية والإنجليزية، وحتى 3 تصنيفات، واللغات التي يدعمها تطبيقك، وبريدًا للدعم يتواصل معك التجار عبره.
3. اضغط Create Application. يُحفظ تطبيقك كمسودة، وتستطيع العودة إليه وإكمال تعديله متى شئت.

بعدها تنتقل إلى صفحة تفاصيل التطبيق، وفيها يبدأ الإعداد الفعلي.

احصل على بيانات الاعتماد والصلاحيات والروابط

افتح General Settings. ستجد في قسم مفاتيح التطبيق ثلاث قيم تحتاجها لتنفيذ OAuth:

• OAuth 2.0 End-Point: رابط التفويض الذي يعالج طلبات OAuth.
• Client ID: الـ ID الفريد لتطبيقك.
• Client Secret: المفتاح السري الذي يوثّق تطبيقك.

بعد ذلك اختر الصلاحيات (Scopes) التي يحتاجها تطبيقك. الصلاحيات تحدد البيانات والخدمات التي يصل إليها تطبيقك في المتجر، فاكتب مبررًا واضحًا لكل صلاحية، لأن فريق المراجعة يدقق فيها عند الإرسال. وإذا أردت أن يفتح تطبيقك داخل لوحة التاجر، فاختر صلاحية التطبيقات المضمّنة (embedded apps) قبل تفعيل خيار التضمين.

ثم أضف روابط التطبيق:

• Application URL: العنوان الذي يستضيف تطبيقك ويصل إليه التاجر.
• Redirection URL: الصفحة التي ينتقل إليها التاجر بعد التثبيت. وفي التطبيقات المضمّنة، يتولى هذا الرابط إتمام OAuth قبل أن ينقل التاجر إلى التطبيق المضمّن.
• Callback URL: الرابط الذي يتواصل عبره تطبيقك مع زد أثناء OAuth.

أكمل صفحة التطبيق بالوصف، وبيانات المطوّر، وفيديو بصيغة رابط YouTube مضمّن، وصور للتطبيق، وأيقونة. تستطيع رفع صور خاصة بالنسخة الإنجليزية، وإن لم تفعل تُستخدم الصور العربية.

جهّز متجر التطوير

متجر التطوير متجر خاص تختبر فيه تطبيقاتك وثيماتك قبل إتاحتها للعامة. يعمل مثل متجر تاجر حقيقي، فتثبّت تطبيقك كما يفعل صاحب المتجر، وتتحقق من الواجهة والتكامل مع الـ API، وتكتشف الأخطاء مبكرًا.

1. من القائمة الجانبية في لوحة الشركاء افتح Development Stores.
2. اضغط Create Store، فتنشئ زد المتجر وتعطيه رابطًا خاصًا.
3. اضغط Dashboard Access بجانب المتجر للدخول إلى لوحة التاجر فيه.

يمكنك إنشاء أكثر من متجر تطوير، وهذا يسمح لك بتخصيص متجر لكل سيناريو اختبار.

المتجر الجديد فارغ، فأضف إليه بيانات تجريبية قبل أن تبدأ الاختبار:

• المنتجات: استوردها دفعة واحدة أو أضفها منتجًا منتجًا.
• العملاء: أضف بعضهم من صفحة العملاء.
• الطلبات: أنشئ طلبات من صفحة الطلبات.
• الدفع: التحويل البنكي (أدخل بيانات حساب صحيحة)، أو الدفع عند الاستلام الذي يتطلب خيار شحن مخصصًا. الدفع بالبطاقات ليس ضروريًا للاختبار، وإن احتجته فاطلبه من فريق الدعم عبر المحادثة.

اختبر رحلة التثبيت من أولها لآخرها

1. افتح تطبيقك من My Apps، ثم انتقل إلى Application Details واضغط Install on my development store.
2. في متجر التطوير افتح سوق التطبيقات، ثم انزل إلى قسم التطبيقات الخاصة بمتجرك، وستجد تطبيقك هناك.
3. فعّل التطبيق من سوق التطبيقات. يجب أن تظهر شاشة OAuth، وأن يصبح التطبيق مفعّلًا بعد إتمامها.
4. اشترك في إحدى الباقات، وتأكد من وصول بيانات الباقة إلى نظامك.
5. جرّب الخصائص الرئيسية لتطبيقك، وتأكد من تزامن البيانات بين زد ونظامك.

إذا تعثّر OAuth أثناء الاختبار، ففي مركز المساعدة فحصان سريعان. عند ظهور OAuth authorization server error تأكد من صحة الـ Redirection URL والـ Callback URL. أما internal server error فمصدره غالبًا استجابة الـ Server الخاص بك أنت في خطوة إعادة التوجيه، فابدأ بـ Logs الـ Server الخاص بك.

قبل أن ترسل التطبيق للمراجعة

أضف باقات التسعير، إما متكررة أو حسب الاستخدام. تحتاج باقة واحدة على الأقل، ويمكنك إضافة حتى أربع باقات. ثم تأكد من جاهزية كل ما تتحقق منه المراجعة:

• اتفاقية الشراكة موقّعة.
• التطبيق مُختبَر على متجر تطوير، وكل خصائصه تعمل.
• حسابات تجريبية وبيانات دخول إلى منصتك جاهزة.
• حالات اختبار (QA) معدّة تساعد في التحقق.
• خطوات تفعيل التطبيق للتاجر ومتطلبات الإعداد والأسئلة الشائعة مكتوبة.

بعد الإرسال يصلك إشعار بحالة مراجعة تطبيقك وموعد النشر المتوقع. وكلما اكتمل تجهيزك، قلّت جولات التعديل.