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

Fügen Sie Ihrem Apple-Projekt Firebase hinzu, bevor Sie beginnen.

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

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-Bibliothek aus.
  4. Fügen Sie das Flag -ObjC dem Bereich Other Linker Flags der Build-Einstellungen des Ziels hinzu.
  5. Wenn Sie In-App Messaging verwenden möchten, müssen Sie Google Analytics in Ihrem Firebase-Projekt aktivieren und Ihrer App das Firebase SDK für Google Analytics hinzufügen. Sie können entweder die Bibliothek ohne oder mit IDFA-Erfassung auswählen.
  6. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Initialisieren Sie nun das SDK in Ihrer App:

  1. Importiere das Firebase-Modul in deine App- oder UIApplicationDelegate-Struktur, falls noch nicht geschehen:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Konfigurieren Sie außerdem eine freigegebene Instanz von FirebaseApp, normalerweise in der Initialisierermethode von App oder in der application(_:didFinishLaunchingWithOptions:)-Methode des App-Delegierten, falls Sie das noch nicht getan haben:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Kompilieren Sie Ihre App und führen Sie sie aus.

Testnachricht senden

Installations-ID Ihrer App ermitteln

Um Strom zu sparen, ruft Firebase In-App Messaging nur Nachrichten aus dem -Server einmal pro Tag. Das kann das Testen erschweren, In der Firebase-Konsole können Sie ein Testgerät angeben, das Nachrichten anzeigt on demand.

Dieses Testgerät wird anhand einer Firebase-Installations-ID bestimmt, die vom Firebase-Installationsdienst bereitgestellt wird. Um die Installations-ID Ihrer Test-App zu ermitteln, führen Sie die App mit dem Befehlsargument „-FIRDebugEnabled“ aus:

  1. Wählen Sie bei geöffnetem Xcode-Projekt Product > Schema > Schema bearbeiten... von in der oberen Menüleiste.
  2. Öffnen Sie im angezeigten Dialogfeld den Tab 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.

Wenn Ihre Anwendung 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 Firebase In-App Messaging-Einrichtung testen, indem Sie eine Testnachricht senden:

  1. Öffnen Sie in der Firebase-Konsole die Seite Messaging.
  2. Wenn es sich um Ihre erste Kampagne handelt, klicken Sie auf Erste Kampagne erstellen.
    1. Wählen Sie Firebase In-App-Nachrichten 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 die erste Nachricht ein.
  5. Klicken Sie auf Auf Gerät testen.
  6. Gib die Firebase-Installations-ID deiner App in das Fügen Sie eine Installations-ID hinzu.
  7. Klicken Sie auf Testen, um die Nachricht zu senden.

Firebase In-App Messaging sendet Ihre Testnachricht, sobald Sie auf Testen klicken. Um die angezeigt wird, müssen Sie die App auf Ihrem Testgerät schließen und wieder öffnen.

Ob Ihr Gerät ein Testgerät ist, erkennen Sie an der folgenden Protokollmeldung:

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