> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifly 開発者ガイド

> Firebase の連携と、各プラットフォーム向け Notifly SDK のインストールおよび設定手順を説明します。

Notifly は、アプリのプッシュ通知、ポップアップ、KakaoTalk、メールなど、さまざまなチャネルでのメッセージ配信と自動化を支援するマーケティングソリューションです。ユーザーの行動に応じてパーソナライズしたメッセージをリアルタイムで配信し、キャンペーンの効果を測定できます。
このガイドでは、モバイルアプリと Web アプリに Notifly を組み込むための手順を説明します。

***

## 基本情報

| 項目 | 内容 |
| - | - |
| 対応プラットフォーム | iOS, Android, React Native, Flutter, JavaScript |
| モバイルプッシュ通知の配信基盤 | Firebase Cloud Messaging (FCM) |
| 主な機能 | プッシュ通知、アプリ内ポップアップ、ユーザートラッキング、セグメンテーション |
| 自動収集データ | ユーザーセッション、デバイス情報、プッシュトークン |

### 事前準備

> モバイル SDK は、プッシュ通知に **Firebase Cloud Messaging (FCM)** を使用します。\
> モバイル SDK をインストールする前に、**Firebase プロジェクトを作成し、Notifly と連携**してください。Web の連携は、JavaScript SDK または Google Tag Manager のガイドに従ってください。

***

## クイックスタート

**1. プラットフォームに応じた準備をする**

モバイルアプリでは、Firebase プロジェクトを作成し、Notifly コンソールと連携します。Web アプリでは、JavaScript SDK または Google Tag Manager のガイドにある事前準備を行います。

**2. SDK をインストールする**

使用するプラットフォーム向けの SDK を選んでインストールします。

**3. SDK を設定する**

SDK を初期化し、ユーザー ID を設定します。

**4. 動作を確認する**

プッシュ通知とアプリ内ポップアップが正常に動作することを確認します。

***

## ユーザー属性とイベントパラメーターのキーの命名規則

`setUserProperties` に渡すカスタムユーザー属性のキーと、`trackEvent` に渡すイベントパラメーターのキーは、正規表現 `^[A-Za-z][A-Za-z0-9_]*$` に一致する必要があります。

* 先頭の文字は英大文字または英小文字（`A–Z`、`a–z`）にします。
* 2 文字目以降には、英大文字、英小文字、数字（`0–9`）、アンダースコア（`_`）のみ使用できます。
* 空白、ハングル、ピリオド（`.`）、ドル記号（`$`）、キャレット（`^`）など、その他の文字は使用できません。

カスタムキーには、`delivery_address` や `productId2` のような名前を使用してください。`$email` や `$phone_number` など、Notifly の標準ユーザー属性には、定義済みのキーをそのまま使用します。

この規則に従わないキーで送信したデータも保存されますが、一部の機能では使用できません。たとえば、`delivery.address` のようにピリオドを含むユーザー属性は、キャンペーン条件の検索、ユーザー一覧、ユーザー詳細、全ユーザーの CSV エクスポートに表示されません。**属性管理**にも表示されないため、暗号化を設定できません。詳しくは、[ユーザー属性の管理](https://docs.notifly.tech/ja/user-guide/users/properties.md#ユーザー属性とイベントパラメータのキーに使える文字)を参照してください。

***

## 最初に行う設定

> [card] [Firebase プロジェクトの連携](https://docs.notifly.tech/ja/developer-guide/firebase-integration.md)
>
> Firebase プロジェクトを作成し、Notifly と連携します。

***

## モバイル SDK

> [card] [Android SDK](https://docs.notifly.tech/ja/developer-guide/android-sdk.md)
>
> Java または Kotlin で開発したネイティブ Android アプリに組み込みます。

> [card] [iOS SDK](https://docs.notifly.tech/ja/developer-guide/ios-sdk.md)
>
> Swift または Objective-C で開発したネイティブ iOS アプリに組み込みます。

> [card] [React Native SDK](https://docs.notifly.tech/ja/developer-guide/react-native-sdk.md)
>
> React Native アプリに組み込みます。

> [card] [Flutter SDK](https://docs.notifly.tech/ja/developer-guide/flutter-sdk.md)
>
> Flutter アプリに組み込みます。

***

## Web SDK

> [card] [JavaScript SDK](https://docs.notifly.tech/ja/developer-guide/javascript-sdk.md)
>
> Web アプリに JavaScript SDK を組み込みます。

> [card] [Google Tag Manager](https://docs.notifly.tech/ja/developer-guide/google-tag-manager.md)
>
> GTM を使って Web サイトに Notifly を組み込みます。

***

## 高度な機能

> [card] [プッシュ通知の設定](https://docs.notifly.tech/ja/advanced/push-notification-icon.md)
>
> アイコン、通知許可、クリックイベントなどを設定します。

> [card] [アプリ内ポップアップ](https://docs.notifly.tech/ja/advanced/inapp-popup-event-listener.md)
>
> アプリ内ポップアップのイベントリスナーを実装します。

> [card] [Android WebViewのタイマー](https://docs.notifly.tech/ja/advanced/webview.md)
>
> Androidのアプリ内ポップアップで使用するWebViewのタイマーを制御します。

***

## テストと検証

> [card] [連携テスト](https://docs.notifly.tech/ja/integration-test.md)
>
> SDK の設定後に、連携テストと動作検証を行います。

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.