תחילת העבודה עם העברת הודעות בתוך האפליקציה ב-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:33.7.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:21.0.1")
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}

מחפשים מודול ספרייה ספציפי ל-Kotlin? החל מ-אוקטובר 2023 (Firebase BoM 32.5.0), מפתחי Kotlin ומפתחי Java יוכלו להסתמך על מודול הספרייה הראשי (פרטים נוספים זמינים בשאלות הנפוצות לגבי היוזמה הזו).

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

אחזור מזהה ההטמעה של האפליקציה

כדי לחסוך באנרגיה, 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, פותחים את הדף Messaging.
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