Skip to content

Commit

Permalink
fix(sendsay-docs): edit mobile-push (#307)
Browse files Browse the repository at this point in the history
  • Loading branch information
Ksksksksen authored Aug 9, 2024
1 parent 2405d48 commit cf374af
Show file tree
Hide file tree
Showing 4 changed files with 48 additions and 9 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,12 @@ import automationParameters from '/img/automations/automations-by-time/how-to-au

![Subscribers](/img/automations/automations-by-time/how-to-automate-mobile-push-campaign/subscribers.png)

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

Например, при отправке Mobile Push выпуска по email-сегменту система найдёт в вашей базе все контакты типа Mobile Push (но не контакты типа Email), затем выберет из них те, которые подходят по условия сегмента, — и отправит по ним рассылку.
:::

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

## 2. Подготовьте шаблон
Expand Down Expand Up @@ -73,6 +79,11 @@ import automationParameters from '/img/automations/automations-by-time/how-to-au

- **Количество попыток отправки уведомления**. Настройте количество попыток отправки уведомления в случае сбоя сервиса. По умолчанию будет совершена 1 попытка, максимальное количество попыток — 5.

- **Вызвать ссылку при нажатии на уведомление**. Укажите параметры, которые добавятся в содержимое `data`:
- `action` — тип ссылки `app`, `browser` или `deeplink`,
- `url` — адрес ссылки.<br/><br/>
Для корректной работы этой настройки необходимо настроить поведение приложения после нажатия на уведомление с указанными данными.

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

- **Действие после нажатия на уведомление**. Укажите действие с соответствующим `intent_filter` — оно запустится после того, как пользователь нажмёт на уведомление.
Expand Down
33 changes: 25 additions & 8 deletions docs/other-channels/mobile-push/how-to-connect-mobile-push.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -49,14 +49,14 @@ import TabItem from '@theme/TabItem';
В самом начале необходимо зарегистрировать мобильное приложение в одном из сервисов пуш-уведомлений.

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

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

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

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

<Tabs>
<TabItem value="key1" label="FCM">
Expand All @@ -65,7 +65,7 @@ import TabItem from '@theme/TabItem';

- `Project ID` — уникальный идентификатор вашего проекта Firebase. Его можно найти в настройках проекта: **Project Settings → General → Project ID**.

- `Service account key` — ключ учётной записи в Firebase. Чтобы его сгенерировать, перейдите в раздел **Project Settings → Cloud Messaging → Service Account → Google Cloud Console**, затем в разделе **Service Account\* нажмите на нужный аккаунт, выберите вкладку **Keys\*\* и создайте ключ в формате JSON.
- `Service account key` — ключ учётной записи в Firebase. Чтобы его сгенерировать, перейдите в раздел **Project Settings → Cloud Messaging → Service Account → Google Cloud Console**, затем в разделе **Service Account** нажмите на нужный аккаунт, выберите вкладку **Keys** и создайте ключ в формате JSON.

[Документация Firebase](https://firebase.google.com/docs)

Expand Down Expand Up @@ -107,19 +107,36 @@ import TabItem from '@theme/TabItem';

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

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

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

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

Чтобы подключить мобильное приложение:

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

![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** в качестве сервиса пуш-уведомлений и нажмите «Подключить».
2. Введите название приложения и нажмите «Далее».
3. Укажите [необходимые параметры](#параметры-подключения) для подключения:<br/><br/>
![APNS](/img/other-channels/mobile-push/how-to-connect-mobile-push/APNS.png)

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

</TabItem>
</Tabs>

После подключения нажмите «Перейти к настройкам» и импортируйте пользователей приложения, чтобы отправлять им мобильные пуш-уведомления.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,10 +39,16 @@ import Details from '@theme/Details';

## 1. Выберите получателей рассылки

На шаге **Аудитория** укажите нужный список или сегмент получателей типа **Mobile Push**:
На шаге **Аудитория** укажите нужный список или сегмент получателей типа **Mobile Push**, **Email** или **SMS**:

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

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

Например, при отправке Mobile Push выпуска по email-сегменту система найдёт в вашей базе все контакты типа Mobile Push (но не контакты типа Email), затем выберет из них те, которые подходят по условия сегмента, — и отправит по ним рассылку.
:::

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

## 2. Настройте содержимое
Expand Down Expand Up @@ -91,6 +97,11 @@ eUj-ZTi3QRS1qzk8aNDt3U:AIA9121bFdefFqKBzR0p1vyIxeseqD3ryk181Cew55FlXpozQ2QLedNSD

- **Количество попыток отправки уведомления**. Настройте количество попыток отправки уведомления в случае сбоя сервиса. По умолчанию будет совершена 1 попытка, максимальное количество попыток — 5.

- **Вызвать ссылку при нажатии на уведомление**. Укажите параметры, которые добавятся в содержимое `data`:
- `action` — тип ссылки `app`, `browser` или `deeplink`,
- `url` — адрес ссылки.<br/><br/>
Для корректной работы этой настройки необходимо настроить поведение приложения после нажатия на уведомление с указанными данными.

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

- **Действие после нажатия на уведомление**. Укажите действие с соответствующим `intent_filter` — оно запустится после того, как пользователь нажмёт на уведомление.
Expand Down
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 cf374af

Please sign in to comment.