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

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

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

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

تستخدم خدمة 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 repo، وافتح دليل InAppMessaging .

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

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

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

يكتب titleText bodyText لون الخط لون الخلفية بيانات الصورة زر التشغيل SecondActionButton
بطاقة
مشروط
راية
ImageOnly

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

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

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

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