تخصيص رسائل "المراسلة داخل التطبيق" من 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:

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

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

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

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

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