تخصيص رسائل "المراسلة داخل التطبيق" من Firebase


توفّر ميزة "الرسائل داخل التطبيق" في Firebase مجموعة مفيدة من السلوكيات وأنواع الرسائل التي تم ضبطها مسبقًا بمظهر وأسلوب تلقائيين، ولكن في بعض الحالات قد تحتاج إلى توسيع نطاق السلوكيات ومحتوى الرسائل. تتيح لك ميزة "المراسلة داخل التطبيق" إضافة إجراءات إلى الرسائل وتخصيص شكلها وأسلوبها.

إضافة إجراء إلى رسالتك

باستخدام الإجراءات، يمكنك استخدام رسائلك داخل التطبيق لتوجيه المستخدمين إلى موقع إلكتروني أو شاشة معيّنة في تطبيقك.

يستخدم "Firebase In-App Messaging" معالِجات الروابط لمعالجة الإجراءات. يمكن لحزمة تطوير البرامج (SDK) استخدام عدد من المعالِجات، لذا إذا كان تطبيقك يتضمّن معالِجًا، يمكن لـ Firebase In-App Messaging استخدامه بدون أي إعداد إضافي. إذا لم يكن لديك معالج حتى الآن، يمكنك استخدام Firebase Dynamic Links. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء الروابط الديناميكية على نظام التشغيل iOS.

أضِف الإجراء إلى رسالتك باستخدام وحدة تحكّم Firebase

بعد أن يتضمّن تطبيقك معالج روابط، يمكنك إنشاء حملة تتضمّن إجراءً.

  1. في وحدة تحكّم Firebase، انتقِل إلى DevOps والتفاعل > المراسلة.

  2. ابدأ سير العمل لإعداد حملة جديدة:

    • إذا كانت هذه حملتك الأولى:

      1. انقر على إنشاء حملتك الأولى.
      2. اختَر ميزة "الرسائل داخل التطبيق" في Firebase وانقر على إنشاء.

    • إذا سبق لك إنشاء حملات:

      1. في علامة التبويب الحملات، انقر على حملة جديدة.
      2. اختَر المراسلة داخل التطبيق.

  3. اتّبِع التعليمات الظاهرة على الشاشة لإعداد الحملة.

  4. أدخِل بطاقة ونص الزر وإجراء الزر أو إجراء الصورة أو إجراء البانر، حيث يكون الإجراء رابطًا عميقًا ذا صلة.

يعتمد تنسيق الإجراء على تنسيق الرسالة الذي تختاره. تحصل النوافذ المشروطة على أزرار إجراءات مع محتوى نصي للزر ولون النص ولون الخلفية قابلة للتخصيص. من ناحية أخرى، تصبح الصور وإعلانات البانر العلوية تفاعلية وتستدعي الإجراء المحدّد عند النقر عليها.

تعديل مظهر الرسالة وأسلوبها

تتيح لك ميزة Firebase In-App Messaging تخصيص طريقة عرض الرسائل لتغيير طريقة عرض تطبيقك لتنسيق الرسائل وأنماط الخطوط وأشكال الأزرار والتفاصيل الأخرى. هناك طريقتان لتعديل طرق عرض الرسائل: تعديل طرق العرض التلقائية في Firebase In-App Messaging أو إنشاء مكتبة طرق عرض الرسائل الخاصة بك من البداية.

ملاحظة: لا يتوفّر هذا المنتج على أهداف macOS أو Mac Catalyst أو App Clip أو watchOS.

تعديل طرق العرض التلقائية

أسهل طريقة لتخصيص رسائلك هي استخدام رمز عرض الرسائل التلقائي في Firebase In-App Messaging.

استنسِخ مستودع firebase-ios-sdk

للبدء، عليك استنساخ أحدث إصدار من مستودع firebase-ios-sdk، وفتح دليل InAppMessaging.

اختيار أنواع الرسائل المطلوب تعديلها

