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

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


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

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

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

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

  1. ב-Xcode, כשהפרויקט של האפליקציה פתוח, עוברים אל File > Add Packages (קובץ > הוספת חבילות).
  2. כשמוצגת בקשה, מוסיפים את מאגר ה-SDK של Firebase לפלטפורמות של אפל:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. בוחרים את הספרייה In-App Messaging.
  4. מוסיפים את הדגל -ObjC לקטע Other Linker Flags (דגלים אחרים של מקשרים) בהגדרות ה-build של היעד.
  5. כדי להשתמש ב-In-App Messaging, צריך להפעיל את Google Analytics בפרויקט ב-Firebase ולהוסיף לאפליקציה את Firebase SDK for Google Analytics. אפשר לבחור בספרייה עם איסוף IDFA או בספרייה בלי איסוף IDFA. שאלות נפוצות על הארגון העדכני של המודולים ב-Google Analytics for Firebase SDK
  6. אחרי שתסיימו, פלטפורמת Xcode תתחיל לטפל ביחסי התלות ולהוריד אותם באופן אוטומטי ברקע.

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

  1. אם עדיין לא עשיתם את זה, מייבאים את המודול של Firebase ב-struct של App או ב-UIApplicationDelegate:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. אם עדיין לא עשיתם את זה, צריך גם להגדיר מופע משותף של FirebaseApp, בדרך כלל במאתחל של App או ב-method‏ application(_:didFinishLaunchingWithOptions:) של נציג האפליקציה:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. מריצים את האפליקציה.

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

איך מקבלים את מזהה ההתקנה של האפליקציה

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

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

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

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

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

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

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

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

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

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

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

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

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

  3. מזינים כותרת להודעה הראשונה.

  4. לוחצים על בדיקה במכשיר.

  5. בשדה הוספת מזהה התקנה, מזינים את מזהה ההתקנה של Firebase Firebase באפליקציה.

  6. לוחצים על בדיקה כדי לשלוח את ההודעה. ההודעה תישלח מיד.

  7. כדי לראות את ההודעה במכשיר הבדיקה, צריך לסגור את האפליקציה במכשיר הבדיקה ולפתוח אותה מחדש.

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

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