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


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

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

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

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

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

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

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

  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