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 zu Ihrem Projekt hinzufügen

Fügen Sie in der Gradle-Datei des Moduls (auf Anwendungsebene) (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 Bibliotheksversionierung 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 zu Ihrer App hinzufügen.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.15.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.

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

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 Console können Sie daher ein Testgerät angeben, auf dem Nachrichten bei Bedarf angezeigt werden.

Dieses Testgerät wird durch eine FirebaseInstallations ID oder FID bestimmt. Die FID Ihrer Test-App finden Sie im Logcat in Android Studio im folgenden Log auf `Info`-Ebene:

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

Nachricht an Ihr Testgerät senden

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

1. Rufen Sie in der Firebase Console DevOps & Engagement > Messaging auf.

2. Starten Sie den Workflow zum Einrichten einer neuen Kampagne:

   • Wenn dies Ihre erste Kampagne ist:

     1. Klicken Sie auf Create your first campaign (Erste Kampagne erstellen).
     2. Wählen Sie Firebase In-App messages (Firebase In-App-Nachrichten) aus und klicken Sie auf Create (Erstellen).

   • Wenn Sie bereits Kampagnen erstellt haben:

     1. Klicken Sie auf dem Tab Campaigns (Kampagnen) auf New campaign (Neue Kampagne).
     2. Wählen Sie In-App Messaging aus.

3. Geben Sie einen Title (Titel) für Ihre erste Nachricht ein.

4. Klicken Sie auf Test on Device (Auf Gerät testen).

5. Geben Sie die Firebase Firebase Installations-ID Ihrer App in das Add an installation ID Feld ein.

6. Klicken Sie auf Test (Testen), um die Nachricht zu senden. Sie wird sofort gesendet.

7. Wenn Sie die Nachricht auf Ihrem Testgerät sehen möchten, müssen Sie die App auf dem Testgerät schließen und dann wieder öffnen.

Suchen Sie nach der folgenden Logmeldung, um zu prüfen, ob Ihr Gerät ein Testgerät ist:

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