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

Installieren und initialisieren Sie die Firebase SDKs für Flutter, falls noch nicht geschehen.

Firebase In-App Messaging SDK zum Projekt hinzufügen

  1. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Firebase In-App Messaging-Plug-in zu installieren:

    flutter pub add firebase_in_app_messaging

  2. Erstellen Sie Ihr Projekt neu:

    flutter run

  3. Importieren Sie das Firebase In-App Messaging-Plug-in:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';

Testnachricht senden

Installations-ID Ihrer App abrufen

Um den Akku zu schonen, 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.

Das Testgerät wird durch eine Geräte-ID bestimmt. Die FID Ihrer Test-App finden Sie in der Konsolenausgabe, wenn Sie Ihre App ausführen.

Auf Android-Geräten sieht die Meldung so aus:

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

Führen Sie die App unter iOS mit dem Laufzeitbefehlsargument -FIRDebugEnabled aus:

  1. Wählen Sie bei geöffnetem Xcode-Projekt in der oberen Menüleiste Produkt > Schema > Schema bearbeiten… aus.
  2. Öffnen Sie den Tab Arguments (Argumente) des angezeigten Dialogfelds.
  3. Klicken Sie unter Beim Start übergebene Argumente auf + Elemente hinzufügen.
  4. Geben Sie „-FIRDebugEnabled“ in das neu erstellte Feld ein.
  5. Klicken Sie auf Schließen und führen Sie dann Ihre App aus.

Sobald Ihre App ausgeführt wird, suchen Sie in den Protokollen der Xcode-Konsole nach der folgenden Zeile:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

Nachricht an 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. Öffnen Sie in der Firebase-Konsole Messaging (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 Ihrem 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: Suchen Sie nach einer der folgenden Log-Meldungen.

Android

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

iOS

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.