Erste Schritte mit Firebase In-App-Messaging

In dieser Kurzanleitung erfahren Sie, wie Sie Firebase In-App Messaging einrichten und Ihre erste Nachricht senden.

iOS+ Android Flutter

Hinweis

Bevor Sie beginnen, müssen Sie Ihrem Apple-Projekt Firebase 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.

In unserem Installationsleitfaden erfahren Sie, wie Sie Ihrem Apple-Projekt Firebase SDKs auf verschiedene Arten hinzufügen können, z. B. durch direkten Import von Frameworks und Verwendung von CocoaPods.

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:

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

Hinweis: Neue Projekte sollten die Standardversion (neueste) des SDK verwenden. Bei Bedarf können Sie jedoch eine ältere Version auswählen.
3. Wählen Sie die Bibliothek In-App Messaging aus.
4. Fügen Sie das Flag -ObjC im Abschnitt Other Linker Flags (Weitere Verknüpfungsmerker) 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.

Hinweis:Für Firebase In-App Messaging ist Firebase Version 5.6.0 oder höher erforderlich. 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 Firebase-Abhängigkeiten.

Testnachricht senden

Installations-ID Ihrer App abrufen

Aus Energiespargründen ruft Firebase In-App Messaging Nachrichten nur einmal pro Tag vom Server ab. Das 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 ermitteln, führen Sie die App mit dem Befehlsargument „-FIRDebugEnabled“ aus:

1. Wählen Sie in Xcode in der oberen Menüleiste Produkt > Schema > Schema bearbeiten… aus.
2. Öffnen Sie im angezeigten Dialogfeld den Tab Arguments (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.

Sobald die 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

Nachricht an Ihr Testgerät senden

Sobald du deine App auf dem Testgerät gestartet hast und die zugehörige Firebase-Installations-ID (FID) hast, kannst du die Firebase In-App Messaging-Einrichtung testen. Sende dazu eine Testnachricht:

1. Öffnen Sie in der Firebase Console die Seite Messaging.
2. Falls dies Ihre erste Kampagne ist, klicken Sie auf Erste Kampagne erstellen.
   1. Wählen Sie Firebase In-App-Nachrichten aus und klicken Sie auf Erstellen.
3. Andernfalls klicken Sie 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 Testen, um die Nachricht zu senden.

Firebase In-App Messaging sendet Ihre Testnachricht, sobald Sie auf Testen klicken. Wenn Sie die Meldung sehen möchten, müssen Sie die App auf Ihrem Testgerät schließen und dann wieder öffnen.

Prüfen Sie, ob Ihr Gerät ein Testgerät ist, indem Sie nach der folgenden Lognachricht suchen:

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