Dostosowywanie wiadomości Firebase w aplikacji


Funkcja Firebase Wysyłanie wiadomości w aplikacji zapewnia przydatny zestaw wstępnie skonfigurowanych zachowań wiadomości z domyślnym wyglądem i stylem, ale w niektórych przypadkach możesz i zwiększania zasięgu działań i treści wiadomości. Wiadomości w aplikacji umożliwiają dodawanie działań do wiadomości oraz dostosowywanie ich wyglądu i działania.

Dodawanie działania do wiadomości

Dzięki działaniom możesz używać wiadomości w aplikacji, aby kierować użytkowników do witryny lub konkretnego ekranu w aplikacji.

Firebase In-App Messaging do przetwarzania działań używa modułów obsługi linków. Pakiet SDK może używać wielu modułów obsługi, więc jeśli Twoja aplikacja już taki ma, Firebase In-App Messagingmoże z niego korzystać bez dalszej konfiguracji. Jeśli jeszcze tego nie zrobiłeś ma moduł obsługi, możesz użyć elementu Firebase Dynamic Links. Więcej informacji znajdziesz w artykule Tworzenie linków dynamicznych na iOS.

Dodaj działanie do wiadomości za pomocą konsoli Firebase

Gdy aplikacja będzie mieć moduł obsługi linków, możesz utworzyć kampanię z działaniem. Otwórz konsolę Firebase, aby Wiadomości, i utworzyć nową kampanię lub edytować istniejącą. W tej kampanii użyj karty, tekstu przyciskudziałania przycisku, działania obrazu lub działania banera, gdzie działaniem jest odpowiedni precyzyjny link.

Format działania zależy od wybranego układu wiadomości. Mody: przyciski poleceń z dostosowywaną treścią przycisku, kolorem tekstu i tłem; koloru. Obrazy i górne banery z kolei stają się interaktywne i wywołują określone działanie po kliknięciu.

Modyfikowanie wyglądu i stylu wiadomości

Firebase In-App Messaging umożliwia dostosowywanie wyświetlania wiadomości w celu zmiany sposobu renderowania aplikacji wiadomości układ, style czcionek, kształty przycisków i inne szczegóły. Dostępne są 2 sposoby modyfikacji wyświetlania wiadomości: zmiana domyślnego ustawienia Firebase In-App Messaging lub utwórz od podstaw własną bibliotekę wyświetlania wiadomości.

Uwaga: ta usługa nie jest dostępna na urządzeniach z systemem macOS, Mac Catalyst, App Clip i WatchOS.

Zmodyfikuj wyświetlacze domyślne

Najprostszym sposobem na dostosowanie komunikatów jest tworzenie Domyślny kod wyświetlania wiadomości użytkownika Firebase In-App Messaging.

Klonowanie repozytorium firebase-ios-sdk

Na początek skopiuj najnowszą wersję repozytorium firebase-ios-sdk i otwórz Katalog InAppMessaging.

Wybieranie typów wiadomości do zmodyfikowania

Po skopiowaniu repozytorium możesz zmodyfikować dowolny lub wszystkie typy wiadomości Firebase In-App Messaging: Card, Modal, Banner i ImageOnly. Każdy typ odpowiada układowi wiadomości w procesie tworzenia kampanii Firebase In-App Messaging.

W związku z tym każdy typ ma dostęp do innego zbioru danych określonego przez opcje dostosowania kampanii w konsoli Firebase:

Typ tytułTekst Tekst główny textColor backgroundColor imageData Przycisk polecenia secondaryActionButton
Karta
Okno modalne
Baner
ImageOnly

Modyfikowanie kodu renderowania wyświetlania wiadomości

Pamiętając o ograniczeniach dotyczących typu wiadomości, możesz je dowolnie modyfikować. Możesz utworzyć baner wyświetlany u dołu aplikacji, przesunąć przycisk działania w oknie modalnym, osadzić wiadomość w aplikacji w strumieniach użytkownika lub wprowadzić inne modyfikacje, które sprawią, że wygląd i działanie wiadomości będą pasować do Twojej aplikacji.

Podczas modyfikowania wyświetlania wiadomości musisz zwrócić uwagę na 2 główne kwestie:

  • Katalogi typów wiadomości: każdy typ wiadomości ma oddzielny katalog z plikami, które określają logikę tego typu:
  • Storyboard: biblioteka InAppMessaging zawiera też plik .storyboard, który pomaga zdefiniować interfejs dla wszystkich 3 typów wiadomości:

Aby utworzyć niestandardowe wyświetlanie wiadomości, zmodyfikuj pliki w katalogach preferowanych typów wiadomości i odpowiednich sekcji pliku .storyboard.

Zaktualizuj plik podfile, aby używać zmodyfikowanego kodu InAppMessaging

Aby aplikacja Firebase In-App Messaging używała zmodyfikowanych komunikatów zamiast domyślnego zaktualizuj plik podfile, aby korzystał z dostosowanej biblioteki InAppMessaging:

# 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
Gdy to zrobisz, możesz zaktualizować pody, przebudować aplikację i wyświetlać nowe, wyświetlany komunikat.

Utwórz własną bibliotekę wyświetlania wiadomości

Nie musisz ograniczać się do tworzenia interfejsu wyświetlania wiadomości do biblioteki InAppMessaging. Możesz też napisać własny kod od zera.

Tworzenie klasy implementującej protokół InAppMessagingDisplay

Firebase In-App Messaging używa klasy InAppMessaging do obsługi komunikacji między serwerami Firebase a Twoją aplikacją. Ta klasa z kolei używa protokołu InAppMessagingDisplay do wyświetlania otrzymanych wiadomości. Aby utworzyć własną bibliotekę wyświetlania, napisz klasę, która implementuje protokół.

Definicja protokołu i dokumentacja zgodności z nim znajdują się w Plik FIRInAppMessagingDisplay.h z biblioteki InAppMessaging.

Skonfiguruj aplikację messageDisplayComponent tak, aby mogła korzystać z biblioteki wyświetlania wiadomości

InAppMessaging używa właściwości messageDisplayComponent, aby określić, którego obiektu używać podczas wyświetlania wiadomości. Ustaw tę właściwość jako obiekt klasy wyświetlania wiadomości niestandardowej, aby Firebase In-App Messaging wiedziała, że ma używać Twojej biblioteki do renderowania wiadomości:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance