Pierwsze kroki z wysyłaniem wiadomości w aplikacji za pomocą Firebase

Z tego krótkiego przewodnika dowiesz się, jak skonfigurować Firebase In-App Messaging i wysłać pierwszą wiadomość.


Zanim zaczniesz

Jeśli jeszcze tego nie zrobiono, dodaj Firebase do projektu na Androida.

Dodawanie pakietu Firebase In-App Messaging SDK do projektu

W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle) dodaj zależność z biblioteką In-App Messaging na Androida. Zalecamy używanie Firebase Android BoM do kontrolowania wersji biblioteki.

Aby korzystać z In-App Messaging, musisz włączyć Google Analytics w projekcie Firebase i dodać do aplikacji pakiet SDK Firebase dla 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")
}

Gdy korzystamy z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

(Alternatywnie)  Dodaj zależności biblioteki Firebase bez użycia BoM

Jeśli nie chcesz używać Firebase BoM, musisz określić każdą wersję biblioteki Firebase w wierszu zależności.

Pamiętaj, że jeśli w aplikacji używasz wielu bibliotek Firebase, zdecydowanie zalecamy korzystanie z BoM do zarządzania wersjami bibliotek, co zapewnia zgodność wszystkich wersji. 

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")
}

Wysyłanie wiadomości testowej

Pobieranie identyfikatora instalacji aplikacji

Aby oszczędzać energię, Firebase In-App Messaging pobiera wiadomości z serwera tylko raz dziennie. Może to utrudniać testowanie, dlatego Firebasekonsola umożliwia określenie urządzenia testowego, które wyświetla wiadomości na żądanie.

Urządzenie testowe jest określane przez identyfikator FirebaseInstallations lub FID. Aby znaleźć identyfikator FID aplikacji testowej, sprawdź Logcat w Android Studio pod kątem tego logu na poziomie „Info”:

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

Wysyłanie wiadomości na urządzenie testowe

Po uruchomieniu aplikacji na urządzeniu testowym i uzyskaniu identyfikatora instalacji (FID) możesz przetestować konfigurację, wysyłając wiadomość testową:FirebaseFirebase In-App Messaging

  1. W konsoli Firebase otwórz stronę Messaging.
  2. Jeśli jest to Twoja pierwsza kampania, kliknij Utwórz pierwszą kampanię.
    1. Wybierz Wiadomości w aplikacji Firebase i kliknij Utwórz.
  3. W przeciwnym razie na karcie Kampanie kliknij Nowa kampania.
    1. Wybierz Wiadomości w aplikacji.
  4. Wpisz tytuł pierwszej wiadomości.
  5. Kliknij Testuj na urządzeniu.
  6. W polu Dodaj identyfikator instalacji wpisz Firebase identyfikator instalacji aplikacji.
  7. Aby wysłać wiadomość, kliknij Testuj.

Firebase In-App Messaging wyśle wiadomość testową, gdy tylko klikniesz Przetestuj. Aby zobaczyć wiadomość, musisz zamknąć, a następnie ponownie otworzyć aplikację na urządzeniu testowym.

Aby sprawdzić, czy urządzenie jest urządzeniem testowym, poszukaj tego komunikatu w logu:

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