Dostosuj wiadomości Firebase w aplikacji do obsługi wiadomości

iOS+ Android Flutter

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.

Zaimplementuj obsługę głębokiego linku

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.

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:

Zmodyfikuj kod renderowania wyświetlania komunikatów

Mając na uwadze ograniczenia typu 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:
  • Card
  • Modal
  • Banner
  • ImageOnly
• Storyboard: Biblioteka InAppMessaging zawiera również plik .storyboard , który pomaga zdefiniować interfejs użytkownika dla wszystkich trzech typów wiadomości:
  • FIRInAppMessageDisplayStoryboard.storyboard

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

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 , aby określić, który obiekt ma być używany podczas wyświetlania wiadomości. 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