# Mobile Push Overview

#### Mobile Push – Bezpośrednia komunikacja z użytkownikiem

Powiadomienia Push to krótkie wiadomości wysyłane bezpośrednio na urządzenia użytkowników posiadających Twoją aplikację. To jeden z najskuteczniejszych kanałów dotarcia, umożliwiający informowanie o aktualizacjach i promocjach nawet wtedy, gdy aplikacja działa w tle.

### **Funkcjonalności w MessageFlow**

Nasz panel i API wspierają proces zarządzania powiadomieniami Push. W zależności od metody wysyłki (API lub Kampanie w Panelu), oferujemy:

* **Wysyłka i Personalizacja**: Pełna konfiguracja treści oraz personalizacja komunikatów pod kątem potrzeb użytkowników – dostępne zarówno dla wysyłek masowych, jak i transakcyjnych API.
* **Segmentacja (Kampanie)**: Zarządzanie bazą odbiorców w panelu.
  * *Standard:* Wbudowana segmentacja statyczna (tworzenie grup na podstawie wgranych list).
  * *Add-on:* Zaawansowana segmentacja dynamiczna dostępna w ramach dodatku **MessageFlow Segments**.
* **Targetowanie**: Precyzyjna wysyłka powiadomień do zdefiniowanych grup, co znacząco podnosi efektywność kampanii.
* **Monitorowanie**: Śledzenie statusu dostarczalności wysyłanych powiadomień w czasie rzeczywistym.

### **Jak to działa?**

Aby wysyłka była możliwa, aplikacja mobilna musi nawiązać połączenie z dedykowanym serwerem powiadomień:

* iOS: Apple Push Notification Service (APNs).
* Android: Firebase Cloud Messaging (FCM).

W procesie rejestracji generowany jest unikalny token, który jednoznacznie identyfikuje urządzenie i jest kluczem do dostarczenia wiadomości. 

{% hint style="danger" %}
***Ważne**:* Użytkownik musi wyrazić zgodę na otrzymywanie powiadomień (zgodnie z przepisami).
{% endhint %}

### **Specyfikacja Techniczna**

Aby Twoje powiadomienia były skuteczne i wyświetlały się poprawnie, stosuj się do poniższych wytycznych.

**Limity znaków – Tytuł**

* iOS: maks. 35 znaków.
* Android: maks. 46 znaków.

**Limity znaków – Treść**

* Widok skrócony (przed rozwinięciem): maks. 171 znaków (najważniejsze informacje umieść na początku).

{% hint style="success" %}
***Wskazówka**: Im krótsze powiadomienie, tym bardziej angażujące.*
{% endhint %}

* Po rozwinięciu (sam tekst):
  * iOS: maks. 250 znaków.
  * Android: maks. 450 znaków.
* Po rozwinięciu (z grafiką):
  * iOS: maks. 250 znaków.
  * Android: maks. 101 znaków.

**Wymagania dla grafik (Rich Push)** \
Dozwolone formaty to .jpg, .png, .jpeg oraz .gif 

{% hint style="warning" %}
**Uwaga**: animacje GIF działają poprawnie tylko na iOS.
{% endhint %}

* Waga pliku: Maksymalnie 500 KB (zalecane dla iOS i Android).
* Wymiary:
  * Minimalne: 512×256 px.
  * Optymalne: 1024×512 px (proporcje 2:1).
  * Maksymalne: 2048×1024 px.