获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

开始使用 Firebase 应用内消息

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

在你开始之前

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

将 Firebase 应用内消息 SDK 添加到您的项目

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

  1. 在 Xcode 中,打开您的应用项目,导航到File > Add Packages
  2. 出现提示时,添加 Firebase Apple 平台 SDK 存储库:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. 选择应用内消息库。
  5. 要使用应用内消息,您必须在 Firebase 项目中启用 Google Analytics ,并将 Firebase SDK for Google Analytics 添加到您的应用中。您可以选择没有 IDFA 集合或有 IDFA 集合的库。
  6. 完成后,Xcode 将在后台自动开始解析和下载您的依赖项。

现在,在您的应用程序中初始化 SDK:

  1. 在您的App结构或UIApplicationDelegate中导入 Firebase 模块,如果您还没有:
    迅速
    import Firebase
    Objective-C
    @import Firebase;
  2. 如果您还没有配置FirebaseApp共享实例,通常在您的App的初始化程序或您的应用委托的application(_:didFinishLaunchingWithOptions:)方法中:
    迅速
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. 编译并运行您的应用程序。

发送测试消息

获取应用的安装 ID

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

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

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

一旦您的应用程序开始运行,请在 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.