Erste Schritte mit Firebase In-App-Messaging

In dieser Kurzanleitung erfahren Sie, wie Sie Firebase In-App Messaging einrichten und Ihre erste Nachricht senden.


Hinweis

Fügen Sie Ihrem Android-Projekt Firebase hinzu, falls noch nicht geschehen.

Firebase In-App Messaging SDK in ein Projekt einbinden

Fügen Sie in der Gradle-Datei Ihres Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) die Abhängigkeit für die In-App Messaging-Bibliothek für Android hinzu. Wir empfehlen, die Firebase Android BoM zu verwenden, um die Versionsverwaltung der Bibliothek zu steuern.

Wenn Sie In-App Messaging verwenden möchten, müssen Sie Google Analytics in Ihrem Firebase-Projekt aktivieren und das Firebase SDK für Google Analytics in Ihre App einfügen. 

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

Mit der Firebase Android BoM haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.

(Alternative)  Firebase-Bibliotheksabhängigkeiten ohne Verwendung von BoM hinzufügen

Wenn Sie die Firebase BoM nicht verwenden möchten, müssen Sie jede Firebase-Bibliotheksversion in der entsprechenden Abhängigkeitszeile angeben.

Wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, empfehlen wir dringend, die BoM zum Verwalten von Bibliotheksversionen zu verwenden, um sicherzustellen, dass alle Versionen kompatibel sind. 

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

Testnachricht senden

Installations-ID Ihrer App abrufen

Um Strom zu sparen, ruft Firebase In-App Messaging Nachrichten nur einmal pro Tag vom Server ab. Das kann das Testen erschweren. In der Firebase-Konsole können Sie daher ein Testgerät angeben, auf dem Nachrichten bei Bedarf angezeigt werden.

Das Testgerät wird durch eine FirebaseInstallations-ID oder FID bestimmt. Die FID Ihrer Test-App finden Sie im Logcat in Android Studio. Suchen Sie dort nach dem folgenden Log auf der Ebene „Info“:

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

Nachricht an Testgerät senden

Nachdem Sie Ihre App auf dem Testgerät gestartet und die Firebase-Installations-ID (FID) des Geräts ermittelt haben, können Sie Ihre Firebase In-App Messaging-Einrichtung testen, indem Sie eine Testnachricht senden:

  1. Öffnen Sie in der Firebase Console die Seite „Messaging“.
  2. Wenn dies Ihre erste Kampagne ist, klicken Sie auf Erste Kampagne erstellen.
    1. Wählen Sie Firebase In-App Messages aus und klicken Sie auf Erstellen.
  3. Klicken Sie andernfalls auf dem Tab Kampagnen auf Neue Kampagne.
    1. Wählen Sie In-App Messaging aus.
  4. Geben Sie einen Titel für Ihre erste Nachricht ein.
  5. Klicken Sie auf Auf Gerät testen.
  6. Geben Sie die Firebase-Installations-ID Ihrer App in das Feld Installations-ID hinzufügen ein.
  7. Klicken Sie auf Testen, um die Nachricht zu senden.

Firebase In-App Messaging sendet Ihre Testnachricht, sobald Sie auf Testen klicken. Damit die Nachricht angezeigt wird, müssen Sie die App auf Ihrem Testgerät schließen und dann wieder öffnen.

So prüfen Sie, ob Ihr Gerät ein Testgerät ist:

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