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

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


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

אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט Android.

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

בקובץ 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:34.0.0"))

    // 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:22.0.0")
    implementation("com.google.firebase:firebase-analytics:23.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

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

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

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

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

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

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