مصادر البيانات ووسوم الدمج

تتيح لك وسوم الدمج تخصيص كل رسالة ببيانات حقيقية. اكتب {{field}} في أي مكان داخل عنصر نص — Hi {{first_name}}, your {{plan}} renews soon — فيرى كل مستلم قيمه الخاصة. ويمكن للمشروع ربط عدة مصادر بيانات في آن واحد: يحصل كل منها على اسم مستعار قصير، وتُكتب حقول المصدر الذي ليس هو الجمهور بالصيغة {{alias.field}} (مثل {{products.name}}).

أنواع مصادر البيانات

تُدار مصادر البيانات من قسم مصادر البيانات في لوحة التحكم الخاصة بك (أما قوائم جهات الاتصال فتوجد ضمن جهات الاتصال). وهناك نوعان:

الجداول المستضافة

جدول مخزَّن في MailInApp. حدّد الأعمدة، وأضف الصفوف من لوحة التحكم، فيصبح كل عمود حقل دمج. وهو الأنسب حين تكون بياناتك اليوم في جدول بيانات. قوائم جهات الاتصال جداول مستضافة يُضمن وجود عمود email فيها.

اتصالات API

وجّه MailInApp إلى نقطة نهاية HTTP خاصة بك تُرجع JSON. تُجلب الصفوف من جهة الخادم — من خوادمنا، لا من البريد الوارد لدى المستلم ولا من متصفحات زوارك أبدًا.

ثلاث طرق لمصادقة الاتصال، تختار منها من القائمة المنسدلة المصادقة عند إعداده:

• ترويسات ثابتة — أضف ترويسات طلب (مثل ترويسة Authorization) بقيمة ثابتة. وهي الخيار الأبسط، والوحيد الذي كان منطقيًا قبل أن يصبح للرمز المميز تاريخ انتهاء.
• OAuth2 Client Credentials — عنوان URL للرمز المميز إلى جانب معرّف العميل وسرّه. يستبدلهما MailInApp برمز وصول من جهة الخادم، ويخزّنه مؤقتًا، ويجدّده تلقائيًا قبل انتهاء صلاحيته — وهو النمط الشائع لمعظم تكاملات المؤسسات القائمة على مفتاح API وسرّ.
• OAuth2 JWT Bearer — عنوان URL للرمز المميز، والجهة المُصدِرة، والموضوع، والجمهور المستهدف، ومفتاح RSA خاص (PEM). يوقّع MailInApp تأكيد JWT جديدًا ويستبدله برمز وصول، دون تسجيل دخول تفاعلي ودون رمز تجديد يحتاج إلى متابعة — وهذه هي طريقة مصادقة تكاملات Salesforce من خادم إلى خادم (راجع دليل تكامل Salesforce)، وتعمل بالطريقة نفسها مع حساب خدمة Google أو أي مزوّد هوية آخر يدعم هذا المسار.

أيًّا كان الوضع الذي تختاره، يُحقن رمز bearer الناتج كترويسة Authorization تلقائيًا — وأي ترويسات إضافية تضيفها تُرسل معه، مدموجة فيه (تُتجاهل هناك أي ترويسة اسمها حرفيًا Authorization، لأن الرمز المُنشأ هو الذي يُعتمد دائمًا). وتخضع جميع حقول بيانات الاعتماد — قيم الترويسات، وسرّ العميل، والمفتاح الخاص — للقاعدة نفسها:

• تُخزَّن من جهة الخادم فقط،
• لا تُرسل إلى المتصفح أبدًا،
• تُخفى في كل استجابة API بعد حفظها.

عند تعديل اتصال يظهر سرّه مخفيًا والنقر على اختبار هذه الإعدادات، يلزم إعادة إدخال القيمة الحقيقية أولًا؛ أما اختبار الاتصال المحفوظ فيُجري الفحص على بيانات الاعتماد كما هي مخزّنة تمامًا، دون إرسالها أبدًا إلى متصفحك.

ربط المصادر: لوحة «البيانات»

لوحة «البيانات» في الاستوديو هي المكان الذي يحدد فيه المشروع المصادر التي يستخدمها. يربط زر + إضافة مصدر بيانات… مصدرًا واحدًا (حتى 10 لكل مشروع)؛ ولكل اتصال ثلاثة أجزاء:

