> ## 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 developer guide

> Set up Firebase and install and configure the Notifly SDK for your platform.

Notifly is a marketing solution for sending and automating messages through channels such as app push notifications, popups, KakaoTalk, and email. You can send personalized messages in real time based on user behavior and measure campaign performance.
This guide explains how to integrate Notifly into mobile and web applications.

***

## At a glance

| Item | Value |
| - | - |
| Supported platforms | iOS, Android, React Native, Flutter, JavaScript |
| Mobile push infrastructure | Firebase Cloud Messaging (FCM) |
| Core capabilities | Push notifications, in-app popups, user tracking, segmentation |
| Automatically collected data | User sessions, device information, push tokens |

### Prerequisites

> **Important**: The mobile SDKs use Firebase Cloud Messaging (FCM) for push notifications.\
> Before you install a mobile SDK, **create a Firebase project and connect it to Notifly**. For web integrations, follow the JavaScript SDK or Google Tag Manager guide.

***

## Quick start

**1. Prepare your platform**

For mobile apps, create a Firebase project and connect it to the Notifly console. For web apps, follow the prerequisites in the JavaScript SDK or Google Tag Manager guide.

**2. Install the SDK for your platform**

Select and install the SDK for your platform.

**3. Configure the SDK**

Initialize the SDK and set the user ID.

**4. Test the integration**

Verify that push notifications and in-app popups work as expected.

***

## Naming rules for user property and event parameter keys

Custom user property keys passed to `setUserProperties` and event parameter keys passed to `trackEvent` must match `^[A-Za-z][A-Za-z0-9_]*$`.

* The first character must be an uppercase or lowercase English letter (`A–Z`, `a–z`).
* Subsequent characters can contain only English letters, digits (`0–9`), and underscores (`_`).
* Spaces, Korean characters, periods (`.`), dollar signs (`$`), carets (`^`), and other special characters are not allowed.

Use names such as `delivery_address` or `productId2` for custom keys. For built-in Notifly user properties such as `$email` and `$phone_number`, use the predefined keys exactly as provided.

Data sent with keys that do not follow these rules is still stored, but some features cannot use it. For example, a user property with a period in its key, such as `delivery.address`, does not appear in campaign condition searches, user lists, user detail pages, or full user CSV exports. It also does not appear in property management, so you cannot enable encryption for that property. See [Manage user properties](https://docs.notifly.tech/en/user-guide/users/properties.md#naming-rules-for-user-property-and-event-parameter-keys).

***

## Start here

> [card] [Connect a Firebase project](https://docs.notifly.tech/en/developer-guide/firebase-integration.md)
>
> Create a Firebase project and connect it to Notifly.

***

## Mobile SDKs

> [card] [Android SDK](https://docs.notifly.tech/en/developer-guide/android-sdk.md)
>
> Integrate native Android apps written in Java or Kotlin.

> [card] [iOS SDK](https://docs.notifly.tech/en/developer-guide/ios-sdk.md)
>
> Integrate native iOS apps written in Swift or Objective-C.

> [card] [React Native SDK](https://docs.notifly.tech/en/developer-guide/react-native-sdk.md)
>
> Integrate React Native apps across platforms.

> [card] [Flutter SDK](https://docs.notifly.tech/en/developer-guide/flutter-sdk.md)
>
> Integrate Flutter apps across platforms.

***

## Web SDK

> [card] [JavaScript SDK](https://docs.notifly.tech/en/developer-guide/javascript-sdk.md)
>
> Integrate the JavaScript SDK into a web application.

> [card] [Google Tag Manager](https://docs.notifly.tech/en/developer-guide/google-tag-manager.md)
>
> Integrate Notifly on the web with GTM.

***

## Advanced features

> [card] [Push notification settings](https://docs.notifly.tech/en/advanced/push-notification-icon.md)
>
> Configure icons, permissions, click events, and other push settings.

> [card] [In-app popups](https://docs.notifly.tech/en/advanced/inapp-popup-event-listener.md)
>
> Implement event listeners for in-app popups.

> [card] [Android WebView timers](https://docs.notifly.tech/en/advanced/webview.md)
>
> Control the WebView timers used by Android in-app popups.

***

## Testing and verification

> [card] [Integration tests](https://docs.notifly.tech/en/integration-test.md)
>
> Test and verify your integration after SDK setup.

***


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