push-notification-setup

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

目次

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

概要

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/ ディレクトリにあります：

ガイド	内容
Firebase Cloud Messaging Setup	Firebase Cloud Messaging のセットアップ
iOS Native Setup with Swift	Swift を使った iOS ネイティブのセットアップ
Android Setup with Kotlin	Kotlin を使った Android のセットアップ
Flutter Implementation	Flutter の実装

ベストプラクティス

✅ DO

• 通知を送信する前に許可を求めてください
• トークンの更新処理を実装してください
• 優先度ごとに異なる通知チャンネルを使用してください
• トークンを定期的に検証してください
• 通知の配信状況を追跡してください
• ディープリンクを実装してください
• すべてのアプリ状態で通知を処理してください
• データ同期にはサイレント通知を使用してください
• バックエンドでトークンを安全に保存してください
• ユーザーが通知設定を変更できるようにしてください
• 実機でテストしてください

❌ DON'T

• 過剰な通知を送信しないでください
• 許可なく送信しないでください
• トークンを安全でない方法で保存しないでください
• 通知の失敗を無視しないでください
• ペイロードに機密データを含めないでください
• スパム目的で通知を使用しないでください
• バックグラウンド通知の処理を忘れないでください
• ハンドラー内でブロッキング呼び出しを行わないでください
• 重複した通知を送信しないでください
• ユーザーの設定を無視しないでください