Funkcja Firebase Wysyłanie wiadomości w aplikacji udostępnia przydatny zestaw wstępnie skonfigurowanych zachowań i typów wiadomości o domyślnym wyglądzie i funkcjach. W niektórych przypadkach warto jednak rozszerzyć zachowania i treść 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.
Wdrożenie obsługi precyzyjnych linków
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 nie masz jeszcze modułu obsługi, możesz użyć Firebase Dynamic Links. Więcej informacji znajdziesz w artykule Tworzenie linków dynamicznych w 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 utworzyć nową kampanię Messaging lub edytować istniejącą. W tej kampanii użyj karty, tekstu przycisku i dział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. Modale mają przyciski akcji z możliwością dostosowania treści tekstu przycisku, koloru tekstu i koloru tła. Zdjęcia i banery górne stają się natomiast interaktywne i po kliknięciu wywołują określone działanie.
Zmiana wyglądu i działania 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 zmienić 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.
Zmodyfikuj wyświetlacze domyślne
Najprostszym sposobem dostosowywania wiadomości jest korzystanie z domyślnego kodu wyświetlania wiadomości w Firebase In-App Messaging.
Sklonuj repozytorium firebase-ios-sdk
.
Aby rozpocząć, sklonuj 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 zależności od tego, które opcje dostosowywania kampanii są wybrane w konsoli Firebase, każdy typ ma dostęp do innego zbioru danych:
Typ | tytułTekst | bodyText | textColor | backgroundColor | imageData | actionButton | Przycisk dodatkowego działania |
---|---|---|---|---|---|---|---|
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 należy 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ą jego logikę:
- Storyboard: biblioteka
InAppMessaging
zawiera też plik.storyboard
, który pomaga zdefiniować interfejs dla wszystkich 3 typów wiadomości:
Zmodyfikuj pliki w katalogach preferowanych typów wiadomości i odpowiadających im sekcjach pliku .storyboard
, aby utworzyć komunikaty niestandardowe.
Zaktualizuj plik podfile, aby używał zmodyfikowanego kodu InAppMessaging
Aby zamiast domyślnych wyświetleń wiadomości używać zmodyfikowanych wyświetleń wiadomości w Firebase In-App Messaging, zaktualizuj podplik, aby używać 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
Utwórz własną bibliotekę wyświetlania wiadomości
Nie możesz tworzyć interfejsu do wyświetlania wiadomości przy użyciu biblioteki InAppMessaging
. Możesz też napisać własny kod od podstaw.
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 znajduje się w pliku FIRInAppMessagingDisplay.h
w bibliotece 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ść na obiekt klasy wyświetlania niestandardowej wiadomości, aby Firebase In-App Messaging wie, że ma używać Twojej biblioteki do renderowania wiadomości:
InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance