Skip to content

Commit

Permalink
fix(sendsay-docs): add segmentation (#322)
Browse files Browse the repository at this point in the history
  • Loading branch information
Ksksksksen authored Sep 17, 2024
1 parent 7ed3de3 commit 2dfed24
Show file tree
Hide file tree
Showing 13 changed files with 112 additions and 23 deletions.
46 changes: 26 additions & 20 deletions docs/other-channels/mobile-push/how-to-connect-mobile-push.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,22 +45,18 @@ import SupportLink from '@site/src/components/SupportLink';

Мобильные пуш-уведомления доставляются через сервисы пуш-уведомлений, которые выступают в качестве посредника между отправителями сообщений и пользователями приложения:

- [Firebase Cloud Messaging](https://firebase.google.com/products/cloud-messaging) (FCM) — для приложений на Android и iOS,
- [Firebase Cloud Messaging](https://firebase.google.com/products/cloud-messaging) (Firebase) — для приложений на Android и iOS,
- [Apple Push Notification Service](https://developer.apple.com/notifications/) (APNS) — для приложений на iOS.
- [HUAWEI Push Kit](https://developer.huawei.com/consumer/ru/hms/huawei-pushkit/) (HMS) — для приложений на Android, iOS и HarmonyOS.

В самом начале необходимо зарегистрировать мобильное приложение в одном из сервисов пуш-уведомлений. При необходимости вы можете подключить приложение через несколько сервисов пуш-уведомлений: например, если вы хотите отправлять уведомления на iOS-устройства не через Firebase, добавьте отдельное APNS-подключение.

:::tip Важно
В интерфейсе Sendsay вы можете управлять мобильным приложением, зарегистрированным в Firebase и APNS. Управление приложениями через HMS осуществляется через [API Sendsay](https://sendsay.ru/api/api.html).
:::

### Параметры подключения

После регистрации приложения в сервисе пуш-уведомлений получите параметры подключения, которые доступны в консоли управления приложением:

<Tabs>
<TabItem value="key1" label="FCM">
<TabItem value="key1" label="Firebase">

Параметры подключения можно найти в [консоли Firebase](https://console.firebase.google.com/):

Expand Down Expand Up @@ -108,34 +104,44 @@ import SupportLink from '@site/src/components/SupportLink';

### Как подключить приложение в интерфейсе Sendsay

В интерфейсе Sendsay вы можете управлять мобильным приложением, зарегистрированным в Firebase и APNS.

[Как подключить приложение через API Sendsay](#как-подключить-приложение-через-api-sendsay)
Чтобы подключить мобильное приложение:

<Tabs>
<TabItem value="key1" label="FCM">
<TabItem value="key1" label="Firebase">

Чтобы подключить мобильное приложение:
1. Перейдите в раздел **[Подписчики → Мобильное приложение](https://app.sendsay.ru/subscribers/apps)** и нажмите «Подключить», затем выберите **Firebase** в качестве сервиса пуш-уведомлений и нажмите «Подключить». Введите название приложения и нажмите «Далее».

Если ваше мобильное приложение уже подключено к Sendsay через другой сервис пуш-уведомлений, перейдите на его страницу. Во вкладке **Настройки приложения и импорта** выберите **Firebase** и нажмите «Подключить».

1. Перейдите в раздел **[Подписчики → Мобильное приложение](https://app.sendsay.ru/subscribers/apps)** и нажмите «Подключить», затем выберите **Firebase** в качестве сервиса пуш-уведомлений и нажмите «Подключить».
2. Введите название приложения и нажмите «Далее».
3. Укажите **Project ID** и **Service account key** в формате JSON:<br/><br/>
2. Укажите **Project ID** и **Service account key** в формате JSON:<br/><br/>
![Firebase](/img/other-channels/mobile-push/how-to-connect-mobile-push/firebase.png)

Затем нажмите «Подключить».

</TabItem>
<TabItem value="key2" label="APNS">

Чтобы подключить мобильное приложение:
1. Перейдите в раздел **[Подписчики → Мобильное приложение](https://app.sendsay.ru/subscribers/apps)** и нажмите «Подключить», затем выберите **APNS** в качестве сервиса пуш-уведомлений и нажмите «Подключить». Введите название приложения и нажмите «Далее».

Если ваше мобильное приложение уже подключено к Sendsay через другой сервис пуш-уведомлений, перейдите на его страницу. Во вкладке **Настройки приложения и импорта** выберите **APNS** и нажмите «Подключить».

1. Перейдите в раздел **[Подписчики → Мобильное приложение](https://app.sendsay.ru/subscribers/apps)** и нажмите «Подключить», затем выберите **APNS** в качестве сервиса пуш-уведомлений и нажмите «Подключить».
2. Введите название приложения и нажмите «Далее».
3. Укажите [необходимые параметры](#параметры-подключения) для подключения:<br/><br/>
2. Укажите [необходимые параметры](#параметры-подключения) для подключения:<br/><br/>
![APNS](/img/other-channels/mobile-push/how-to-connect-mobile-push/APNS.png)

Затем нажмите «Подключить».

</TabItem>
<TabItem value="key3" label="HMS">

1. Перейдите в раздел **[Подписчики → Мобильное приложение](https://app.sendsay.ru/subscribers/apps)** и нажмите «Подключить», затем выберите **HMS** в качестве сервиса пуш-уведомлений и нажмите «Подключить». Введите название приложения и нажмите «Далее».

Если ваше мобильное приложение уже подключено к Sendsay через другой сервис пуш-уведомлений, перейдите на его страницу. Во вкладке **Настройки приложения и импорта** выберите **HMS** и нажмите «Подключить».

2. Укажите **Client id** и **Client secret** для подключения:<br/><br/>
![HMS](/img/other-channels/mobile-push/how-to-connect-mobile-push/HMS.png)

Затем нажмите «Подключить».

</TabItem>
</Tabs>

Expand All @@ -150,7 +156,7 @@ import SupportLink from '@site/src/components/SupportLink';
Управление мобильными приложениями осуществляется при помощи [внешних аутентификаций API Sendsay](https://sendsay.ru/api/api.html#Внешние-аутентификации). Чтобы подключить приложение к Sendsay, создайте внешнюю аутентификацию с нужным сервисом пуш-уведомлений:

<Tabs>
<TabItem value="key1" label="FCM">
<TabItem value="key1" label="Firebase">

```
{
Expand Down Expand Up @@ -237,7 +243,7 @@ import SupportLink from '@site/src/components/SupportLink';
После этого [измените внешнюю аутентификацию](https://sendsay.ru/api/api.html#Изменение-внешней-аутентификации):

<Tabs>
<TabItem value="key1" label="FCM">
<TabItem value="key1" label="Firebase">

```
{
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 3
sidebar_position: 4
sidebar_label: 'Как отправить пуш'
description: 'Как отправить пуш уведомление'
---
Expand Down Expand Up @@ -41,6 +41,8 @@ import Details from '@theme/Details';

![Subscribers](/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/subscribers.png)

[Как настроить сегменты подписчиков мобильного приложения](https://docs.sendsay.ru/other-channels/mobile-push/segmentation)

:::tip Важно
При выборе типа **Email** или **SMS** система отберёт в список получателей все контакты типа Mobile Push из базы, которые соответствуют условиям сегмента. Тип сегмента при этом не будет учитываться.

Expand Down
72 changes: 72 additions & 0 deletions docs/other-channels/mobile-push/segmentation.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
---
sidebar_position: 3
sidebar_label: 'Как настроить сегменты'
description: 'Как настроить сегменты подписчиков мобильного приложения'
---

import appId from '/img/other-channels/mobile-push/segmentation/app-id.png';

# Как настроить сегменты подписчиков мобильного приложения

При [подключении мобильного приложения](https://docs.sendsay.ru/other-channels/mobile-push/how-to-connect-mobile-push) вы можете настраивать сегменты по конкретным условиям для отправки Mobile Push уведомлений. Так, уведомления будут получать подписчики, подходящие под эти условия.

[Что такое сегмент контактов](https://docs.sendsay.ru/subscribers/lists-and-segments/what-is-segment)
[Как отправить Mobile Push уведомление](https://docs.sendsay.ru/other-channels/mobile-push/how-to-connect-mobile-push)

Чтобы настроить сегменты, перейдите в раздел [**Подписчики → Сегменты**](https://app.sendsay.ru/subscribers/segments), нажмите «Создать сегмент», введите название для сегмента и выберите тип **Mobile Push**.

## Примеры условий для сегментов

### Сегмент подписчиков приложения с конкретной ОС

Вы можете отправлять мобильные пуш-уведомления только владельцам устройств с конкретной операционной системой — например, чтобы сообщить им об обновлении приложения.

В сегмент попадут подписчики, которые **соответствуют** каждому из условий:

```
Мобильное приложение → Операционная система → любой из → Android/iOS/Huawei
```

![Operating system segment](/img/other-channels/mobile-push/segmentation/operating-system-segment.png)

Если у вас несколько приложений, добавьте условие:

```
Мобильное приложение → ID приложения → равно → ID вашего приложения
```

![Operating system segment](/img/other-channels/mobile-push/segmentation/operating-system-segment-1.png)

ID вашего приложения можно найти в URL на странице приложения:

<p align="center">
<img width="70%" src={appId} alt="App id" />
</p>

### Сегмент подписчиков одного приложения

Если у вас подключено несколько приложений, вы можете отправить мобильные пуш-уведомления только владельцам конкретного приложения.

Например, когда у вас есть несколько списков, в каждом из которых есть подписчики разных приложений. Сегмент позволит выбрать из них тех, кто относится к конкретному приложению.

В сегмент попадут подписчики, которые **соответствуют каждому** из условий:

```
Мобильное приложение → ID приложения → равно → ID вашего приложения
Состоит в группе → ID списка или сегмента
Состоит в группе → ID списка или сегмента
Состоит в группе → ID списка или сегмента
```

![Single app segment](/img/other-channels/mobile-push/segmentation/single-app-segment.png)

Для более тонкой настройки любого сегмента вы можете выбрать из общей базы подписчиков тех приложений, которые подключены через конкретный сервис пуш-уведомлений — Firebase, APNS или HMS. Для этого добавьте условие:

```
Мобильное приложение → Сервис → любой из → FCM/AMNs/HMS
```

![Single service segment](/img/other-channels/mobile-push/segmentation/single-service-segment.png)

**Читайте также:**<br/>
[Как настроить сегменты по данным продаж](https://docs.sendsay.ru/ecom/segmentation-by-ecom-data)
2 changes: 1 addition & 1 deletion docs/other-channels/mobile-push/statistics.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 4
sidebar_position: 5
sidebar_label: 'Статистика'
description: 'Как и где смотреть статистику пушей'
---
Expand Down
4 changes: 3 additions & 1 deletion docs/subscribers/lists-and-segments/what-is-segment.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,5 +143,7 @@ sidebar_position: 2

![Segment for inactive subscribers](/img/subscribers/lists-and-segments\what-is-segment/segment-for-inactive-subscribers.gif) <br/>

**Смотрите также:**<br/>
**Читайте также:**<br/>
[Как настроить сегменты по данным продаж](https://docs.sendsay.ru/ecom/segmentation-by-ecom-data)<br/>
[Как настроить сегменты подписчиков мобильного приложения](https://docs.sendsay.ru/other-channels/mobile-push/segmentation)<br/>
Видеоурок [Как создать сегмент контактов](https://docs.sendsay.ru/videolessons/subscribers/how-to-create-a-segment)
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
hide_title: true
---

import { Redirect } from '@docusaurus/router';

<Redirect to="/404" />;
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 2dfed24

Please sign in to comment.