自定义 Firebase In-App Messaging 消息


Firebase In-App Messaging 提供了一组实用的预配置行为及具有默认外观和风格的消息类型,但在某些情况下,您可能需要扩展行为和消息内容。利用 In-App Messaging,您可以向消息添加操作并自定义消息的外观和风格。

向消息添加操作

通过添加操作,您可以使用应用内消息将用户定向到某个网站或应用中的特定界面。

Firebase In-App Messaging 使用链接处理程序来处理操作。SDK 能够使用多个处理程序,因此如果您的应用已有处理程序,Firebase In-App Messaging 可以使用它,而无需进一步设置如果您还没有处理程序,则可以使用 Firebase Dynamic Links。如需了解详情,请参阅创建动态链接 (iOS)

使用 Firebase 控制台将操作添加到消息中

应用有了链接处理程序之后,您就可以撰写含有操作的宣传活动了。打开 Firebase 控制台,浏览到 Messaging(消息传递),然后启动一个新的宣传活动或修改现有宣传活动。在该广告系列中,提供卡片按钮文本按钮操作图片操作横幅操作(这里的操作是指相关的深层链接)。

操作的格式取决于您选择的消息布局。模态窗口中会包含带有可自定义按钮文本内容、文本颜色和背景颜色的操作按钮。而图片和顶部横幅则变为互动式,会在用户点按时调用指定的操作。

修改消息的外观和风格

借助 Firebase In-App Messaging,您可以自定义消息的显示方式,以更改应用呈现消息布局、字体样式、按钮形状和其他详细信息的方式。有两个 修改消息显示方式的方法:修改默认 Firebase In-App Messaging 显示或从头开始创建自己的消息显示库。

注意:此产品不适用于 macOS、Mac Catalyst、App Clip 或 watchOS 目标。

修改默认显示方式

最直接的自定义消息的方法是以 Firebase In-App Messaging 的默认消息显示代码为基础进行构建。

克隆 firebase-ios-sdk 代码库

如需开始操作,请克隆最新版 firebase-ios-sdk 代码库,然后打开 InAppMessaging 目录

选择要修改的消息类型

克隆代码库后,您可以修改任何或所有 Firebase In-App Messaging 消息类型: CardModalBannerImageOnly。每种类型都对应 Firebase In-App Messaging 宣传活动创建流程中的一种消息布局。

相应地,每种类型可以访问不同的数据集,这取决于 Firebase控制台中的广告系列自定义选项:

类型 titleText bodyText textColor backgroundColor imageData actionButton secondaryActionButton
Card
Modal
Banner
ImageOnly

修改消息显示呈现代码

您可以根据需要随意修改消息的显示方式,但需注意有关消息类型的限制。您可以创建一个显示在应用底部的横幅、移动模态窗口上的操作按钮、在用户 Feed 中嵌入应用内消息,或进行任何其他修改,以使消息的外观和风格与您的应用相契合。

修改消息显示方式时需要注意以下两点:

修改偏好消息类型对应目录中的文件以及 .storyboard 的相应部分,以创建自定义消息显示方式。

更新 podfile 以使用修改后的 InAppMessaging 代码

如需让 Firebase In-App Messaging 使用修改后的消息显示方式(而不是默认显示方式),请更新您的 podfile 以使用自定义的 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
完成后,您可以更新 pod 并重新构建您的应用,这样即会实现新的自定义消息显示方式。

创建自己的消息显示库

您并非只能使用 InAppMessaging 库来创建用于显示消息的界面。您也可以从头开始编写自己的代码。

构建一个实现 InAppMessagingDisplay 协议的类

Firebase In-App Messaging 使用 InAppMessaging 类处理 Firebase 服务器和您的应用。该类又会使用 InAppMessagingDisplay 协议来显示它收到的消息。 如需构建您自己的显示库,请编写一个实现该协议的类。

如需了解协议定义以及如何遵循该协议,请查看 InAppMessaging 库的 FIRInAppMessagingDisplay.h 文件。

messageDisplayComponent 设置为使用您的消息显示库

InAppMessaging 使用其 messageDisplayComponent 属性来确定在显示消息时要使用的对象。将该属性设置为自定义 消息显示类,以便 Firebase In-App Messaging 知道要使用您的库来呈现消息:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance