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 Sie dies noch nicht getan haben.

Firebase In-App-Messaging SDK zu Ihrem 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 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 FID bestimmt. Die FID Ihrer Test-App finden Sie in der Konsolenausgabe, wenn Sie die App ausführen.

Unter Android sieht die Nachricht 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 in der Menüleiste oben in Ihrem Xcode-Projekt Product > Scheme > Edit scheme... (Produkt > Schema > Schema bearbeiten…) aus.
  2. Öffnen Sie den Tab Arguments (Argumente) des angezeigten Dialogfelds.
  3. Klicken Sie unter Arguments Passed On Launch (Argumente, die beim Start übergeben werden) auf + Add items (Elemente hinzufügen).
  4. Geben Sie im neu erstellten Feld „-FIRDebugEnabled“ ein.
  5. Klicken Sie auf Close (Schließen) und führen Sie dann Ihre App aus.

Suchen Sie nach dem Start der App in den Logs der Xcode-Konsole nach der folgenden Zeile:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase 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 Erste Kampagne erstellen.
      2. Wählen Sie Firebase In-App-Nachrichten aus und klicken Sie auf Erstellen.

    • Wenn Sie bereits Kampagnen erstellt haben:

      1. Klicken Sie auf dem Tab Kampagnen auf Neue Kampagne.
      2. Wählen Sie In-App-Messaging aus.

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

  4. Klicken Sie auf Auf Gerät testen.

  5. Geben Sie die Firebase-Installations-ID Ihrer App in das Feld Installations-ID hinzufügen ein.

  6. Klicken Sie auf 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 einer der folgenden Logmeldungen, um zu prüfen, ob Ihr Gerät ein Testgerät ist.

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.