תחילת העבודה עם העברת הודעות בתוך האפליקציה ב-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 או בשיטה 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 (ארגומנטים שמועברים בהפעלה).
  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.