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.
- Navigieren Sie in Xcode bei geöffnetem App-Projekt zu File > Add Packages .
- Wenn Sie dazu aufgefordert werden, fügen Sie das Firebase Apple Platforms SDK-Repository hinzu:
- Wählen Sie die In-App-Messaging-Bibliothek.
- 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.
- Wenn Sie fertig sind, beginnt Xcode automatisch mit der Auflösung und dem Herunterladen Ihrer Abhängigkeiten im Hintergrund.
https://github.com/firebase/firebase-ios-sdk
Initialisieren Sie nun das SDK in Ihrer App:
- Importieren Sie das Firebase-Modul in Ihre
App
Struktur oderUIApplicationDelegate
, falls Sie dies noch nicht getan haben:Schnell
import Firebase
Ziel c
@import Firebase;
- Konfigurieren Sie auch eine gemeinsam genutzte
FirebaseApp
Instanz, normalerweise im Initialisierer IhrerApp
oderapplication(_:didFinishLaunchingWithOptions:)
Methode Ihres App-Delegierten, falls Sie dies noch nicht getan haben:Schnell
FirebaseApp.configure()
Ziel c
[FIRApp configure];
- 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:
- Wählen Sie bei geöffnetem Xcode-Projekt in der oberen Menüleiste Produkt > Schema > Schema bearbeiten... aus.
- Öffnen Sie die Registerkarte „Argumente“ des daraufhin angezeigten Dialogfelds.
- Klicken Sie unter „Beim Start übergebene Argumente“ auf + Elemente hinzufügen .
- Geben Sie „-FIRDebugEnabled“ in das neu erstellte Feld ein.
- 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:
- Öffnen Sie in der Firebase-Konsole die Seite „Messaging“ .
- Wenn dies Ihre erste Kampagne ist, klicken Sie auf Ihre erste Kampagne erstellen .
- Wählen Sie Firebase In-App-Nachrichten aus und klicken Sie auf Erstellen .
- Andernfalls klicken Sie auf der Registerkarte Kampagnen auf Neue Kampagne .
- Wählen Sie In-App-Messaging aus.
- Geben Sie einen Titel für Ihre erste Nachricht ein.
- Klicken Sie auf Auf Gerät testen
- Geben Sie die Firebase-Installations-ID Ihrer App in das Feld „Installations-ID hinzufügen“ ein.
- 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.