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.
Implementacja modułu obsługi precyzyjnych linków
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.
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
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