Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Passen Sie Ihre Firebase In-App Messaging-Nachrichten an

Firebase In-App Messaging bietet einen nützlichen Satz vorkonfigurierter Verhaltensweisen und Nachrichtentypen mit einem standardmäßigen Erscheinungsbild, aber in einigen Fällen möchten Sie möglicherweise Verhalten und Nachrichteninhalte erweitern. Mit In-App-Messaging können Sie Nachrichten Aktionen hinzufügen und das Erscheinungsbild von Nachrichten anpassen.

Fügen Sie Ihrer Nachricht eine Aktion hinzu

Mit Aktionen können Sie Ihre In-App-Nachrichten verwenden, um Benutzer auf eine Website oder einen bestimmten Bildschirm in Ihrer App zu leiten.

Firebase In-App Messaging verwendet Link-Handler, um Aktionen zu verarbeiten. Das SDK kann eine Reihe von Handlern verwenden. Wenn Ihre App bereits über einen Handler verfügt, kann Firebase In-App Messaging diese ohne weitere Einrichtung verwenden. Wenn Sie noch keinen Handler haben, können Sie Firebase Dynamic Links verwenden. Um mehr zu erfahren, lesen Sie auf iOS erstellen dynamische Links .

Fügen Sie die Aktion über die Firebase-Konsole zu Ihrer Nachricht hinzu.

Sobald Ihre App über einen Link-Handler verfügt, können Sie eine Kampagne mit einer Aktion erstellen. Öffnen Sie die Firebase Konsole zu In-App - Messaging , und starten Sie eine neue Kampagne oder bearbeiten eine bestehende Kampagne. In dieser Kampagne bietet eine Karte, Knopf Text und Button Aktion eine Aktion Bild oder ein Banner Aktion, wo die Aktion eine entsprechende tiefe Verbindung ist.

Das Format der Aktion hängt davon ab, welches Nachrichtenlayout Sie auswählen. Modals erhalten Aktionsschaltflächen mit anpassbarem Schaltflächentextinhalt, Textfarbe und Hintergrundfarbe. Bilder und Top-Banner hingegen werden interaktiv und rufen beim Antippen die angegebene Aktion auf.

Aussehen und Verhalten von Nachrichten ändern

Mit Firebase In-App Messaging können Sie die Anzeige von Nachrichten anpassen, um das Layout, die Schriftarten, die Schaltflächenformen und andere Details Ihrer App zu ändern. Es gibt zwei Möglichkeiten, Nachrichtenanzeigen zu ändern: Ändern Sie die standardmäßigen Firebase In-App Messaging-Anzeigen oder erstellen Sie Ihre eigene Nachrichtenanzeigebibliothek von Grund auf.

Standardanzeigen ändern

Die einfachste Möglichkeit, Ihre Nachrichten anzupassen, besteht darin, den standardmäßigen Nachrichtenanzeigecode von Firebase In-App Messaging aufzubauen.

Klonen Sie die firebase-ios-sdk - Repo

Um loszulegen, klonen die neueste Version der firebase-ios-sdk - Repo, und öffnen Sie das InAppMessaging Verzeichnis .

Wählen Sie die zu ändernden Nachrichtentypen aus

: Mit dem Repo geklont, können Sie eine oder alle der Firebase In-App - Messaging - Nachrichtentypen ändern Card , Modal , Banner und ImageOnly . Jeder Typ entspricht einem Nachrichtenlayout im Erstellungsprozess von Firebase-In-App-Messaging-Kampagnen.

Dementsprechend hat jeder Typ Zugriff auf einen anderen Datensatz, der durch die Kampagnenanpassungsoptionen in der Firebase-Konsole bestimmt wird:

Typ TitelText Hauptteil Textfarbe Hintergrundfarbe Bilddaten Aktionsknopf sekundäreActionButton
Karte
Modal
Banner
Nur Bild

Ändern Sie den Rendering-Code der Nachrichtenanzeige

Unter Berücksichtigung der Beschränkungen des Nachrichtentyps können Sie diese nach Belieben ändern. Sie können ein Banner erstellen, das unten in Ihrer App angezeigt wird, die Aktionsschaltfläche auf einem Modal verschieben, die In-App-Nachricht in den Feed eines Benutzers einbetten oder jede andere Änderung vornehmen, die das Erscheinungsbild der Nachrichten an Ihre App anpasst .

Beim Ändern von Meldungsanzeigen sind vor allem zwei Dinge zu beachten:

  • Nachrichtentyp Verzeichnisse: Jeder Nachrichtentyp hat ein eigenes Verzeichnis mit Dateien , die vom Typ des einzelnen Logik bestimmen:
  • Storyboard: Die InAppMessaging Bibliothek hat auch eine .storyboard - Datei , die die Benutzeroberfläche für alle drei Nachrichtentypen hilft definieren:

Ändern von Dateien in Ihren bevorzugten Nachrichtentypen Verzeichnisse und die entsprechenden Abschnitte der .storyboard Ihrer benutzerdefinierte Nachricht Displays zu erstellen.

Aktualisieren Sie Ihre podfile Ihre geändert zum Einsatz InAppMessaging Code

Firebase In-App - Messaging zu verwenden , um Ihre modifizierte Meldung angezeigt anstelle der Standard - Displays zu erhalten, aktualisieren Sie Ihre podfile Ihre individuelle verwenden InAppMessaging Bibliothek:

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'YourProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!

# Pods for YourProject
pod 'Firebase'

# Remove the default InAppMessaging pod:
# pod 'Firebase/InAppMessaging'

# Overwrite it with a version that points to your local copy:
pod `FirebaseInAppMessaging', :path => '~/Path/To/The/Cloned/Repo/'

end
Danach können Sie Ihre Pods aktualisieren, Ihre App neu erstellen und Ihre neuen, benutzerdefinierten Nachrichten anzeigen.

Erstellen Sie Ihre eigene Nachrichtenanzeigebibliothek

Sie sind nicht zu arbeiten aus der begrenzten InAppMessaging Bibliothek zum Anzeigen von Nachrichten eine Benutzeroberfläche zu erstellen. Sie können auch Ihren eigenen Code von Grund auf neu schreiben.

Erstellen Sie eine Klasse, die implementiert das InAppMessagingDisplay Protokoll

Firebase In-App - Messaging verwendet die InAppMessaging Klasse Griff Kommunikation zwischen Server und Firebase Ihre App. Diese Klasse, die wiederum verwendet die InAppMessagingDisplay Protokoll die Meldungen angezeigt werden sie empfängt. Um Ihre eigene Anzeigebibliothek zu erstellen, schreiben Sie eine Klasse, die das Protokoll implementiert.

Die Protokolldefinition und Dokumentation, wie man es in der anzupassen FIRInAppMessagingDisplay.h Datei der InAppMessaging Bibliothek.

Set messageDisplayComponent Ihre Nachricht Display - Bibliothek zu verwenden ,

InAppMessaging nutzt seine messageDisplayComponent Eigenschaft , um zu bestimmen , welches Objekt verwendet, um Nachrichten anzuzeigen. Legen Sie diese Eigenschaft auf ein Objekt Ihrer benutzerdefinierten Nachrichtenanzeigeklasse fest, damit Firebase In-App Messaging Ihre Bibliothek zum Rendern von Nachrichten verwendet:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance