Firebase In-App Messaging を使ってみる

このクイックスタートでは、Firebase In-App Messaging を設定して最初のメッセージを送信する方法について説明します。


始める前に

作業を開始する前に、Apple プロジェクトに Firebase を追加していることを確認してください。

プロジェクトに Firebase In-App Messaging SDK を追加する

Swift Package Manager を使用して Firebase の依存関係のインストールと管理を行います。

  1. Xcode でアプリのプロジェクトを開いたまま、[File] > [Add Packages] の順に移動します。
  2. プロンプトが表示されたら、Firebase Apple プラットフォーム SDK リポジトリを追加します。
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. In-App Messaging ライブラリを選択します。
  5. ターゲットのビルド設定の [Other Linker Flags] セクションに -ObjC フラグを追加します。
  6. In-App Messaging を使用するには、次のことを行う必要があります。 Google Analytics を有効にする を作成し、Google アナリティクス用の Firebase SDK をアプリに追加します。以下を選択できます。 IDFA の収集がないライブラリと IDFA の収集があります
  7. 上記の作業が完了すると、Xcode は依存関係の解決とバックグラウンドでのダウンロードを自動的に開始します。

次に、アプリで SDK を初期化します。

  1. まだ行っていない場合は、Firebase モジュールを App 構造体または UIApplicationDelegate にインポートします。
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. また、FirebaseApp 共有インスタンスをまだ構成していない場合は、構成します。通常は App のイニシャライザ、またはアプリのデリゲートの application(_:didFinishLaunchingWithOptions:) メソッドで行います。
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. アプリをコンパイルして実行します。
で確認できます。

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

アプリのインストール ID を取得する

電力を節約するため、Firebase In-App Messaging はサーバーからのメッセージの取得を 1 日に 1 回だけ行います。そのためテストが難しくなるため、 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 コンソールで、[メッセージ] ページを開きます。
  2. 初めてキャンペーンを作成する場合、[最初のキャンペーンを作成] をクリックします。
    1. [Firebase In-App メッセージ] を選択し、[作成] をクリックします。
  3. それ以外の場合は、[キャンペーン] タブで [新しいキャンペーンを作成] をクリックします。
    1. [In-App Messaging] を選択します。
  4. 最初のメッセージのタイトルを入力します。
  5. [デバイスでテスト] をクリックします。
  6. [インストール ID の追加] フィールドにアプリの Firebase インストール ID を入力します。
  7. [テスト] をクリックしてメッセージを送信します。

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

デバイスがテストデバイスかどうかを確認するには、次のログ メッセージを探します。

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