プッシュ通知のセットアップ

目次

• 概要
• 使用場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

Firebase Cloud Messaging とネイティブプラットフォームサービスを使用して、iOS および Android アプリケーション向けの包括的なプッシュ通知システムを実装します。

使用場面

• ユーザーへのリアルタイム通知の送信
• ユーザーエンゲージメント機能の実装
• 通知から特定の画面への深いリンク
• サイレント/バックグラウンド通知の処理
• 通知アナリティクスの追跡

クイックスタート

最小限の動作例:

import messaging from "@react-native-firebase/messaging";
import { Platform } from "react-native";

export async function initializeFirebase() {
  try {
    if (Platform.OS === "ios") {
      const permission = await messaging().requestPermission();
      if (permission === messaging.AuthorizationStatus.AUTHORIZED) {
        console.log("iOS notification permission granted");
      }
    }

    const token = await messaging().getToken();
    console.log("FCM Token:", token);
    await saveTokenToBackend(token);

    messaging().onTokenRefresh(async (newToken) => {
      await saveTokenToBackend(newToken);
    });

    messaging().onMessage(async (remoteMessage) => {
      console.log("Notification received:", remoteMessage);
      showLocalNotification(remoteMessage);
    });

// ... (see reference guides for full implementation)

リファレンスガイド

references/ ディレクトリの詳細な実装:

ベストプラクティス

✅ すること

• 通知を送信する前に権限をリクエストする
• トークンリフレッシュ処理を実装する
• 優先度別に異なる通知チャネルを使用する
• トークンを定期的に検証する
• 通知配信を追跡する
• 深いリンク処理を実装する
• すべてのアプリ状態で通知を処理する
• データ同期にサイレント通知を使用する
• バックエンドにトークンを安全に保存する
• ユーザー通知設定を提供する
• 実機でテストする

❌ しないこと

• 過度な通知を送信する
• 権限なしに送信する
• トークンを安全でない方法で保存する
• 通知失敗を無視する
• ペイロードに機密データを送信する
• スパムで通知を使用する
• バックグラウンド通知の処理を忘れる
• ハンドラー内でブロッキング呼び出しを行う
• 重複した通知を送信する
• ユーザー設定を無視する