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

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

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

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

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

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

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

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

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

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

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

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

وأبسط طريقة لتخصيص رسائلك هي الاعتماد على رمز عرض الرسائل التلقائي في خدمة "المراسلة داخل التطبيق من Firebase".

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

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

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

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

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

Type نص العنوان نص أساسي لون النص لون الخلفية بيانات الصورة زر الإجراء زر الإجراء الثانوي
بطاقة
مودال
بانر
صورة فقط

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

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

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

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

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

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

لتمكين ميزة المراسلة داخل التطبيق من Firebase في استخدام عروض الرسائل المعدَّلة بدلاً من طرق العرض التلقائية، يمكنك تحديث ملف 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" الفئة InAppMessaging للتعامل مع الاتصالات بين خوادم Firebase وتطبيقك. وتستخدم هذه الفئة بدورها بروتوكول InAppMessagingDisplay لعرض الرسائل التي يتلقّاها التطبيق. لإنشاء مكتبة العرض الخاصة بك، اكتب فئة تنفذ البروتوكول.

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

يُرجى ضبط "messageDisplayComponent" لاستخدام مكتبة عرض الرسائل.

تستخدم InAppMessaging السمة messageDisplayComponent لتحديد الكائن الذي سيتم استخدامه عند عرض الرسائل. اضبط هذه السمة على كائن من فئة عرض الرسائل المخصّصة حتى تعرف ميزة "المراسلة داخل التطبيق من Firebase" كيفية استخدام المكتبة لعرض الرسائل:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance