התאמה אישית של הודעות בתוך האפליקציה ב-Firebase


הכלי "עיצוב הודעות בתוך האפליקציה בעזרת Firebase" מספק קבוצה שימושית של התנהגויות וסוגי הודעות שהוגדרו מראש עם מראה ותחושה שמוגדרים כברירת מחדל, אבל במקרים מסוימים יכול להיות שתרצו להרחיב את ההתנהגויות ואת תוכן ההודעות. התכונה "העברת הודעות באפליקציה" מאפשרת להוסיף פעולות להודעות ולהתאים אישית את המראה והסגנון של ההודעות.

הוספת פעולה להודעה

אתם יכולים להשתמש בפעולות כדי להפנות את המשתמשים מההודעות באפליקציה לאתר או למסך ספציפי באפליקציה.

‫Firebase In-App Messaging משתמש ב-link handlers כדי לעבד פעולות. ערכת ה-SDK יכולה להשתמש בכמה פונקציות טיפול, כך שאם באפליקציה כבר יש פונקציה כזו, Firebase In-App Messaging יכול להשתמש בה בלי הגדרה נוספת. אם עדיין אין לכם handler, אתם יכולים להשתמש ב-Firebase Dynamic Links. מידע נוסף זמין במאמר יצירת קישורים דינמיים ב-iOS.

מוסיפים את הפעולה להודעה באמצעות מסוף Firebase

אחרי שמוסיפים לאפליקציה handler של קישורים, אפשר ליצור קמפיין עם פעולה.

  1. במסוף Firebase, נכנסים לקטע DevOps & Engagement (DevOps ומעורבות) > Messaging (העברת הודעות).

  2. מפעילים את תהליך העבודה כדי להגדיר קמפיין חדש:

    • אם זה הקמפיין הראשון שלכם:

      1. לוחצים על יצירת הקמפיין הראשון.
      2. בוחרים באפשרות עיצוב הודעות בתוך האפליקציה בעזרת Firebase ולוחצים על יצירה.

    • אם כבר יצרתם קמפיינים בעבר:

      1. בכרטיסייה קמפיינים, לוחצים על קמפיין חדש.
      2. בוחרים באפשרות העברת הודעות בתוך האפליקציה.

  3. פועלים לפי ההוראות במסך כדי להגדיר את הקמפיין.

  4. מזינים כרטיס, טקסט של לחצן ופעולה של לחצן, פעולה של תמונה או פעולה של באנר, כשהפעולה היא קישור עומק רלוונטי.

הפורמט של הפעולה תלוי בפריסת ההודעה שבחרתם. במודאלים יש כפתורי פעולה עם תוכן טקסט, צבע טקסט וצבע רקע שניתנים להתאמה אישית. לעומת זאת, תמונות ובאנרים עליונים הופכים לאינטראקטיביים ומפעילים את הפעולה שצוינה כשמקישים עליהם.

שינוי העיצוב והסגנון של ההודעה

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 backgroundColor imageData actionButton secondaryActionButton
כרטיס
חלון עזר
באנר
ImageOnly

שינוי קוד העיבוד של תצוגת ההודעה

בהתאם למגבלות של סוגי ההודעות, אתם יכולים לשנות אותן איך שתרצו. אתם יכולים ליצור באנר שמוצג בתחתית האפליקציה, להזיז את כפתור הפעולה במודל, להטמיע את ההודעה באפליקציה בפיד של המשתמש או לבצע כל שינוי אחר שיתאים את המראה והתחושה של ההודעות לאפליקציה שלכם.

יש שני דברים עיקריים שצריך לשים לב אליהם כשמשנים את תצוגת ההודעות:

  • ספריות של סוגי הודעות: לכל סוג הודעה יש ספרייה נפרדת עם קבצים שקובעים את הלוגיקה של אותו סוג:
  • לוח תסריט: הספרייה 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
אחרי שתעשו את זה, תוכלו לעדכן את ה-pods, לבנות מחדש את האפליקציה ולראות את התצוגות החדשות והמותאמות אישית של ההודעות.

יצירת ספרייה משלכם להצגת הודעות

אתם לא מוגבלים לעבודה עם הספרייה InAppMessaging כדי ליצור ממשק משתמש להצגת הודעות. אתם יכולים גם לכתוב קוד משלכם מאפס.

יוצרים מחלקה שמטמיעה את הפרוטוקול InAppMessagingDisplay

Firebase In-App Messaging משתמש במחלקה InAppMessaging כדי לטפל בתקשורת בין שרתי Firebase לבין האפליקציה. המחלקה הזו משתמשת בפרוטוקול InAppMessagingDisplay כדי להציג את ההודעות שהיא מקבלת. כדי ליצור ספריית תצוגה משלכם, אתם צריכים לכתוב מחלקה שמטמיעה את הפרוטוקול.

הגדרת הפרוטוקול והמסמכים שמסבירים איך לפעול לפיו נמצאים בקובץ FIRInAppMessagingDisplay.h של הספרייה InAppMessaging.

הגדרת messageDisplayComponent לשימוש בספריית התצוגה של ההודעות

המאפיין messageDisplayComponent של InAppMessaging קובע באיזה אובייקט להשתמש כשמוצגות הודעות. מגדירים את המאפיין הזה לאובייקט של המחלקה המותאמת אישית להצגת הודעות, כדי ש-Firebase In-App Messaging יידע להשתמש בספרייה שלכם לעיבוד הודעות:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance