Firebase アプリ内メッセージングを使ってみる

このクイックスタートでは、Firebase アプリ内メッセージングを設定して最初のメッセージを送信する方法について説明します。

はじめに

事前に次の環境を準備しておく必要があります。

  • Firebase が有効なアプリ: まだ iOS プロジェクトに Firebase を追加していない場合は追加します。
  • Xcode 9.2 以降: Firebase アプリ内メッセージングを実行するには、比較的新しいバージョンの Xcode が必要です。最新バージョンの Xcode は Apple の Xcode サイトにあります。
  • CocoaPods 1.4.0 以降: Firebase アプリ内メッセージングでは、CocoaPods を使用して iOS 上での依存関係を管理します。CocoaPods は CocoaPods サイトからインストールできます。

プロジェクトに Firebase アプリ内メッセージング SDK を追加する

始めに、Firebase アプリ内メッセージング CocoaPods を追加して、Firebase アプリ内メッセージング 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/InAppMessagingDisplay'
end
  3. ターミナルで、ポッドの依存関係をインストールします。
    pod install
  4. Xcode でアプリのプロジェクトを開きます。
    open YOUR-PROJECT.xcworkspace
  5. Firebase モジュールがまだインポートされていない場合は、UIApplicationDelegate の中でインポートします。
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  6. また、FirebaseApp 共有インスタンスをまだ構成していない場合は構成します。通常はアプリの application:didFinishLaunchingWithOptions: メソッドで行います。
    Swift
    // Use Firebase library to configure APIs
FirebaseApp.configure()
    Objective-C
    // Use Firebase library to configure APIs
[FIRApp configure];
  7. アプリをコンパイルして実行します。

テスト メッセージを送信する

アプリのインスタンス ID を取得する

電力を節約するため、Firebase アプリ内メッセージングはサーバーからのメッセージの取得を 1 日に 1 回だけ行います。この設定の場合、テストが困難になることがあるため、メッセージをオンデマンドで表示するテストデバイスを Firebase コンソールで指定できます。

このテストデバイスは FirebaseInstanceID によって決定されます。テスト用アプリのインスタンス 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 Instance ID YOUR_APP_ID

テストデバイスにメッセージを送る

テストデバイスでアプリを起動し、そのインスタンス ID を取得したら、テスト メッセージを送信して Firebase アプリ内メッセージングの設定を試すことができます。

  1. Firebase コンソールで [In-App Messaging] を開きます。
  2. [新しいキャンペーンを作成] をクリックします。
  3. 最初のメッセージのタイトルを入力します。
  4. [端末でテスト] をクリックします。
  5. [インスタンス ID の追加] フィールドにアプリのインスタンス ID を入力します。
  6. [テスト] をクリックしてメッセージを送信します。

[テスト] をクリックするとすぐに Firebase アプリ内メッセージングからテスト用メッセージが送信されます。このメッセージを表示するには、テストデバイスでアプリを閉じてから開き直します。