تخصيص رسائل "المراسلة داخل التطبيق" من 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 زر الإجراء زر الإجراء الثانوي
بطاقة
نافذة منبثقة
بانر
صورة فقط

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

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

هناك شيئان رئيسيان يجب الانتباه إليهما عند تعديل عروض الرسائل:

  • أدلة أنواع الرسائل: لكل نوع رسالة دليل منفصل. مع الملفات التي تحدد منطق هذا النوع:
  • مخطط القصة: تتضمّن مكتبة 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