إعداد الحقول الوصفية — مندوب المبيعات، المواصفات، المستندات والمزيد
يقرأ Vertex مجموعة صغيرة من الحقول الوصفية الاختيارية في مساحة الأسماء vertex لتشغيل الإضافات التي يحتاجها كتالوج تقني — بطاقة مندوب المبيعات، وجدول المواصفات التقنية، وكتلة المستندات والتنزيلات، وMPN وGTIN، وسطر "يُشحن من"، والإفصاح عن تاريخ السعر.
لا تُعدّ سوى ما تريده فعلًا. كل حقل وصفي اختياري — إذا كان فارغًا، فإن المكوّن المقابل في الواجهة الأمامية ببساطة لا يُعرض. لا تخطيط معطوب، ولا حشو احتياطي، ولا خطأ.
بعض هذه الكتل لها أيضًا مفتاح تشغيل/إيقاف في Customize ▸ Theme settings ▸ B2B — Show price history on PDP، وShow 'Ships from' on PDP (بالإضافة إلى Default 'Ships from' location الخاص بها)، وShow 'Documents & downloads' on PDP. توفّر الحقول الوصفية أدناه المحتوى؛ بينما تقرّر هذه المفاتيح ما إذا كان يُسمح للكتلة بالظهور أصلًا.
كيف تعمل الحقول الوصفية في Vertex
كل القيم في هذا الدليل تُخزَّن كـ حقول وصفية في Shopify — حقول مخصّصة مُنظَّمة مرتبطة بمنتج أو شركة. تعرّف كل حقل مرة واحدة في Settings ▸ Custom data، ثم تملؤه لكل منتج (أو لكل شركة) مثل أي حقل آخر.
هناك مكانان ستعمل فيهما:
- عرّف الحقل مرة واحدة — Settings ▸ Custom data ▸ Products (أو Companies) ▸ Add definition. هذا يُنشئ الحقل بحيث يظهر على كل منتج/شركة.
- املأه لكل عنصر — افتح منتجًا (أو شركة) ▸ مرّر إلى منطقة Metafields ▸ أدخل القيمة.
استخدم مساحة الأسماء والمفتاح الدقيقين المذكورين لكل حقل أدناه (مثل vertex.mpn). يجب أن تكون مساحة الأسماء vertex حتى يقرأها Vertex.
بمجرد وجود التعريف، يمكنك ملء القيم بشكل جماعي من Products ▸ حدّد الصفوف ▸ Edit products ▸ أضف عمود الحقل الوصفي، أو عبر استيراد CSV / Shopify Admin API. تحتاج فقط إلى إنشاء كل تعريف مرة واحدة.
بطاقة جهة اتصال مندوب المبيعات
تُظهر بطاقة مندوب المبيعات مدير حساب باسمه على كل نقطة تواصل B2B — شارة في رأس سطح المكتب، وبطاقة كاملة في أسفل درج الجوال، وبطاقة على لوحة تحكم حساب العميل.
يُعيَّن المندوب لكل شركة (وليس لكل منتج، وليس كإعداد للقالب)، بحيث يمكن لكل شركة أن يكون لها مندوبها الخاص.
أين تعيّنه: Customers ▸ Companies ▸ [الشركة] ▸ Metafields — باستخدام حقول الشركة الوصفية التالية:
| الحقل الوصفي (namespace.key) | النوع | مثال | ملاحظات |
|---|---|---|---|
vertex.rep_name | Single-line text | Sarah Chen | يُفعّل عرض بطاقة المندوب. |
vertex.rep_email | Single-line text | [email protected] | تُعرض كزر للمراسلة بنقرة واحدة. |
vertex.rep_phone | Single-line text | +1-555-0142 | يُعرض كزر للاتصال بنقرة واحدة. صيغة E.164 مفضّلة. |
تُعرض البطاقة فقط عند تعبئة vertex.rep_name و عندما يكون المشتري مسجّل الدخول إلى تلك الشركة و عندما لا يكون وضع Storefront هو B2C فقط. تُظهر الصورة الرمزية الحرف الأول من اسم المندوب — لا يوجد حقل لصورة المندوب أو لمسمّاه الوظيفي.
لأن المندوب موجود على سجل الشركة، يرى المشترون المرتبطون بشركات مختلفة مندوبين مختلفين تلقائيًا. عيّنه مرة واحدة لكل شركة.
موقع "يُشحن من"
أظهر للمشترين من أي مستودع أو مركز تنفيذ يُشحن المنتج — مفيد للموزّعين الذين لديهم عدة مستودعات إقليمية.
هذا مزيج من إعداد للقالب (القيمة الافتراضية + مفتاح التشغيل/الإيقاف) وحقل وصفي اختياري لكل منتج (قيمة التجاوز):
- القيمة الافتراضية للقالب كاملاً + المفتاح — Customize ▸ Theme settings ▸ B2B: فعّل Show 'Ships from' on PDP، وعيّن Default 'Ships from' location (مثل Cleveland, OH). تُعرض القيمة الافتراضية تحت عنوان كل منتج.
- تجاوز لكل منتج — عيّن الحقل الوصفي
vertex.ships_fromللمنتج (single-line text، مثل Atlanta, GA) على أي منتج يُشحن من مستودع مختلف.
| المكان | القيمة | مثال |
|---|---|---|
| إعداد القالب: Default 'Ships from' location | قيمة افتراضية لكامل الواجهة الأمامية | Cleveland, OH |
الحقل الوصفي للمنتج: vertex.ships_from | تجاوز لكل منتج | Atlanta, GA |
اترك القيمة الافتراضية فارغة (والحقل الوصفي فارغًا) لإخفاء السطر على المنتجات التي ليس لها موقع محدّد.
رقم القطعة من المُصنّع (MPN)
MPN — رقم قطعة OEM — هو متجه البحث الأول للمشترين الصناعيين. فرق المشتريات تحمل دائمًا تقريبًا رقم قطعة في يدها قبل أن تبحث، لذا فإن تعبئة MPN ترفع معدل نجاحك في البحث بشكل كبير.
أين تعيّنه: الحقل الوصفي vertex.mpn للمنتج (single-line text).
| الحقل الوصفي | مثال |
|---|---|
vertex.mpn | DWE357K |
يُعرض MPN في رأس صفحة المنتج ويُطابَق بواسطة البحث التنبؤي في Vertex — بحيث يمكن للمشترين لصق MPN لمنافس وما زالوا يجدون منتجك.
إذا لم تملأ شيئًا آخر، فاملأ MPN. تبحث فرق المشتريات بالرقم أولًا؛ وكل ما عداه ثانوي.
GTIN لخدمة Google Merchant Center
يجعل GTIN (الرقم التجاري العالمي للسلعة) منتجاتك مؤهّلة لمعاينات Google Shopping الأغنى ويحسّن معدلات المطابقة في Merchant Center.
أين تعيّنه: الحقل الوصفي vertex.gtin للمنتج (single-line text). يُصدر Vertex بالفعل قيمة barcode للمتغير كـ GTIN في البيانات المُنظَّمة، لذا عيّن هذا فقط عندما تريد نشر GTIN عام مختلف.
| الحقل الوصفي | مثال |
|---|---|
vertex.gtin | 0885911234567 |
جدول مواصفات المنتج
أظهر للمشترين جدول مواصفات تقنية نظيفًا من عمودين على صفحة المنتج — سعة الـ chuck، الجهد، الوزن، الأبعاد — أيًّا كان ما يقارنه مشتروك بين المنتجات.
أين تعي ّنه: الحقل الوصفي vertex.tech_specs للمنتج. هذا قائمة من إدخالات "spec"، حيث يحتوي كل إدخال على label وvalue وunit اختياري.
| حقل الإدخال | مثال |
|---|---|
label | Chuck capacity |
value | 13 |
unit (اختياري) | mm |
مثال — مواصفات مثقاب صناعي:
| Label | Value | Unit |
|---|---|---|
| Chuck capacity | 13 | mm |
| Maximum torque | 65 | Nm |
| No-load speed | 0–2,100 | rpm |
| Battery voltage | 18 | V |
| Weight (with battery) | 1.8 | kg |
تعرض صفحة المنتج هذه كجدول Technical specifications نظيف من عمودين. تختفي الكتلة تلقائيًا عندما يكون الحقل الوصفي فارغًا.
أشارت مسودات سابقة من هذا الدليل إلى كائن وصفي tech_spec_row. لا يستخدم Vertex كائنًا وصفيًا للمواصفات — بل يقرأ الحقل الوصفي المفرد من نوع قائمة vertex.tech_specs الموصوف أعلاه.
المستندات والتنزيلات
أرفق ملفات PDF بمنتج — أوراق بيانات، MSDS، كتيبات، أوراق تقنية، أدلة تركيب، بطاقات ضمان — ويعرضها Vertex ككتلة مستندات أنيقة على صفحة المنتج.
أين تعيّنها: حقل وصفي واحد من نوع مرجع ملف للمنتج لكل نوع مستند. شغّل الكتلة عبر Theme settings ▸ B2B ▸ Show 'Documents & downloads' on PDP.
| الحقل الوصفي | تسمية الزر | الاستخدام النموذجي |
|---|---|---|
vertex.datasheet | Datasheet | ورقة بيانات المنتج القياسية. |
vertex.msds | MSDS | صحيفة بيانات سلامة المواد — مطلوبة للعديد من المواد الكيميائية ومواد التشحيم والمذيبات والرذاذ. |
vertex.brochure | Brochure | كتيب المبيعات. |
vertex.tech_sheet | Tech sheet | ورقة تقنية مستقلة. |
vertex.install_guide | Install guide | دليل التركيب أو التجميع. |
vertex.warranty | Warranty | بطاقة الضمان. |
إذا لم يكن للمنتج أي من هذه الحقول الوصفية مملوءًا، يتم إلغاء عرض كتلة المستندات بأكملها — لا عنوان فارغ، ولا حشو احتياطي. في اللحظة التي ترفع فيها ملف PDF واحدًا، تظهر الكتلة بذلك الزر الواحد.
يمكنك أيضًا إدراج الشهادات (ISO، UL، CE، إلخ) باستخدام الحقل الوصفي من نوع قائمة vertex.certifications؛ وتُعرض كشارات على صفحة المنتج.
الإفصاح عن تاريخ السعر
إذا كنت تعمل في أسواق ذات لوائح للإفصاح عن الأسعار (توجيه EU Omnibus مثلًا)، أو ببساطة تريد أن تُظهر للمشترين المهتمين بالشفافية كيف تطوّر السعر، يمكن لـ Vertex عرض كتلة تاريخ سعر قابلة للطي على صفحة المنتج.
أين تعيّنه: الحقل الوصفي vertex.price_history للمنتج — قائمة يحتوي فيها كل إدخال على تاريخ وسعر. شغّل الكتلة عبر Theme settings ▸ B2B ▸ Show price history on PDP.
| Date | Price |
|---|---|
| 2025-01-15 | 14.50 |
| 2025-03-22 | 13.80 |
| 2025-09-04 | 12.32 |
اترك الحقل الوصفي فارغًا لإخفاء الكتلة.
صياغة شارة شروط NET
شارة شروط NET التي تظهر في شريط ترحيب B2B (وعلى شاشات الحساب والطلبات) مدفوعة بـ حقل وصفي للشركة، وليس باسم شرط الدفع الأصلي في Shopify ولا بإعداد للقالب.
أين تعيّنه: الحقل الوصفي vertex.payment_terms للشركة (single-line text).
| الحقل الوصفي | مثال |
|---|---|
vertex.payment_terms | NET 30 — أو صياغة مخصصة مثل NET 30 — Pay by invoice |
اتركه فارغًا فلا تُعرض أي شارة شروط NET لتلك الشركة.
إعداد شروط الدفع المؤجّل عند السداد الحقيقية (حتى تتمكن الشركة فعلًا من الدفع بالفاتورة) يتم في Customers ▸ Companies ▸ [الشركة] ▸ Payment terms — انظر دليل إعداد B2B. الحقل الوصفي vertex.payment_terms أعلاه هو بحت التسمية التي يعرضها Vertex في الـ chrome؛ والاثنان مستقلان، لذا عيّن كليهما.
ما الذي لا يحتاج إلى حقل وصفي
البيانات التالية أصلية بالفعل في Shopify B2B ولا تحتاج إلى أي شيء في مساحة الأسماء vertex:
| البيانات | من أين تأتي |
|---|---|
| سعر B2B وشرائح الكميات | قائمة أسعار الكتالوج |
| قواعد الكمية (MOQ، الحد الأقصى، الزيادة) | قواعد كميات الكتالوج |
| اسم الشركة والمواقع | سجل الشركة الأصلي في Shopify |
| حالة الإعفاء الضريبي | إعداد الضريبة على مستوى الشركة |
| تاريخ الطلبات (لإعادة الطلب) | طلبات Shopify الأصلية |
| تقدّم حدّ الإنفاق | vertex.spending_limit على موقع الشركة (اختياري) |
يقرأ Vertex هذه مباشرةً من Shopify. الحقول الوصفية في هذا الدليل تملأ فقط الفجوات التي لا يوجد فيها مكافئ أصلي في Shopify — مثل جهات اتصال مندوبي المبيعات والمستندات التقنية والمواصفات وملصقات "يُشحن من" لكل منتج.
التحقق من إعدادك
افتح منتجًا في الواجهة الأمامية وامش عبر قائمة التحقق هذه:
- يظهر MPN في رأس صفحة المنتج.
- يظهر "يُشحن من [المدينة]" تحت عنوان المنتج.
- تُعرض كتلة المستندات بزر واحد لكل ملف PDF رفعته.
- يُعرض جدول المواصفات بكل الصفوف التي أضفتها.
- تظهر كتلة تاريخ السعر (إن كانت مملوءة) كبطاقة قابلة للطي أسفل السعر.
ثم سجّل الدخول إلى الواجهة الأمامية كمشتري B2B في شركة ا ختبارية للتحقق من بطاقة المندوب:
- تُعرض شارة مندوب المبيعات في رأس سطح المكتب (≥1170px).
- يفتح زر البريد الإلكتروني عميل بريدك مع عنوان المندوب مُعبّأً مسبقًا.
- يُفعّل زر الهاتف اتصالًا على الجوال.
- يُظهر درج الجوال (<1170px) بطاقة المندوب في الأسفل.
- تُظهر لوحة تحكم الحساب بطاقة المندوب الكاملة.
ما هي الخطوة التالية
- دليل إعداد B2B → — فعّل B2B الأصلي من البداية للنهاية حتى يكون لبطاقة المندوب وعناصر B2B مكان للارتباط به.
- دليل أوضاع الواجهة الأمامية → — اختر كيف تظهر واجهة المستخدم المدفوعة بـ B2B في واجهتك الأمامية.
- مرجع إعدادات القالب → — مفاتيح صفحة المنتج التي تقترن بهذه الحقول الوصفية.
- الأسئلة الشائعة + استكشاف الأخطاء → — أهم الأسئلة المتعلقة بالإعدادات مع إجاباتها.