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 SDK Firebase In-App Messaging 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 używać 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: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") }
Gdy korzystasz z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.
(Alternatywnie) Dodaj zależności biblioteki Firebase bez używania pakietu BoM
Jeśli zdecydujesz się nie używać Firebase BoM, musisz określić każdą wersję biblioteki Firebase w jej wierszu zależności.
Jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy korzystanie z BoM do zarządzania wersjami bibliotek. Dzięki temu wszystkie wersje będą ze sobą zgodne.
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") }
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 konsola Firebase 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 identyfikator FID.
Aby znaleźć FID aplikacji testowej, sprawdź w Android Studio w Logcat następujący log 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 Firebase (FID) możesz przetestować konfigurację Firebase In-App Messaging, wysyłając wiadomość testową:
- W konsoli Firebase otwórz stronę Wiadomości.
- Jeśli jest to Twoja pierwsza kampania, kliknij Utwórz pierwszą kampanię.
- Kliknij Wiadomości w aplikacji Firebase i Utwórz.
- Jeśli nie, na karcie Kampanie kliknij Nowa kampania.
- Wybierz Wiadomości w aplikacji.
- Wpisz tytuł pierwszej wiadomości.
- Kliknij Testuj na urządzeniu.
- W polu Dodaj identyfikator instalacji wpisz identyfikator instalacji Firebase aplikacji.
- Aby wysłać wiadomość, kliknij Test.
Firebase In-App Messaging wysyła wiadomość testową, gdy tylko klikniesz Test. Aby zobaczyć tę wiadomość, zamknij aplikację i otwórz ją ponownie na urządzeniu testowym.
Aby sprawdzić, czy urządzenie jest urządzeniem testowym, poszukaj tego komunikatu w logach:
I/FIAM.Headless: Setting this device as a test device