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

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


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

אם עוד לא עשיתם זאת, מתקינים ומפעילים את Firebase SDKs for Flutter.

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

  1. מריצים את הפקודה הבאה מתיקיית הבסיס של פרויקט Flutter כדי להתקין את הפלאגין Firebase In-App Messaging:

    flutter pub add firebase_in_app_messaging

  2. בונים מחדש את הפרויקט:

    flutter run

  3. מייבאים את הפלאגין Firebase In-App Messaging:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';

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

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

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

מזהה המכשיר לבדיקה נקבע לפי מזהה FID. כדי למצוא את ה-FID של אפליקציית הבדיקה, בודקים את הפלט של המסוף כשמריצים את האפליקציה.

ב-Android, ההודעה נראית כך:

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

ב-iOS, מריצים את האפליקציה עם ארגומנט הפקודה של זמן הריצה -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

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

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

  1. במסוף Firebase, פותחים את העברת הודעות.
  2. אם זה הקמפיין הראשון שלכם, לוחצים על יצירת הקמפיין הראשון.
    1. בוחרים באפשרות הודעות בתוך האפליקציה של Firebase ולוחצים על יצירה.
  3. אחרת, בכרטיסייה קמפיינים, לוחצים על קמפיין חדש.
    1. בוחרים באפשרות הודעות בתוך האפליקציה.
  4. מזינים שם להודעה הראשונה.
  5. לוחצים על בדיקה במכשיר.
  6. מזינים את מזהה ההתקנה של האפליקציה ב-Firebase בשדה Add an installation ID (הוספת מזהה התקנה).
  7. לוחצים על בדיקה כדי לשלוח את ההודעה.

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

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

Android

I/FIAM.Headless: Setting this device as a test device

iOS

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