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.

Firebase In-App Messaging SDK zu Ihrem Projekt hinzufügen

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 im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) der Build-Einstellungen Ihres Ziels hinzu.
  5. Wenn Sie In-App Messaging verwenden möchten, 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-Erhebung oder mit IDFA-Erhebung auswählen. Weitere Informationen finden Sie in den FAQs zur neuesten Organisation von Modulen im Google Analytics for Firebase SDK.
  6. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Initialisieren Sie das SDK jetzt in Ihrer App:

  1. Importieren Sie das Firebase-Modul in Ihre App Struktur oder UIApplicationDelegate, falls noch nicht geschehen:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Konfigurieren Sie außerdem eine FirebaseApp gemeinsame Instanz, in der Regel im Initialisierer Ihrer App's oder in der Methode application(_:didFinishLaunchingWithOptions:) Ihres App-Delegaten, falls noch nicht geschehen:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Kompilieren Sie Ihre App und führen Sie sie aus.

Testnachricht senden

Installations-ID Ihrer App abrufen

Um Strom zu sparen, ruft Firebase In-App Messaging Nachrichten nur einmal pro Tag vom Server ab. Das kann das Testen erschweren. In der Firebase Console können Sie daher ein Testgerät angeben, auf dem Nachrichten bei Bedarf angezeigt werden.

Dieses Testgerät wird durch eine Firebase Installations-ID bestimmt, die vom Firebase Installationsdienst bereitgestellt wird. Führen Sie die App mit dem Laufzeitbefehlsargument -FIRDebugEnabled aus, um die Installations-ID Ihrer Test-App zu ermitteln:

  1. Wählen Sie in der Menüleiste oben in Ihrem Xcode-Projekt Product > Scheme > Edit scheme... aus
  2. Öffnen Sie den Tab Arguments (Argumente) des angezeigten Dialogfelds.
  3. Klicken Sie unter Arguments Passed On Launch (Argumente, die beim Start übergeben werden) auf + Add items (+ Elemente hinzufügen).
  4. Geben Sie im neu erstellten Feld „-FIRDebugEnabled“ ein.
  5. Klicken Sie auf Close (Schließen) und führen Sie dann Ihre App aus.

Suchen Sie in den Logs der Xcode-Konsole nach dem Start Ihrer App nach der folgenden Zeile:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

Nachricht an Ihr Testgerät senden

Nachdem Sie Ihre App auf dem Testgerät gestartet haben und die Firebase Installations-ID (FID) des Geräts kennen, können Sie Ihre Firebase In-App Messaging Einrichtung testen, indem Sie eine Testnachricht senden:

  1. Rufen Sie in der Firebase Console DevOps & Engagement > Messaging auf.

  2. Starten Sie den Workflow zum Einrichten einer neuen Kampagne:

    • Wenn dies Ihre erste Kampagne ist:

      1. Klicken Sie auf Create your first campaign (Erste Kampagne erstellen).
      2. Wählen Sie Firebase In-App messages (Firebase In-App-Nachrichten) aus und klicken Sie auf Create (Erstellen).

    • Wenn Sie bereits Kampagnen erstellt haben:

      1. Klicken Sie auf dem Tab Campaigns (Kampagnen) auf New campaign (Neue Kampagne).
      2. Wählen Sie In-App Messaging aus.

  3. Geben Sie einen Title (Titel) für Ihre erste Nachricht ein.

  4. Klicken Sie auf Test on Device (Auf Gerät testen).

  5. Geben Sie die Firebase Firebase Installations-ID Ihrer App in das Add an installation ID Feld ein.

  6. Klicken Sie auf Test (Testen), um die Nachricht zu senden. Sie wird sofort gesendet.

  7. Wenn Sie die Nachricht auf Ihrem Testgerät sehen möchten, müssen Sie die App auf dem Testgerät schließen und dann wieder öffnen.

Suchen Sie nach der folgenden Logmeldung, um zu prüfen, ob Ihr Gerät ein Testgerät ist:

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