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

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

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

אם עדיין לא עשיתם זאת, התקינו והפעילו את ערכות ה-SDK של Firebase ל-Flutter.

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

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

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

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

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

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

1. במסוף Firebase, נכנסים לקטע DevOps & Engagement (DevOps ומעורבות) > Messaging (העברת הודעות).

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

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

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

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

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

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

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

5. בשדה הוספת מזהה התקנה, מזינים את מזהה ההתקנה של האפליקציה ב-Firebase.

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.