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


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

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

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

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

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

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

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

تعديل شكل الرسالة ومضمونها

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 لون الخلفية 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