تخصيص رسائل Firebase داخل التطبيق الخاصة بك

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

أضف عملاً إلى رسالتك

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

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

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

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

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

تعديل شكل الرسالة وأسلوبها

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

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

تعديل شاشات العرض الافتراضية

تتمثل أسهل طريقة لتخصيص رسائلك في إنشاء رمز عرض الرسائل الافتراضي لـ Firebase In-App Messaging.

استنساخ firebase-ios-sdk repo

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

حدد أنواع الرسائل لتعديلها

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

وفقًا لذلك ، يتمتع كل نوع بإمكانية الوصول إلى مجموعة مختلفة من البيانات ، يتم تحديدها بواسطة خيارات تخصيص الحملة في وحدة تحكم Firebase:

يكتب العنوان نص الجسم لون الخط لون الخلفية بيانات الصورة زر التشغيل زر عمل ثانوي
بطاقة
مشروط
لافتة
صورة فقط

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

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

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

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