بعد استنساخ المستودع، يمكنك تعديل أي من أنواع الرسائل التالية أو جميعها: Firebase In-App Messaging: Card وModal وBanner وImageOnly. يتوافق كل نوع مع تنسيق رسالة في عملية إنشاء حملة "Firebase In-App Messaging".

وبالتالي، يمكن لكل نوع الوصول إلى مجموعة مختلفة من البيانات، يتم تحديدها من خلال خيارات تخصيص الحملة في وحدة تحكّم Firebase:

النوع titleText bodyText textColor backgroundColor imageData actionButton secondaryActionButton
بطاقة
مودال
بانر
ImageOnly

تعديل رمز عرض الرسالة

مع مراعاة القيود المفروضة على نوع الرسالة، يمكنك تعديلها كيفما تشاء. يمكنك إنشاء بانر يظهر في أسفل تطبيقك، أو نقل زر الإجراء في نافذة مشروطة، أو تضمين الرسالة داخل التطبيق في خلاصة المستخدم، أو إجراء أي تعديل آخر من شأنه أن يجعل مظهر الرسائل وأسلوبها مناسبًا لتطبيقك.

هناك أمران رئيسيان يجب الانتباه إليهما عند تعديل طريقة عرض الرسائل:

  • أدلة أنواع الرسائل: لكل نوع رسالة دليل منفصل يحتوي على ملفات تحدّد منطق هذا النوع:
  • المخطط: تحتوي مكتبة InAppMessaging أيضًا على ملف .storyboard يساعد في تحديد واجهة المستخدم لجميع أنواع الرسائل الثلاثة:

يمكنك تعديل الملفات في أدلة أنواع الرسائل المفضّلة لديك والأقسام المقابلة في .storyboard لإنشاء عروض رسائل مخصّصة.

تعديل ملف podfile لاستخدام رمز InAppMessaging المعدَّل

لجعل Firebase In-App Messaging يستخدم طرق عرض الرسائل المعدَّلة بدلاً من طرق العرض التلقائية، عدِّل ملف podfile لاستخدام مكتبة InAppMessaging المخصّصة: 

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'YourProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!

# Pods for YourProject
pod 'Firebase'

# Remove the default InAppMessaging pod:
# pod 'Firebase/InAppMessaging'

# Overwrite it with a version that points to your local copy:
pod `FirebaseInAppMessaging', :path => '~/Path/To/The/Cloned/Repo/'

end
بعد ذلك، يمكنك تحديث مجموعاتك وإعادة إنشاء تطبيقك والاطّلاع على عروض الرسائل الجديدة والمخصّصة.

إنشاء مكتبة عرض الرسائل الخاصة بك

يمكنك استخدام مكتبة InAppMessaging لإنشاء واجهة مستخدم لعرض الرسائل، ولكن يمكنك أيضًا استخدام مكتبات أخرى. يمكنك أيضًا كتابة الرمز الخاص بك من البداية.

أنشئ فئة تنفّذ بروتوكول InAppMessagingDisplay

يستخدم Firebase In-App Messaging الفئة InAppMessaging للتعامل مع الاتصالات بين خوادم Firebase وتطبيقك. وتستخدم هذه الفئة بدورها بروتوكول InAppMessagingDisplay لعرض الرسائل التي تتلقاها. لإنشاء مكتبة عرض خاصة بك، اكتب فئة تنفّذ البروتوكول.

يتوفّر تعريف البروتوكول والمستندات حول كيفية الالتزام به في ملف FIRInAppMessagingDisplay.h ضمن مكتبة InAppMessaging.

ضبط messageDisplayComponent لاستخدام مكتبة عرض الرسائل

يستخدم InAppMessaging السمة messageDisplayComponent لتحديد العنصر الذي سيتم استخدامه عند عرض الرسائل. اضبط هذه السمة على عنصر من فئة عرض الرسائل المخصّصة، لكي يعرف "Firebase In-App Messaging" أنّه يجب استخدام مكتبتك لعرض الرسائل:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance