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-Plug-in für In-App-Messaging 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 Energie zu sparen, ruft Firebase In-App-Messaging Nachrichten nur einmal pro Tag vom Server ab. Das kann die Tests erschweren. In der Firebase Console können Sie daher ein Testgerät angeben, auf dem Nachrichten auf Anfrage angezeigt werden.

Dieses Testgerät wird durch eine FID bestimmt. Sie finden die FID Ihrer Test-App in der Konsolenausgabe, wenn Sie die App ausführen.

Unter Android 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 Befehlsargument „-FIRDebugEnabled“ aus:

  1. Wählen Sie in Xcode in der oberen Menüleiste Produkt > Schema > Schema bearbeiten… aus.
  2. Öffnen Sie im angezeigten Dialogfeld den Tab Arguments (Argumente).
  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 die App aus.

Sobald die 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 und die Firebase-Installations-ID (FID) erhalten haben, können Sie die Einrichtung von Firebase In-App Messaging testen, indem Sie eine Testnachricht senden:

  1. Öffnen Sie Messaging in der Firebase-Konsole.
  2. Falls dies Ihre erste Kampagne ist, klicken Sie auf Erste Kampagne erstellen.
    1. Wählen Sie Firebase In-App-Nachrichten aus und klicken Sie auf Erstellen.
  3. Andernfalls klicken Sie auf dem Tab Kampagnen auf Neue Kampagne.
    1. Wählen Sie In-App-Messaging aus.
  4. Geben Sie einen Titel für die erste Nachricht ein.
  5. Klicken Sie auf Auf dem 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.

Mit Firebase In-App-Nachrichten wird Ihre Testnachricht gesendet, sobald Sie auf Testen klicken. Wenn Sie die Meldung sehen möchten, müssen Sie die App auf Ihrem Testgerät schließen und dann wieder öffnen.

Ob Ihr Gerät ein Testgerät ist, erkennen Sie an einer der folgenden Protokollmeldungen.

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.