Beginnen Sie mit Firebase In-App Messaging

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

Bevor Sie beginnen

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

Fügen Sie das Firebase In-App Messaging SDK zu Ihrem Projekt hinzu

  1. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Firebase In-App Messaging-Plugin 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-Plugin:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';

Senden Sie eine Testnachricht

Rufen Sie die Installations-ID Ihrer App ab

Um Strom zu sparen, ruft Firebase In-App Messaging Nachrichten nur einmal pro Tag vom Server ab. Dies kann das Testen erschweren. Daher können Sie in der Firebase-Konsole ein Testgerät angeben, das Nachrichten bei Bedarf anzeigt.

Dieses Prüfgerät wird durch einen FID bestimmt. Finden Sie die FID Ihrer Test-App, indem Sie die Konsolenausgabe überprüfen, wenn Sie Ihre App ausführen.

Auf Android sieht die Meldung wie folgt aus:

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

Führen Sie unter iOS die App 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 die Registerkarte „Argumente“ des daraufhin 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

Senden Sie eine Nachricht an Ihr Testgerät

Sobald Sie Ihre App auf dem Testgerät gestartet haben und die Firebase-Installations-ID (FID) haben, können Sie Ihr Firebase-In-App-Messaging-Setup ausprobieren, indem Sie eine Testnachricht senden:

  1. Öffnen Sie in der Firebase-Konsole Messaging .
  2. Wenn dies Ihre erste Kampagne ist, klicken Sie auf Ihre erste Kampagne erstellen .
    1. Wählen Sie Firebase In-App-Nachrichten aus und klicken Sie auf Erstellen .
  3. Andernfalls klicken Sie auf der Registerkarte 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 „Testen“ auf Ihrem Gerät
  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 Test klicken. Um die Meldung anzuzeigen, müssen Sie die App auf Ihrem Testgerät schließen und dann erneut öffnen.

Um zu bestätigen, ob es sich bei Ihrem Gerät um ein Testgerät handelt, suchen Sie nach 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.