メインコンテンツへスキップ
Notifly は、プッシュ通知とアプリ内ポップアップの配信に Firebase Cloud Messaging を使用します。
  • Firebase Cloud Messaging を使用するには、Firebase プロジェクトが必要です。
  • このガイドでは、Firebase プロジェクトを作成し、Notifly と連携する手順を説明します。

1. 事前準備

1-1. Firebase プロジェクトを設定する

Firebase プロジェクトを作成し、そのプロジェクトにアプリを登録してください。

1-2. プラットフォームごとに Firebase を設定する

Flutter では、次のいずれかの方法で Firebase を設定できます。
  1. FlutterFire CLI を使ってインストールと初期化を行う(推奨)
    FlutterFire の設定ガイドを参照してください。
  2. iOS と Android で、インストールと初期化を手動で行う
    以下のAndroidタブとiOSタブの手順に従ってください。
どちらの方法でも、設定後に次のファイルがプロジェクトに含まれていることを確認してください。
  • Android: google-services.json
  • iOS: GoogleService-Info.plist

1-3. APNs 認証キーを登録する

iOS アプリでは、React Native や Flutter の場合も、Firebase プロジェクトに APNs 認証キーをアップロードしてください。 iOS デバイスにプッシュ通知を送信するには、APNs 認証キーが必要です。

2. Firebase Cloud Messaging API (V1) を有効にする

Notifly からデバイスにプッシュ通知とアプリ内ポップアップを配信するには、Firebase Cloud Messaging API (V1) を有効にする必要があります。
  1. Firebase コンソールにログインします。
  2. 左側のメニューから 設定 > 全般を開きます。
Firebase プロジェクトの設定を開く
  1. Cloud Messaging(クラウド メッセージング)タブを開きます。
  2. Firebase Cloud Messaging API (V1) が有効になっているか確認します。
    • すでに有効な場合は、セクション 3 に進み、FCM サービスアカウントを Notifly に登録してください。
  3. 無効な場合は、API の欄の右上にあるアイコンをクリックし、管理ページを開きます。
有効な Firebase Cloud Messaging API とそのメニュー
  1. Google Cloud コンソールで Firebase Cloud Messaging API を有効にします。
Firebase Cloud Messaging API を有効にする

3. FCM サービスアカウントを Notifly に登録する

Notifly と Firebase Cloud Messaging (FCM) を連携するには、メッセージの送信権限を持つサービスアカウントの JSON キーが必要です。 権限とキーを個別に管理できるように、Notifly 専用のサービスアカウントを作成してください。

FCM サービスアカウントのキーを作成する

  1. Google Cloud コンソールのサービスアカウントページを開きます。Firebase コンソールとは別の画面です。上部のプロジェクト選択で、アプリが使用する Firebase プロジェクトと同じプロジェクトを選びます。表示名が異なる場合は、Firebase のプロジェクト設定にあるプロジェクト IDを照合してください。
  2. IAM & Admin → Service Accounts(IAM と管理 → サービス アカウント)で、Create service account(サービス アカウントを作成)をクリックします。
サービスアカウントのメニューと作成ボタン
  1. サービスアカウントの名前と ID を入力し、Create and continue(作成して続行)をクリックします。たとえば、名前を Notifly、ID を notifly-fcm-sender にします。
  2. Permissions(権限)のステップで、ロールの選択欄から Firebase Cloud Messaging API Admin を検索して選びます。
Firebase Cloud Messaging API Admin ロールの選択画面(英語)
  1. Continue(続行)をクリックします。次の Principals with access(アクセス権を持つプリンシパル)は空欄のまま、Done(完了)をクリックします。
  2. サービスアカウント一覧で、作成した専用アカウントの右側のメニュー(⋮)を開き、Manage keys(鍵を管理)を選びます。
専用サービスアカウントの鍵の管理メニュー
  1. Keys(鍵)タブで、キーを追加 → 新しい鍵を作成を選びます。
鍵を追加メニューから新しい鍵を作成する
  1. キーのタイプに JSON を選び、Create(作成)をクリックします。
JSON 形式のサービスアカウントキーを作成する
  1. ダウンロードした JSON キーファイルを安全な場所に保管します。秘密鍵が含まれているため、公開リポジトリやアプリのコードには含めないでください。

Notifly コンソールにキーを登録する

  1. Notifly コンソールで、連携先のプロジェクトと開発環境または本番環境を確認します。次に設定 → チャネル設定を開き、「プッシュ通知 (App)」セクションに移動します。
  2. 新規登録する場合は登録をクリックします。登録済みのアカウントを更新する場合は、入力欄の横にある鉛筆アイコンをクリックします。設定に応じて、以下の入力欄にダウンロードしたJSONファイルの内容を貼り付けて保存します。
    • 共通のアカウントを使う場合は、FCMサービスアカウントに入力します。
    • AndroidとiOSで別々のアカウントを使う場合は、Android FCMサービスアカウントとiOS FCMサービスアカウントに入力します。新規登録時はプラットフォーム別サービスアカウントの登録をオンにすると、両方の入力欄が表示されます。
Notifly コンソールの FCM サービスアカウント設定
  1. 連携したプラットフォームのテスト端末にプッシュ通知を送り、実際に受信できることを確認します。キーの保存に成功しても、送信権限と端末への配信が確認できたことにはなりません。
既存のキーを置き換える場合は、開発環境で検証してから本番環境に適用してください。 問題が発生した場合に復元できるよう、既存の設定は安全に保管します。古いアカウントやキーを削除する前に、 他のサービスが使用していないことと、切り替えが完了していることを確認してください。