Dostosuj wiadomości Firebase w aplikacji

Firebase In-App Messaging zapewnia użyteczny zestaw wstępnie skonfigurowanych zachowań i typów wiadomości z domyślnym wyglądem i stylem, ale w niektórych przypadkach możesz chcieć rozszerzyć zachowania i treść wiadomości. Wiadomości w aplikacji umożliwiają dodawanie działań do wiadomości oraz dostosowywanie wyglądu i stylu wiadomości.

Dodaj akcję do wiadomości

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

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

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

Gdy Twoja aplikacja ma moduł obsługi linków, możesz utworzyć kampanię z działaniem. Otwórz konsolę Firebase w aplikacji Messaging i rozpocznij nową kampanię lub edytuj istniejącą. W tej kampanii podaj działanie związane z kartą , tekstem przycisku i działaniem przycisku , działaniem związanym z obrazem lub banerem , gdzie działaniem jest odpowiedni precyzyjny link.

Format akcji zależy od wybranego układu wiadomości. Moduły otrzymują przyciski akcji z dostosowywaną 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

Firebase In-App Messaging pozwala dostosować wyświetlanie wiadomości, aby zmienić sposób, 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 wyświetlaczy Firebase In-App Messaging lub tworzenie od podstaw własnej biblioteki wyświetlania wiadomości.

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

Zmodyfikuj domyślne ekrany

Najprostszym sposobem dostosowania 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 do modyfikacji

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

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

Typ tytułTekst Tekst treści 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, który będzie wyświetlany u dołu aplikacji, poruszać się po przycisku akcji w oknie modalnym, osadzić wiadomość w aplikacji w kanale użytkownika lub wprowadzić dowolną inną modyfikację, która dopasuje wygląd i styl wiadomości do Twojej aplikacji .

Istnieją dwie główne rzeczy, na które należy zwrócić uwagę podczas modyfikowania wyświetlanych komunikatów:

  • 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 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 plik podfile, aby używać zmodyfikowanego kodu InAppMessaging

Aby Firebase In-App Messaging używał zmodyfikowanych ekranów wiadomości zamiast domyślnych, 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
Po wykonaniu tej czynności możesz zaktualizować swoje pody, przebudować aplikację i zobaczyć nowe, dostosowane komunikaty.

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

Nie jesteś ograniczony do pracy z biblioteki InAppMessaging , aby utworzyć interfejs użytkownika do wyświetlania wiadomości. Możesz także napisać własny kod od podstaw.

Zbuduj klasę, która implementuje protokół InAppMessagingDisplay

Usługa 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 komunikatów. Aby zbudować własną bibliotekę wyświetlania, napisz klasę, która implementuje protokół.

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

Ustaw messageDisplayComponent , aby używał biblioteki wyświetlania wiadomości

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

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance