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

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

iOS+ Android Flutter

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

לפני שמתחילים, צריך לוודא שמוסיפים את Firebase לפרויקט ב-Apple.

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

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

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

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

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

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

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

1. מייבאים את מודול Firebase ב-struct‏ 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. לוחצים על + הוספת פריטים בקטע ארגומנטים שהועברו בהפעלה.
4. מזינים "-FIRDebugEnabled" בשדה החדש שנוצר.
5. לוחצים על סגירה ומפעילים את האפליקציה.

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

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

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

אחרי שמפעילים את האפליקציה במכשיר הבדיקה, מזהה ההתקנה של Firebase (FID), אפשר לנסות את 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.