Beginnen Sie mit Firebase In-App Messaging

Dieser Schnellstart zeigt Ihnen, wie Sie Firebase In-App Messaging einrichten und Ihre erste Nachricht senden.

iOS+ Android -Flutter

Bevor Sie beginnen

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

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.

Besuchen Sie unsere Installationsanleitung, um mehr über die verschiedenen Möglichkeiten zu erfahren, wie Sie Firebase SDKs zu Ihrem Apple-Projekt hinzufügen können, einschließlich des direkten Imports von Frameworks und der Verwendung von CocoaPods.

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-Plattform-SDK-Repository hinzu:

  https://github.com/firebase/firebase-ios-sdk

Hinweis: Neue Projekte sollten die standardmäßige (neueste) SDK-Version verwenden, aber Sie können bei Bedarf eine ältere Version auswählen.
3. Wählen Sie die In-App-Messaging-Bibliothek.
4. Um In-App-Messaging zu verwenden, 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.
5. Wenn Sie fertig sind, beginnt Xcode automatisch mit dem Auflösen und 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 noch nicht geschehen:

   Schnell

   import Firebase

   Ziel c

   @import Firebase;

2. Konfigurieren Sie außerdem eine freigegebene FirebaseApp Instanz, normalerweise im Initialisierer Ihrer App oder in der Methode application(_:didFinishLaunchingWithOptions:) Ihres App-Delegaten, 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.

Hinweis: Firebase In-App Messaging erfordert Firebase Version 5.6.0 oder höher. Wenn Sie Probleme beim Kompilieren Ihrer App haben, versuchen Sie pod update im Projektverzeichnis Ihrer App auszuführen. Beachten Sie jedoch, dass der Befehl alle Abhängigkeiten Ihrer App aktualisiert, nicht nur die von Firebase.

Senden Sie eine Testnachricht

Rufen Sie die Installations-ID Ihrer App ab

Um Energie zu sparen, ruft Firebase In-App Messaging Nachrichten nur einmal täglich vom Server ab. Das kann das Testen erschweren, sodass Sie in der Firebase-Konsole ein Testgerät angeben können, 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 Dialogfelds, das angezeigt wird.
3. Klicken Sie unter Beim Start übergebene Argumente auf + Elemente hinzufügen .
4. Geben Sie in das neu erstellte Feld "-FIRDebugEnabled" 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 Ihnen die Firebase-Installations-ID (FID) vorliegt, 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. 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 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 Test , um die Nachricht zu senden.

Firebase In-App Messaging sendet Ihre Testnachricht, sobald Sie auf Test klicken. Um die Nachricht anzuzeigen, müssen Sie die App auf Ihrem Testgerät schließen und dann erneut öffnen.

Um zu bestätigen, ob Ihr Gerät ein Testgerät ist, suchen Sie nach der folgenden Protokollnachricht:

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