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

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

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

אם עדיין לא הוספתם את Firebase לפרויקט Android, אתם צריכים להוסיף אותו.

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

בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle), מוסיפים את התלות בספריית In-App Messaging ל-Android. מומלץ להשתמש ב-Firebase Android BoM כדי לשלוט בניהול גרסאות של הספרייה.

כדי להשתמש ב-In-App Messaging, צריך להפעיל את Google Analytics בפרויקט ב-Firebase ולהוסיף לאפליקציה את Firebase SDK for Google Analytics.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:35.0.1"))

    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display")
    implementation("com.google.firebase:firebase-analytics")
}

כשמשתמשים ב-Firebase Android BoM, האפליקציה תמיד משתמשת בגרסאות תואמות של ספריות Firebase ל-Android.

(אפשרות חלופית)  מוסיפים תלות של הפרויקט בספריות של Firebase בלי להשתמש ב-BoM

אם אתם בוחרים לא להשתמש ב-Firebase BoM, אתם צריכים לציין כל גרסה של ספריית Firebase בשורת התלות שלה.

שימו לב: אם אתם משתמשים בכמה ספריות של Firebase באפליקציה, מומלץ מאוד להשתמש ב-BoM כדי לנהל את גרסאות הספרייה, וכך לוודא שכל הגרסאות תואמות.

dependencies {
    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display:23.0.0")
    implementation("com.google.firebase:firebase-analytics:24.0.0")
}

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

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

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

מכשיר הבדיקה מזוהה באמצעות מזהה FirebaseInstallations, או FID. כדי למצוא את מזהה ה-FID של אפליקציית הבדיקה, בודקים ב-Logcat ב-Android Studio את היומן הבא ברמת `Info`:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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