开始使用 Firebase 应用内消息

本快速入门向您展示了如何设置 Firebase 应用内消息并发送您的第一条消息。

符35

在你开始之前

在开始之前，请确保将 Firebase 添加到您的 Apple 项目中。

将 Firebase In-App Messaging SDK 添加到您的项目

使用 Swift Package Manager 安装和管理 Firebase 依赖项。

1. 在 Xcode 中，打开您的应用程序项目，导航至File > Add Packages 。
2. 出现提示时，添加 Firebase Apple 平台 SDK 存储库：

  https://github.com/firebase/firebase-ios-sdk

3. 选择应用内消息库。
4. 要使用应用内消息，您必须在您的 Firebase 项目中启用 Google Analytics ，并将适用于 Google Analytics 的 Firebase SDK 添加到您的应用中。您可以选择没有 IDFA 集合或有 IDFA 集合的库。
5. 完成后，Xcode 将自动开始在后台解析和下载您的依赖项。

现在，在您的应用中初始化 SDK：

1. 在您的App结构或UIApplicationDelegate中导入 Firebase 模块，如果您还没有的话：

   迅速

   import Firebase

   目标-C

   @import Firebase;

2. 还要配置一个FirebaseApp共享实例，通常在你的App的初始化器或你的应用程序委托的application(_:didFinishLaunchingWithOptions:)方法中，如果你还没有的话：

   迅速

   FirebaseApp.configure()

   目标-C

   [FIRApp configure];

3. 编译并运行您的应用程序。

发送测试消息

获取应用的安装 ID

为了节省电量，Firebase 应用内消息每天只从服务器检索一次消息。这会使测试变得困难，因此 Firebase 控制台允许您指定一个测试设备来按需显示消息。

该测试设备由 Firebase 安装服务提供的 Firebase 安装 ID 确定。要查找测试应用程序的安装 ID，请使用运行时命令参数-FIRDebugEnabled运行应用程序：

1. 打开 Xcode 项目，从顶部菜单栏中选择Product > Scheme > Edit scheme...。
2. 打开弹出对话框的参数选项卡。
3. 单击Arguments Passed On Launch下的+ 添加项目。
4. 在新创建的字段中输入“-FIRDebugEnabled”。
5. 单击Close ，然后运行您的应用程序。

一旦您的应用程序开始运行，请在 Xcode 控制台的日志中查找以下行：

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

向您的测试设备发送消息

在测试设备上启动您的应用并获得其 Firebase 安装 ID (FID) 后，您可以通过发送测试消息来试用 Firebase 应用内消息设置：

1. 在 Firebase 控制台中，打开消息页面。
2. 如果这是您的第一个广告系列，请点击创建您的第一个广告系列。
   1. 选择Firebase In-App messages并点击Create 。
3. 否则，在“广告系列”选项卡上，点击“新建广告系列” 。
   1. 选择应用内消息。
4. 为您的第一条消息输入标题。
5. 单击在设备上测试
6. 在添加安装 ID字段中输入您应用的 Firebase 安装 ID。
7. 单击测试以发送消息。

当您点击Test时，Firebase In-App Messaging 会立即发送您的测试消息。要查看消息，您需要在测试设备上关闭然后重新打开该应用程序。

要确认您的设备是否为测试设备，请查找以下日志消息：

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.