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

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

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

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

הוספת עיצוב הודעות בתוך האפליקציה בעזרת Firebase SDK לפרויקט

1. מתיקיית השורש של פרויקט Flutter, מריצים את הפקודה הבאה כדי להתקין את הפלאגין עיצוב הודעות בתוך האפליקציה בעזרת Firebase:

   flutter pub add firebase_in_app_messaging
   

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

   flutter run
   

3. מייבאים את הפלאגין עיצוב הודעות בתוך האפליקציה בעזרת Firebase:

   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 (ארגומנטים שמועברים בהפעלה), לוחצים על + Add items (הוספת פריטים).
4. מזינים את הערך ‎-FIRDebugEnabled בשדה החדש שנוצר.
5. לוחצים על סגירה ומפעילים את האפליקציה.

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

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

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

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

1. במסוף Firebase, עוברים אל DevOps & Engagement >‏ Messaging.

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

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

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

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

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

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

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

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

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

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

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

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.