Dostosuj wiadomości Firebase w aplikacji

Wiadomości w aplikacji Firebase zapewniają przydatny zestaw wstępnie skonfigurowanych zachowań i typów wiadomości z domyślnym wyglądem i sposobem działania, ale w niektórych przypadkach możesz chcieć rozszerzyć zachowania i treść wiadomości. Funkcja Wiadomości w aplikacji umożliwia dodawanie działań do wiadomości oraz dostosowywanie wyglądu i sposobu działania wiadomości.

Dodaj akcję do swojej wiadomości

Dzięki akcjom możesz używać wiadomości w aplikacji do kierowania użytkowników do witryny internetowej lub określonego ekranu w aplikacji.

Firebase In-App Messaging wykorzystuje procedury obsługi linków do przetwarzania działań. SDK może korzystać z wielu procedur obsługi, więc jeśli Twoja aplikacja już je ma, Firebase In-App Messaging może z nich korzystać bez dalszej konfiguracji. Jeśli nie masz jeszcze modułu obsługi, możesz użyć linków dynamicznych Firebase. Aby dowiedzieć się więcej, przeczytaj artykuł Tworzenie linków dynamicznych na iOS .

Dodaj akcję do swojej wiadomości za pomocą konsoli Firebase

Gdy Twoja aplikacja będzie mieć moduł obsługi linków, możesz stworzyć kampanię zawierającą działanie. Otwórz konsolę Firebase w aplikacji Messaging i rozpocznij nową kampanię lub edytuj istniejącą kampanię. W tej kampanii podaj kartę , tekst przycisku i akcję przycisku , akcję obrazu lub akcję banera , gdzie akcja jest odpowiednim precyzyjnym linkiem.

Format akcji zależy od wybranego układu wiadomości. Modale otrzymują przyciski akcji z konfigurowalną treścią tekstu przycisku, kolorem tekstu i kolorem tła. Z drugiej strony obrazy i górne banery stają się interaktywne i po dotknięciu wywołują określoną akcję.

Zmodyfikuj wygląd i styl wiadomości

Funkcja przesyłania wiadomości w aplikacji Firebase umożliwia dostosowywanie wyświetlanych wiadomości w celu zmiany sposobu, w jaki aplikacja renderuje układ wiadomości, style czcionek, kształty przycisków i inne szczegóły. Istnieją dwa sposoby modyfikowania wyświetlanych komunikatów: modyfikowanie domyślnych komunikatów Firebase w aplikacji lub tworzenie od podstaw własnej biblioteki wyświetlania komunikatów.

Uwaga: ten produkt nie jest dostępny w systemach macOS, Mac Catalyst, App Clip i watchOS.

Zmodyfikuj domyślne wyświetlacze

Najprostszym sposobem dostosowywania wiadomości jest zbudowanie domyślnego kodu wyświetlania wiadomości Firebase In-App Messaging.

Sklonuj repozytorium firebase-ios-sdk

Aby rozpocząć, sklonuj najnowszą wersję repozytorium firebase-ios-sdk i otwórz katalog InAppMessaging .

Wybierz typy wiadomości, które chcesz zmodyfikować

Po sklonowaniu repozytorium możesz modyfikować 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 zestawu danych, określanego opcjami dostosowywania kampanii w konsoli Firebase:

Typ tytułTekst treść kolor tekstu kolor tła Dane obrazu Przycisk akcji dodatkowy przycisk akcji
Karta
Modalny
Transparent
Tylko obraz

Zmodyfikuj kod renderowania wyświetlania komunikatów

Mając na uwadze ograniczenia typów wiadomości, możesz je dowolnie modyfikować. Możesz utworzyć baner wyświetlany na dole aplikacji, poruszać się po przycisku akcji w trybie modalnym, osadzić wiadomość w aplikacji w kanale użytkownika lub wprowadzić dowolną inną modyfikację, która sprawi, że komunikaty będą wyglądać i pasować do Twojej aplikacji .

Modyfikując wyświetlane komunikaty, należy zwrócić uwagę na dwie główne rzeczy:

  • Katalogi typów wiadomości: każdy typ wiadomości ma oddzielny katalog z plikami określającymi logikę tego typu:
  • Storyboard: Biblioteka InAppMessaging zawiera również plik .storyboard , który pomaga zdefiniować interfejs użytkownika dla wszystkich trzech typów wiadomości:

Zmodyfikuj pliki w katalogach preferowanych typów wiadomości i odpowiednich sekcjach .storyboard , aby utworzyć niestandardowe wyświetlacze wiadomości.

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

Aby funkcja Firebase In-App Messaging korzystała ze zmodyfikowanych komunikatów zamiast domyślnych, zaktualizuj swój plik pod, 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
Po wykonaniu tej czynności możesz zaktualizować swoje pody, przebudować aplikację i zobaczyć nowe, spersonalizowane komunikaty.

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

Tworzenie interfejsu użytkownika do wyświetlania wiadomości nie jest ograniczone do pracy z biblioteką InAppMessaging . Możesz także napisać własny kod od zera.

Zbuduj klasę, która implementuje 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 otrzymywanych wiadomości. Aby zbudować własną bibliotekę wyświetlania, napisz klasę implementującą protokół.

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

Ustaw messageDisplayComponent tak, aby korzystał z biblioteki wyświetlania wiadomości

InAppMessaging używa swojej właściwości messageDisplayComponent do określenia obiektu, który ma być używany podczas wyświetlania wiadomości. Ustaw tę właściwość na obiekt niestandardowej klasy wyświetlania komunikatów, aby funkcja Firebase In-App Messaging wiedziała, że ​​może używać Twojej biblioteki do renderowania wiadomości:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance