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

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


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

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

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

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

  1. ב-Xcode, כשפרויקט האפליקציה פתוח, עוברים אל File > Add Packages (קובץ > הוספת חבילות).
  2. כשמופיעה בקשה, מוסיפים את מאגר ה-SDK של מוצרי הפלטפורמה של Firebase של Apple:
    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.
  6. בסיום, Xcode יתחיל לפתור את יחסי התלות ולהוריד אותם באופן אוטומטי ברקע.

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

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