Firebase In-App Messaging を使ってみる

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

始める前に

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

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

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

Xcode でアプリのプロジェクトを開いたまま、[File] > [Add Packages] の順に移動します。
プロンプトが表示されたら、Firebase Apple プラットフォーム SDK リポジトリを追加します。

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

In-App Messaging ライブラリを選択します。
In-App Messaging を使用するには、Firebase プロジェクトで Google アナリティクスを有効にして、Google アナリティクス用の Firebase SDK をアプリに追加する必要があります。IDFA 収集を有効 / 無効のいずれかにしてライブラリを選択できます。
上記の作業が完了すると、Xcode は依存関係の解決とバックグラウンドでのダウンロードを自動的に開始します。

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

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

注: Firebase In-App Messaging には Firebase バージョン 5.6.0 以降が必要です。アプリのコンパイルがうまくいかない場合は、アプリのプロジェクトディレクトリで pod update を実行してみてください。ただし、このコマンドは Firebase の依存関係だけでなく、アプリのすべての依存関係を更新することに注意してください。

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

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

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

このテストデバイスは、Firebase インストールサービスによって提供される Firebase のインストール ID によって決まります。テスト用アプリのインストール ID を確認するには、ランタイムコマンドの引数 -FIRDebugEnabled を指定してアプリを実行します。

Xcode プロジェクトを開き、上部のメニューバーから [Product] > [Scheme] > [Edit scheme] の順に選択します。
ポップアップ表示されたダイアログで [Arguments] タブを開きます。
[Arguments Passed On Launch] で [+ Add items] をクリックします。
新しく作成されたフィールドに「-FIRDebugEnabled」と入力します。
[Close] をクリックし、アプリを実行します。

アプリの実行が開始されたら、Xcode コンソールのログで次の行を探します。

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

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

テストデバイスでアプリを起動し、Firebase インストール ID（FID）を取得したら、テストメッセージを送信して Firebase In-App Messaging の設定を試すことができます。

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

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

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

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