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

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


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

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

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

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

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

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

  1. אם עדיין לא עשיתם זאת, מייבאים את מודול Firebase במבנה App או ב-UIApplicationDelegate:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. אם עדיין לא עשיתם זאת, צריך גם להגדיר מופע משותף של FirebaseApp, בדרך כלל ב-initializer של App או ב-method application(_:didFinishLaunchingWithOptions:) של delegate האפליקציה:
    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. בקטע Arguments Passed On Launch (ארגומנטים שמועברים בהפעלה), לוחצים על + Add items (הוספת פריטים).
  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, עוברים אל DevOps & Engagement >‏ Messaging.

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

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

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

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

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

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

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

  5. מזינים את מזהה ההתקנה של אפליקציית Firebase Firebase בשדה Add an installation ID (הוספת מזהה התקנה).

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

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

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

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