إنشاء الروابط المختصرة واحدًا تلو الآخر لا يعود عمليًا حين يضم جدول الحملة أو كتالوج المنتجات مئات الصفوف. يستقبل الاستيراد المجمّع في Posty5 ملف CSV واحدًا، ويفحص كل صف قبل إنشاء أي شيء، وينشئ الروابط في الخلفية، ثم يمنحك ملف نتائج يضع كل عنوان مختصر بجوار الصف الذي جاء منه.
- افتح Bulk import — افتح أداة اختصار الروابط في لوحة تحكم Posty5 واختر Bulk import.
- املأ القالب — نزّل قالب CSV واملأ صفًا لكل رابط وجهة؛ العمود url وحده إلزامي.
- ارفع وافحص — ارفع الملف، واختر القيم الافتراضية للأعمدة الفارغة، ثم افحصه. يسرد Posty5 كل صف فاشل قبل إنشاء أي شيء.
- شغّل الاستيراد — ابدأ الاستيراد وتابع تقدمه، أو غادر الصفحة وانتظر الإشعار.
- نزّل النتائج — نزّل ملف النتائج بكل عنوان مختصر، وملف الأخطاء إن فشل أي صف.
قبل أن تبدأ
تحتاج إلى حساب Posty5 مسجَّل الدخول. افتح أداة اختصار الروابط في لوحة التحكم واختر Bulk import. يعتمد الإنشاء المجمّع على خطتك: إن لم تكن خطتك تتضمنه، تعرضه الصفحة مقفلًا.
ابدأ من قالب CSV الذي توفره الصفحة. فيه صف العناوين الصحيح وصف مثال واحد، فلا يبقى عليك إلا استبدال المثال ببياناتك.
جهّز ملف CSV
العمود url وحده إلزامي. أسماء الأعمدة لا تتأثر بحالة الأحرف، وأي عمود لا يعرفه Posty5 يُتجاهل ويُذكر في خطوة الفحص.
url | عنوان الوجهة. إلزامي. ويُقبل baseUrl اسمًا بديلًا له. |
name | اسم يخص قائمتك. إن تُرك فارغًا، يملؤه Posty5 في الخلفية من صفحة الوجهة. |
customId | نهاية من اختيارك للرابط المختصر، حين تسمح خطتك بالنهايات المخصصة. يجب ألا تكون مستخدمة، ولو من صف سابق في الملف نفسه. |
tag | وسم لتجميع الروابط وتصفيتها لاحقًا. |
refId | مرجعك الخاص، مثل رمز منتج من نظامك. |
templateId | قالب رمز QR لهذا الصف. يتقدّم على القيمة الافتراضية التي تختارها في خطوة الرفع. |
احفظ الملف بصيغة CSV بترميز UTF-8 مع فواصل وصف عناوين. القيم التي تحتوي على فواصل توضع بين علامتي تنصيص مزدوجتين، وهو ما تفعله تطبيقات الجداول تلقائيًا عند التصدير إلى CSV.
ابدأ استيرادًا مجمّعًاارفع الملف وافحصه
بعد الرفع، اختر القيم الافتراضية للصفوف التي تترك عمودًا فارغًا (القالب والوسم ومعرّف المرجع)، ثم افحص الملف. يقرأ Posty5 كل صف دون إنشاء أي شيء، ويسرد كل صف فاشل برقمه، بدءًا من أول صف تحت صف العناوين. يفشل الصف حين:
- يكون الرابط مفقودًا، أو ليس عنوان ويب صالحًا، أو أطول من 2,048 حرفًا
- يُحظر الرابط لأنه غير آمن، تمامًا كما يحدث مع الرابط المنفرد
- يتجاوز الاسم أو الوسم أو المرجع 255 حرفًا
- تكون النهاية المخصصة غير مسموحة في خطتك، أو غير صالحة، أو مستخدمة من قبل
- يكون القالب غير موجود أو لا يخصك
شغّل الاستيراد
ابدأ الاستيراد حين تبدو نتيجة الفحص سليمة. يعمل في الخلفية: تعرض الصفحة عدد الصفوف التي عولجت وأُنشئت وفشلت، ويمكنك مغادرتها — سيصلك إشعار عند انتهاء الاستيراد.
يمكنك إلغاء استيراد قيد التشغيل. الروابط التي أُنشئت قبل الإلغاء تبقى في حسابك.
تُجلب عناوين الصفحات وروابط التطبيقات العميقة بعد إنشاء كل رابط، لذا قد يظهر اسم المضيف اسمًا للرابط الجديد لفترة قصيرة.
- يتسع الملف الواحد لما يصل إلى 5,000 صف و2 MB.
- يمكن إنشاء ما يصل إلى 20,000 صف بالجملة لكل حساب يوميًا (بتوقيت UTC)، مع احتساب كل عمليات الاستيراد واستدعاءات API معًا.
- يعمل استيراد واحد في كل مرة، ويمكن أن ينتظر خلفه ما يصل إلى ثلاثة أخرى.
- إذا نفد رصيد حسابك من الأرصدة أثناء الاستيراد، يفشل ذلك الصف وكل الصفوف التي تليه، وتبقى الروابط التي أُنشئت بالفعل.
نزّل النتائج
عند انتهاء الاستيراد، نزّل ملف النتائج. يضم سطرًا لكل صف في ملفك: رقم الصف، وحالته (أُنشئ، أو فشل، أو تُخطّي، أو لم يُعالج إذا توقف الاستيراد قبل الوصول إليه)، ومعرّف الرابط الجديد وعنوانه المختصر، وسبب الفشل إن فشل الصف.
ملف ثانٍ يضم الصفوف الفاشلة وحدها بقيمها الأصلية، لتصلحها وترفع ذلك الملف من جديد.
تُعرض عمليات الاستيراد السابقة بحالتها وأعدادها، فيمكنك فتح أي منها لاحقًا وتنزيل ملفاتها مجددًا. تُحفظ الملفات المرفوعة وملفات النتائج 7 أيام، وسجل الاستيراد 30 يومًا — نزّل ما تحتاجه قبل ذلك. أما الروابط نفسها فلا تُحذف أبدًا.
صدّر روابطك لاحقًا
- من قائمة الروابط المختصرة، اختر Export CSV أو Export JSON لتنزيل روابطك مع عدادات زياراتها.
- يتبع التصدير عوامل التصفية المطبقة على القائمة، فصفِّ حسب الوسم أولًا لتصدير حملة واحدة.
- يتسع التصدير الواحد لما يصل إلى 50,000 صف، الأحدث أولًا؛ والقائمة الأطول تُقطع عند هذا الحد ويذكر الملف ذلك.
- خلية CSV تبدأ بـ = أو + أو - أو @ تُضاف إليها فاصلة عليا في بدايتها، ليعرضها تطبيق الجداول نصًا بدل أن ينفذها صيغةً.
التنفيذ من خلال الكود
يستطيع المطورون فعل الشيء نفسه عبر Posty5 API باستخدام مفتاح API: ينشئ POST /api/short-link/bulk ما يصل إلى 100 صف في طلب واحد ويعيد نتيجة لكل صف، ويرسل POST /api/link-bulk-jobs ملفًا كاملًا كمهمة يمكنك متابعة حالتها. يستخدم كلاهما الفحوص والحدود نفسها التي في لوحة التحكم. المسارات موثقة في مرجع API.
الأسئلة الشائعة
كم رابطًا يمكنني استيراده دفعة واحدة؟
يتسع الملف الواحد لما يصل إلى 5,000 صف و2 MB، ويمكن إنشاء ما يصل إلى 20,000 صف بالجملة لكل حساب يوميًا.
ماذا يحدث لصف فيه رابط غير صالح؟
تسرده خطوة الفحص برقمه وسببه قبل إنشاء أي شيء. وأثناء الاستيراد، لا يوقف الصف الفاشل بقية الصفوف أبدًا.
هل يمكنني اختيار نهايات الروابط بنفسي؟
نعم، في العمود customId، حين تسمح خطتك بالنهايات المخصصة. يجب ألا تكون كل نهاية مستخدمة، ولو من صف سابق في الملف نفسه.
إلى متى يمكنني تنزيل النتائج؟
تُحفظ الملفات المرفوعة وملفات النتائج 7 أيام. أما الروابط نفسها فتبقى في حسابك.
هل يمكنني تصدير روابطي المختصرة؟
نعم. تُصدّر قائمة الروابط المختصرة ملف CSV أو JSON مع عدادات زيارات كل رابط، وفق عوامل تصفية القائمة، بما يصل إلى 50,000 صف لكل ملف.
