تطبيق اختصار الروابط في ڤاريونس: التثبيت والسلاج المخصص والتتبع
تطبيق اختصار الروابط هو بطاقة id link-shortener في السوق تفتح مسار /dashboard/link-shortener: يختصر روابط الحملات بسلاج مخصص ووسوم وتاريخ انتهاء ومعاينة فورية، وكل رابط يُفتح عبر مسار عام /s/[slug] مع إحصاء النقرات.
آخر تحقق: 2026-09-19
يثبَّت التطبيق من سوق /dashboard/apps بزر تثبيت على بطاقة «اختصار الروابط» بوصف اختصار وتتبع روابط الحملات والتسويق، ثم يظهر زر فتح ينقل إلى /dashboard/link-shortener. والصفحة بأربعة تبويبات: نظرة عامة وإنشاء رابط وإدارة الروابط وتحليلات، وتُحمَّل المكونات دون عرض خادم.
نموذج الإنشاء يطلب اسم الرابط وسلاجاً مخصصاً من 3 إلى 50 حرفاً بصيغة أحرف وأرقام وشرطات مع زر توليد تلقائي، ورابط الوجهة الكامل، والوصف، والوسوم مع زر إضافة، وتاريخ انتهاء اختياري. وبجانبه معاينة فورية تعرض الرابط المختصر بصيغة http://{tenantSlug}.{domain}/s/{slug} مع زر نسخ وعنصر QR يبقى عنصراً مؤقتاً حتى اكتمال النموذج، إضافة إلى بطاقة معلومات: الاسم والوجهة والحالة (جاهز أو غير مكتمل) والانتهاء والوسوم.
التحقق قبل الإرسال يشمل صيغة السلاج وتحقق new URL للوجهة ووجود معرف المستخدم، ثم POST /api/dashboard/shortlinks. وعند تكرار السلاج يرد الخادم 409 SLUG_ALREADY_EXISTS مع عرض بدائل مقترحة. وبعد النجاح يُصفَّر النموذج ويُنتقل تلقائياً لتبويب الإدارة.
تبويب نظرة عامة يعرض إجمالي الروابط وإجمالي النقرات والنشط ومتوسط النقرات مع زر تحديث، وقائمة الروابط الخمسة الأعلى نقراً مع نسخ سريع، وآخر النقرات بأيقونة الجهاز والدولة. وتُحسب الإحصاءات من GET shortlinks ثم تُجلب الأنشطة من GET recent-activity بحد خمسة.
تُخزَّن الروابط في نموذج ShortLink بحقول المستأجر والسلاج الفريد لكل متجر والاسم حتى 100 حرف والرابط الأصلي بصيغة http(s) والوصف والحالة (نشط أو متوقف أو مؤرشف) وتاريخ الانتهاء والوسوم وتحليلات النقرات الكلية والفريدة وآخر نقرة والتوزيع بالتاريخ والجهاز والدولة.
خطوات الإعداد في ڤاريونس
ثبّت التطبيق من السوق
افتح /dashboard/apps واضغط تثبيت على بطاقة اختصار الروابط، ثم اضغط فتح للانتقال إلى /dashboard/link-shortener.
أنشئ رابطاً مختصراً
من تبويب إنشاء رابط أدخل الاسم والسلاج المخصص ورابط الوجهة والوسوم والانتهاء، وراقب المعاينة حتى تصبح الحالة جاهزاً ثم اضغط إنشاء.
انسخ وشارك
انسخ الرابط المختصر من المعاينة أو من الإدارة وشاركه في حملاتك؛ الفتح يتم عبر /s/[slug].
أدر الروابط
من تبويب الإدارة عدّل الاسم والوصف أو أوقف رابطاً مؤقتاً أو احذفه أو أعد تفعيله حسب الحملة.
تابع النقرات
من تبويبي نظرة عامة وتحليلات راجع الإجمالي والنشط والمتوسط والروابط الأعلى وآخر النقرات بالجهاز والدولة.
أسئلة شائعة
ما شروط السلاج المخصص؟
من 3 إلى 50 حرفاً بصيغة أحرف وأرقام وشرطات وشرطة سفلية، فريد لكل متجر، والمكرر يرد خطأ 409 مع بدائل.
كيف يُفتح الرابط المختصر؟
عبر مسار عام /s/[slug] على نطاق متجرك يحوّل إلى رابط الوجهة الأصلي ويسجّل حدث نقرة في التحليلات.
هل يمكن انتهاء الرابط تلقائياً؟
نعم، حقل تاريخ الانتهاء اختياري؛ بعد التاريخ يتوقف التحويل وتظهر الحالة منتهية في الإدارة.
ما إحصاءات النقرات المتاحة؟
الإجمالي والفريد وآخر نقرة والتوزيع بالتاريخ والجهاز والدولة، مع الروابط الخمسة الأعلى نقراً وآخر خمس نقرات.
هل رمز QR حقيقي في المعاينة؟
لا، عنصر QR في المعاينة مؤقت؛ الرموز الحقيقية تُولَّد من تطبيق صانع QR وتربط بالرابط المختصر يدوياً.
استكشاف الأخطاء
1) خطأ 409 عند الإنشاء: السلاج مستخدم؛ اختر من البدائل المقترحة أو ولّد سلاجاً جديداً. 2) الحالة غير مكتمل: أكمل الاسم والسلاج الصحيح ورابط الوجهة بصيغة http(s). 3) الرابط لا يحوّل: راجع حالته (متوقف أو مؤرشف أو منتهي) وأعد التفعيل. 4) الإحصاءات لا تتحدث: اضغط تحديث؛ الأنشطة الأخيرة تُجلب بحد خمسة عناصر.
حدود مهمة
• السلاج حتى 50 حرفاً والاسم حتى 100 والوصف حتى 500 والوسوم حتى 30. • الرابط الأصلي يجب أن يبدأ بـ http:// أو https://. • عنصر QR في المعاينة مؤقت وليس رمزاً قابلاً للمسح. • الروابط المنتهية تتوقف دون حذف سجلها وإحصاءاتها.