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

Bevor Sie beginnen, stellen Sie sicher, dass Sie Firebase zu Ihrem Apple-Projekt hinzufügen .

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

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

  1. Navigieren Sie in Xcode bei geöffnetem App-Projekt zu File > Add Packages .
  2. Wenn Sie dazu aufgefordert werden, fügen Sie das Firebase Apple Platforms SDK-Repository hinzu:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Wählen Sie die In-App-Messaging-Bibliothek.
  5. Fügen Sie das Flag -ObjC zum Abschnitt „Andere Linker-Flags“ der Build-Einstellungen Ihres Ziels hinzu.
  6. Um In-App-Messaging verwenden zu können, müssen Sie Google Analytics in Ihrem Firebase-Projekt aktivieren und das Firebase SDK für Google Analytics zu Ihrer App hinzufügen. Sie können entweder die Bibliothek ohne IDFA-Sammlung oder mit IDFA-Sammlung auswählen.
  7. Wenn Sie fertig sind, beginnt Xcode automatisch mit der Auflösung und dem Herunterladen Ihrer Abhängigkeiten im Hintergrund.

Initialisieren Sie nun das SDK in Ihrer App:

  1. Importieren Sie das Firebase-Modul in Ihre App Struktur oder UIApplicationDelegate , falls Sie dies noch nicht getan haben:
    Schnell
    import Firebase
    Ziel c
    @import Firebase;
  2. Konfigurieren Sie auch eine gemeinsam genutzte FirebaseApp Instanz, normalerweise im Initialisierer Ihrer App oder application(_:didFinishLaunchingWithOptions:) Methode Ihres App-Delegierten, falls Sie dies noch nicht getan haben:
    Schnell
    FirebaseApp.configure()
    Ziel c
    [FIRApp configure];
  3. Kompilieren Sie Ihre App und führen Sie sie aus.

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 Testgerät wird durch eine Firebase-Installations-ID bestimmt, die vom Firebase-Installationsdienst bereitgestellt wird. Um die Installations-ID Ihrer Test-App zu finden, führen Sie 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 die Seite „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 Auf 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.

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 der folgenden Protokollmeldung:

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