Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Firebase In-App Messaging 使用入门

本快速入门将向您介绍如何设置 Firebase In-App Messaging 并发送您的第一条消息。

准备工作

在开始之前,请务必将 Firebase 添加到您的 iOS 项目中

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

若要开始操作,请添加 Firebase In-App Messaging CocoaPods 来将 Firebase In-App Messaging SDK 框架文件添加到您的项目中:

  1. 打开一个新的终端窗口,然后导航到 Xcode 项目的目录。
  2. 打开 Podfile,并添加以下突出显示的行:
    # 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'
    pod 'Firebase/InAppMessaging'
    pod 'Firebase/Analytics'
    end
  3. 从终端安装 pod 的依赖项:
    pod install
  4. 在 Xcode 中打开您的应用的项目:
    open YOUR-PROJECT.xcworkspace

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

  1. UIApplicationDelegate 中导入 Firebase 模块(如果您还没有导入的话):
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. 另外,如果您尚未配置 FirebaseApp 共享实例,请执行此操作(通常在应用的 application:didFinishLaunchingWithOptions: 方法中配置):
    Swift
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    Objective-C
    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. 编译并运行您的应用。

发送测试消息

获取应用的安装 ID

为节省能耗,Firebase In-App Messaging 每天仅从服务器检索一次消息。这可能会使测试难以进行,因此 Firebase 控制台允许您指定一部测试设备来按需显示消息。

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

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

您的应用开始运行后,在 Xcode 控制台的日志中查找以下行:

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

向您的测试设备发送消息

在测试设备上启动应用并获得 Firebase 安装 ID (FID) 后,您可以通过发送测试消息来试用 Firebase In-App Messaging 设置:

  1. 在 Firebase 控制台中,打开 In-App Messaging
  2. 点击新建广告系列
  3. 为第一条消息输入标题
  4. 点击在您的设备上进行测试
  5. 添加安装 ID 字段中输入应用的 Firebase 安装 ID。
  6. 点击测试以发送消息。

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

如需确认您的设备是否为测试设备,请查找以下日志消息:

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