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

Dodaj Firebase do projektu aplikacji na Androida, jeśli nie korzystasz w nim jeszcze z tej usługi.

Dodawanie do projektu pakowanie SDK Firebase In-App Messaging

W pliku Gradle na poziomie modułu (aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle), dodaj zależność od biblioteki In-App Messaging na Androida. Do kontrolowania obsługi wersji biblioteki zalecamy używanie Firebase Android BoM.

Aby korzystać z funkcji In-App Messaging, musisz włączyć Google Analytics w projekcie w 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.13.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żywania BoM

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

Pamiętaj, że jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy używanie 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.3")
    implementation("com.google.firebase:firebase-analytics:23.2.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 w Firebase konsoli możesz określić urządzenie testowe, które będzie wyświetlać wiadomości na żądanie.

Urządzenie testowe jest określane przez identyfikator FirebaseInstallations lub FID. Aby znaleźć 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

Gdy uruchomisz aplikację na urządzeniu testowym i masz jej Firebase identyfikator instalacji (FID), możesz przetestować swoją Firebase In-App Messaging konfigurację, wysyłając wiadomość testową:

  1. W konsoli Firebase otwórz DevOps & Engagement (DevOps i zaangażowanie) > Messaging (Wysyłanie wiadomości).

  2. Uruchom proces konfigurowania nowej kampanii:

    • Jeśli jest to Twoja pierwsza kampania:

      1. Kliknij Create your first campaign (Utwórz pierwszą kampanię).
      2. Wybierz Firebase In-App messages (Wiadomości w aplikacji Firebase) i kliknij Create (Utwórz).

    • Jeśli masz już utworzone kampanie:

      1. Na karcie Campaigns (Kampanie) kliknij New campaign (Nowa kampania).
      2. Wybierz In-App Messaging (Wysyłanie wiadomości w aplikacji).

  3. Wpisz Title (Tytuł) pierwszej wiadomości.

  4. Kliknij Test on Device (Testuj na urządzeniu).

  5. W polu Add an installation ID wpisz identyfikator instalacji Firebase aplikacji Firebase.

  6. Aby wysłać wiadomość, kliknij Test (Testuj). Zostanie ona wysłana natychmiast.

  7. Aby zobaczyć wiadomość na urządzeniu testowym, musisz zamknąć, a następnie ponownie otworzyć aplikację na tym urządzeniu.

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

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