• الاسم المستعار — المعرّف القصير الذي تستخدمه وسوم الدمج الخاصة به: أحرف لاتينية صغيرة وأرقام وشرطات سفلية، ويبدأ بحرف (مثل contacts وproducts وopen_invoices). وتؤدي إعادة تسمية الاسم المستعار إلى تحديث أي عنصر تكرار مرتبط به تلقائيًا.
• المصدر — الجدول المستضاف أو قائمة جهات الاتصال أو اتصال API الذي يقف خلفه.
• الدور — طريقة استخدام الرسالة له:
  • الجمهور — قائمة جهات الاتصال التي تُرسل إليها الرسالة. واحدة على الأكثر لكل مشروع، ويجب أن تكون قائمة جهات اتصال. حقولها هي الوسوم المجرّدة — {{first_name}} و{{email}} — وتُحلّ لكل مستلم من صفه الخاص وقت الإرسال. كما يقود الجمهور محدِّد «المعاينة باسم» وإسناد الردود إلى كل مستلم.
  • حقول الدمج — حقول تُقرأ تحت الاسم المستعار: {{alias.field}}، وتُحلّ من الصف الأول في المصدر عند عرض الرسالة. استخدمها للمحتوى المشترك — المنتج المميز، وإحصاءات هذا الأسبوع — لا للبيانات الخاصة بكل مستلم.
  • صفوف التكرار — صفوف تغذّي عناصر التكرار المرتبطة بالاسم المستعار. لا تساهم بأي حقول دمج خارج التكرار. ويغذّي دور collection نفسه أيضًا عناصر مخططات KPI والأعمدة والخطوط والدائري — راجع ربط المخططات ببيانات حقيقية.

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

الوسوم المدمجة

توفر المنصة نفسها بعض الوسوم بدلًا من مصدر بيانات — تسردها لوحة «المتغيرات» في الشريط الجانبي للاستوديو إلى جانب أي متغيرات تحددها؛ انقر أحدها لنسخ وسمه.

• {{recipient_email}} — العنوان الذي تُرسل إليه الرسالة.
• {{today}} / {{now}} — التاريخ (أو التاريخ والوقت) الذي تُفتح فيه الرسالة.
• {{unsubscribe_url}} — رابط لإلغاء الاشتراك بنقرة واحدة خاص بكل مستلم. يتضمنه إعداد التذييل المسبق بالفعل — راجع الإرسال إلى جهات اتصالك.

رمز الخصم الخاص بالمتجر المخصص لكل مستلم وللاستخدام مرة واحدة ليس وسم دمج — بل أضف عنصر خصم التجارة الإلكترونية (للجماهير المرتبطة بـ Shopify/WooCommerce فقط) إلى الرسالة بدلًا من ذلك، فيُنشئ رمزه الخاص ويعرضه تلقائيًا. راجع عرض الخصم.

لا تُحلّ الوسوم المدمجة إلا في عمليات الإرسال الحقيقية (اليدوية، أو المجدولة، أو إرسال اختباري من نوع «Backfill») — أما معاينة الاستوديو ومساحة التصميم فتعرضانها فارغة أو كعنصر نائب، مثل أي حقل لا قيمة نموذجية له.

المحتوى المتكرر

يعرض عنصر التكرار عناصره الفرعية مرة لكل صف من المصدر الذي تربطه به — شبكة منتجات، أو ملخص مقالات، أو قائمة فواتير مفتوحة. اختر المصدر حسب اسمه المستعار في لوحة الخصائص؛ وداخل التكرار، تُحلّ الوسوم مقابل الصف الخاص بكل تكرار.

المعاينة ببيانات حقيقية

يعرض محدِّد بيانات المعاينة في الاستوديو مساحة التصميم بأي صف من قائمة الجمهور، فيمكنك التحقق من أن {{first_name}} تعرض فعلًا Amina لا {{first_name}} قبل الإرسال. ويمكن أيضًا إعطاء حقول المصادر الأخرى قيمًا للمعاينة.

معلومات مفيدة

• تُعرض الحقول المفقودة لدى مستلم ما كسلاسل فارغة — صمّم بحيث تُقرأ الرسالة بشكل طبيعي حتى مع قيمة فارغة.
• تحلّ الصفحات المستضافة (العرض المباشر، والنماذج المستضافة) وسوم الدمج لكل مستلم وقت العرض، فيبقى التخصيص قائمًا حتى حين يغادر المستلم البريد الوارد.
• تواصل المشاريع التي بُنيت قبل دعم المصادر المتعددة العمل دون تغيير: يظهر مصدرها المرتبط الوحيد في لوحة «البيانات» تلقائيًا، وتُحلّ وسوم {{field}} المجرّدة دائمًا مقابل الجمهور.