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

Bevor Sie beginnen, müssen Sie Firebase zu Ihrem Apple-Projekt hinzufügen.

Firebase In-App Messaging SDK zu Ihrem Projekt hinzufügen

Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten.

  1. Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Packages (Datei > Pakete hinzufügen).
  2. Fügen Sie bei entsprechender Aufforderung das Firebase Apple Platforms SDK-Repository hinzu:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Wählen Sie die In-App Messaging-Mediathek aus.
  4. Fügen Sie das Flag -ObjC dem Abschnitt Other Linker Flags (Andere Linker-Flags) der Build-Einstellungen Ihres Ziels hinzu.
  5. 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 in Ihre App einbinden. Sie können entweder die Bibliothek ohne IDFA-Erfassung oder mit IDFA-Erfassung auswählen. Häufig gestellte Fragen zur aktuellen Organisation von Modulen im Google Analytics für das Firebase SDK
  6. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Initialisieren Sie das SDK jetzt in Ihrer App:

  1. Importieren Sie das Firebase-Modul in Ihre App-Struktur oder UIApplicationDelegate, falls noch nicht geschehen:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Konfigurieren Sie außerdem eine gemeinsame Instanz von FirebaseApp, in der Regel im Initialisierer von App oder in der Methode application(_:didFinishLaunchingWithOptions:) des App-Delegaten, falls noch nicht geschehen:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Kompilieren Sie Ihre App und führen Sie sie aus.

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

Dieses Testgerät wird durch eine Firebase-Installations-ID bestimmt, die vom Firebase-Installationsdienst bereitgestellt wird. Wenn Sie die Installations-ID Ihrer Test-App ermitteln möchten, führen Sie die App mit dem Laufzeitbefehlsargument -FIRDebugEnabled aus:

  1. Wählen Sie in Ihrem geöffneten Xcode-Projekt in der oberen Menüleiste Product > Scheme > Edit scheme… (Produkt > Schema > Schema bearbeiten…) aus.
  2. Öffnen Sie den Tab 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 die App aus.

Wenn Ihre App ausgeführt wird, suchen Sie 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 die Einrichtung von Firebase In-App Messaging testen, indem Sie eine Testnachricht senden:

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

  2. So starten Sie den Workflow, um eine neue Kampagne einzurichten:

    • 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 Firebase 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. Damit die Nachricht auf Ihrem Testgerät angezeigt wird, müssen Sie die App auf dem Testgerät schließen und dann wieder öffnen.

So prüfen Sie, ob Ihr Gerät ein Testgerät ist: Suchen Sie nach dem folgenden Logeintrag:

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