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


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

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

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

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

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

ברגע שלאפליקציה שלך יהיה handler של קישורים, אפשר ליצור קמפיין עם פעולה. צריך לפתוח את מסוף 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, ופותחים את הספרייה InAppMessaging.

בוחרים את סוגי ההודעות שרוצים לשנות

אחרי שכפול המאגר, תוכלו לשנות כל אחד מסוגי ההודעות של Firebase In-App Messaging או את כולם: Card, Modal, Banner ו-ImageOnly. כל סוג תואם פריסת ההודעה בתהליך יצירת הקמפיין של Firebase In-App Messaging.

בהתאם, לכל סוג יש גישה לקבוצה שונה של נתונים, בהתאם לאפשרויות ההתאמה האישית של הקמפיין במסוף Firebase:

סוג כותרתטקסט טקסט צבע טקסט backgroundColor imageData לחצן פעולה לחצן פעולה משנית
כרטיס
מודאל
באנר
ImageOnly

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

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

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

  • ספריות של סוגי הודעות: לכל סוג הודעה יש ספרייה נפרדת עם קבצים שקובעים את הלוגיקה של אותו סוג:
  • Storyboard: גם בספרייה InAppMessaging יש .storyboard שעוזר להגדיר את ממשק המשתמש לכל שלושת סוגי ההודעות:

שינוי הקבצים בסוגי ההודעות המועדפים עליכם את הספריות הרלוונטיות, ב-.storyboard כדי ליצור תצוגות של הודעות מותאמות אישית.

צריך לעדכן את קובץ ה-Podfile כדי להשתמש בקוד InAppMessaging שהשתנה

כדי לאפשר ל-Firebase In-App Messaging להשתמש בהודעה ששינית במקום בברירת המחדל מוצג, עדכן את קובץ ה-pod שלך כדי להשתמש בספריית 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
לאחר מכן תוכלו לעדכן את קבוצות ה-Pod, לבנות מחדש את האפליקציה ולראות את האפליקציות החדשות, מוצגות הודעות בהתאמה אישית.

יצירת ספרייה אישית להצגת הודעות

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

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

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

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

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

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

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance