Dostosowywanie wiadomości Firebase w aplikacji


Narzędzie Firebase do wysyłania wiadomości w aplikacji udostępnia przydatny zestaw wstępnie skonfigurowanych zachowań i typów wiadomości o domyślnym wyglądzie i działaniu, ale w niektórych przypadkach warto rozszerzyć zachowania i treść wiadomości. Wysyłanie wiadomości w aplikacji umożliwia dodawanie działań a także dostosować wygląd i styl wiadomości.

Dodaj działanie do wiadomości

Dzięki akcjom możesz wykorzystać wiadomości w aplikacji do kierowania użytkowników lub na konkretnym ekranie w aplikacji.

Firebase In-App Messaging używa modułów obsługi linków do przetwarzania działań. 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: Tworzenie linków dynamicznych w iOS.

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

Gdy aplikacja ma już moduł obsługi linków, możesz przygotować kampanię działanie. Otwórz konsolę Firebase, aby utworzyć nową kampanię Messaging lub edytować istniejącą. W tej kampanii podaj Karta, Tekst przycisku i Działanie przycisku, Działanie dotyczące obrazu lub Baner action, gdzie działanie jest odpowiednim precyzyjnym linkiem.

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

Modyfikowanie wyglądu i stylu wiadomości

Firebase In-App Messaging umożliwia dostosowanie wyświetlania wiadomości, aby zmienić sposób renderowania układu wiadomości, styl czcionki, kształty przycisków i inne szczegóły. Możesz zmodyfikować wyświetlanie wiadomości na 2 sposoby: zmodyfikować domyślne Firebase In-App Messagingwyświetlanie lub utworzyć własną bibliotekę wyświetlania wiadomości od podstaw.

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.

Sklonuj repozytorium firebase-ios-sdk.

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

Wybierz typy wiadomości do zmodyfikowania

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

W zależności od tego, jakie opcje dostosowywania kampanii są wybrane w konsoli Firebase, każdy typ ma dostęp do innego zbioru danych:

Typ tytułTekst bodyText kolortekstu backgroundColor imageData actionButton Przycisk dodatkowego działania
Karta
Okno modalne
Baner
Tylko obraz

Modyfikowanie kodu renderowania wyświetlania wiadomości

Mając na uwadze ograniczenia dotyczące typów wiadomości, możesz je swobodnie modyfikować. w dowolnym momencie. 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 należy zwrócić uwagę na 2 główne kwestie:

  • Katalogi typów wiadomości: każdy typ wiadomości ma oddzielny katalog. za pomocą plików, 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:

Zmodyfikuj pliki w preferowanych typach wiadomości i odpowiadające im katalogi .storyboard, aby utworzyć niestandardowe ekrany z komunikatami.

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

Aby usługa Firebase In-App Messaging używała zmodyfikowanych wyświetlanych wiadomości zamiast domyślnych wyświetlanych wiadomości, zaktualizuj podplik, aby używać dostosowanych bibliotek 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 podstaw.

Utwórz klasę, która implementuje protokół InAppMessagingDisplay

Firebase In-App Messaging używa klasy InAppMessaging do obsługi komunikacji między serwerów Firebase i aplikacji. Klasa z kolei korzysta z funkcji InAppMessagingDisplay do wyświetlania odbieranych wiadomości. Aby utworzyć własną bibliotekę wyświetlania, napisz klasę, która implementuje protokół.

Definicja protokołu i dokumentacja dotycząca zgodności znajdują się w pliku FIRInAppMessagingDisplay.h biblioteki InAppMessaging.

Ustaw messageDisplayComponent, aby 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ść na obiekt niestandardowy klasa wyświetlania wiadomości, więc Firebase In-App Messaging wie, że ma użyć Twojej biblioteki do renderowania wiadomości:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance