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


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

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

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

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

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

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

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

  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's رمز شاشة عرض الرسائل التلقائي.

استنساخ مستودع 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