תחילת העבודה עם העברת הודעות בתוך האפליקציה ב-Firebase

במדריך למתחילים הזה נסביר איך מגדירים את Firebase In-App Messaging ושולחים את ההודעה הראשונה.

iOS+ Android Flutter

לפני שמתחילים

לפני שמתחילים, חשוב להוסיף את Firebase לפרויקט שלכם ב-Apple.

הוספת ה-SDK של Firebase In-App Messaging לפרויקט

שימוש ב-Swift Package Manager כדי להתקין ולנהל יחסי תלות ב-Firebase.

במדריך ההתקנה מוסבר על הדרכים השונות להוספת ערכות SDK של Firebase לפרויקט שלכם ב-Apple, כולל ייבוא של מסגרות ישירות ושימוש ב-CocoaPods.

1. ב-Xcode, כשפרויקט האפליקציה פתוח, עוברים אל File > (קובץ >) הוספת חבילות.
2. כשמופיעה בקשה, מוסיפים את מאגר ה-SDK של מוצרי הפלטפורמה של Firebase של Apple:

  https://github.com/firebase/firebase-ios-sdk.git

הערה: בפרויקטים חדשים צריך להשתמש בגרסת ה-SDK שמוגדרת כברירת מחדל (העדכנית), אבל אפשר בוחרים גרסה ישנה יותר אם יש צורך.
3. בוחרים את הספרייה In-App Messaging.
4. מוסיפים את הדגל -ObjC לקטע סימונים של מקשר אחר בהגדרות ה-build של היעד.
5. כדי להשתמש ב-In-App Messaging, צריך הפעלת Google Analytics בפרויקט Firebase ולהוסיף את Firebase SDK for Google Analytics לאפליקציה. אפשר לבחור הספרייה ללא איסוף IDFA או עם איסוף IDFA.
6. בסיום, Xcode יתחיל לפתור את הבעיה ותוריד את של יחסי התלות ברקע.

עכשיו מפעילים את ה-SDK באפליקציה:

1. מייבאים את מודול Firebase במבנה App או UIApplicationDelegate, אם עדיין לא עשית זאת:

   Swift

   import Firebase

   Objective-C

   @import Firebase;

2. צריך להגדיר גם FirebaseApp משותף, בדרך כלל באתחול של App או ב שיטת application(_:didFinishLaunchingWithOptions:), אם עדיין לא עשיתם זאת:

   Swift

   FirebaseApp.configure()

   Objective-C

   [FIRApp configure];

3. הידור והפעלה של האפליקציה.

הערה: כדי להשתמש ב-Firebase In-App Messaging נדרשת גרסת Firebase 5.6.0 ואילך. אם המיקום נתקלת בבעיה בהידור האפליקציה, כדאי לנסות להריץ את pod update באפליקציה של פרויקט. עם זאת, חשוב לזכור שהפקודה מעדכנת את כל יחסי התלות של האפליקציה, ולא רק את אלה של Firebase.

שליחת הודעת בדיקה

אחזור מזהה ההתקנה של האפליקציה

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

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

1. כשפרויקט Xcode פתוח, בוחרים באפשרות Product > Scheme > Edit scheme… בסרגל התפריטים העליון.
2. פותחים את הכרטיסייה ארגומנטים בתיבת הדו-שיח שקופצת.
3. לוחצים על + הוספת פריטים בקטע Arguments Passed On Launch.
4. מזינים "-FIRDebugEnabled" בשדה החדש שנוצר.
5. לוחצים על סגירה ומפעילים את האפליקציה.

אחרי שהאפליקציה תתחיל לפעול, צריך לחפש את השורה הבאה ביומנים של מסוף Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

שליחת הודעה למכשיר הבדיקה

אחרי שמפעילים את האפליקציה במכשיר הבדיקה ומקבלים את מזהה ההתקנה (FID) של Firebase, אפשר לבדוק את ההגדרה של Firebase In-App Messaging על ידי שליחת הודעת בדיקה:

1. במסוף Firebase, פותחים את הדף 'העברת הודעות'.
2. אם זה הקמפיין הראשון שלכם, לוחצים על יצירת הקמפיין הראשון.
   1. בוחרים באפשרות הודעות בתוך האפליקציה של Firebase ולוחצים על יצירה.
3. אחרת, בכרטיסייה קמפיינים, לוחצים על קמפיין חדש.
   1. בוחרים באפשרות הודעות בתוך האפליקציה.
4. מזינים כותרת להודעה הראשונה.
5. לוחצים על בדיקה במכשיר.
6. מזינים את מזהה ההתקנה Firebase של האפליקציה בשדה Add an installation ID.
7. לוחצים על בדיקה כדי לשלוח את ההודעה.

Firebase In-App Messaging שולח את הודעת הבדיקה ברגע שלוחצים על בדיקה. כדי לראות את צריך לסגור את האפליקציה ולפתוח אותה מחדש במכשיר הבדיקה.

כדי לוודא שהמכשיר הוא מכשיר בדיקה, מחפשים את הודעת היומן הבאה:

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.