diff --git a/config/searchExcludeRoutes.json b/config/searchExcludeRoutes.json index a3c11679..d68df2f7 100644 --- a/config/searchExcludeRoutes.json +++ b/config/searchExcludeRoutes.json @@ -1,5 +1,10 @@ [ "/automations/automations-by-event/welcome-series", "/videolessons/automations/how-to-create-welcome-series", - "/updates/HVG123РЕ97E" + "/updates/HVG123РЕ97E", + "/other-channels/mobile-push/how-to-connect-mobile-push.mdx", + "/other-channels/mobile-push/how-to-create-mobile-push-campaign.mdx", + "/other-channels/mobile-push/how-to-create-mobile-push-campaign.mdx", + "/other-channels/mobile-push/statistics.mdx", + "/automations/automations-by-time/how-to-automate-mobile-push-campaign.mdx" ] diff --git a/docs/automations/automations-by-time/how-to-automate-mobile-push-campaign.mdx b/docs/automations/automations-by-time/how-to-automate-mobile-push-campaign.mdx new file mode 100644 index 00000000..5806dc83 --- /dev/null +++ b/docs/automations/automations-by-time/how-to-automate-mobile-push-campaign.mdx @@ -0,0 +1,93 @@ +--- +sidebar_position: 4 +sidebar_label: 'Автоматизация мобильных пушей' +description: 'Как настроить отправку Mobile Push по расписанию' +sidebar_custom_props: + { restrictedAccessHref: 'automations/automations-by-time/how-to-automate-mobile-push' } +--- + +import Details from '@theme/Details'; +import automationParameters from '/img/automations/automations-by-time/how-to-automate-mobile-push-campaign/automation-parameters.png'; + +# Как автоматизировать отправку Mobile Push уведомлений + +Для автоматизации мобильных пуш-уведомлений необходимо настроить отправку рассылки по расписанию — чтобы система отправляла уведомления по выбранному шаблону в указанное время. + +Для этого перейдите в раздел **[Автоматизации → По времени](https://app.sendsay.ru/automation/crons)** и нажмите «Создать автоматизацию», затем выберите **Автоматизация Mobile Push**. Настройка автоматизации выполняется за 6 шагов: + +## 1. Выберите получателей рассылки + +На шаге **Аудитория** укажите нужный список или сегмент получателей типа **Mobile Push**: + +![Subscribers](/img/automations/automations-by-time/how-to-automate-mobile-push-campaign/subscribers.png) + +При необходимости ограничьте аудиторию, настроив дополнительные фильтры: например, вы можете отправить рассылку только части пользователей приложения. + +## 2. Подготовьте шаблон + +На шаге **Содержимое** выберите готовый шаблон сообщения, либо создайте уведомления с нуля, используя: + +- **заголовок** — до 120 символов, +- **сообщение** — до 290 символов, +- **изображение** — файл до 1 МБ, рекомендуемые форматы — PNG, JPEG или GIF. + +
+ +Одно и то же уведомление будет выглядеть у подписчиков по-разному, так как внешний вид мобильного пуша и длина самого сообщения зависит от операционной системы устройства и размера экрана. + +Поэтому лучше не выходить за рамки **40 символов для заголовка и 80 символов для текста уведомления** — так пользователи приложения смогут просматривать содержимое мобильного пуша на разных устройствах. + +Читайте также:
+[Документация Android](https://developer.android.com/media/platform/supported-formats)
+[Документация Apple](https://developer.apple.com/design/human-interface-guidelines/managing-notifications) + +
+ +Чтобы убедиться, что уведомление выглядит именно так, как вы предполагаете, [протестируйте отправку](https://docs.sendsay.ru/other-channels/mobile-push/how-to-create-mobile-push-campaign#3-протестируйте-рассылку-опционально) рассылки (опционально). + +## 3. Настройте расписание + +Выберите периодичность и время отправки: + +- если рассылка должна уходить **ежедневно**, укажите время, +- если рассылка должна уходить **еженедельно**, укажите дни недели и время, +- если рассылка должна уходить **ежемесячно**, укажите число месяца и время отправки. + +Вы можете выбрать несколько дней и несколько вариантов времени отправки. Например: + +

+ Automation parameters +

+ +Так мобильное уведомление будет отправляться четыре раза в неделю — каждый вторник и четверг в 10:30 и в 18:30. При необходимости настройте ограничение расписания. + +## 4. Подключите дополнительные настройки (опционально) + +:::tip Важно +Для работы с дополнительными настройками необходимы навыки работы с мобильными приложениями. Чтобы настроить поведение приложения при нажатии на уведомление, обратитесь к разработчику вашего мобильного приложения. +::: + +При необходимости укажите **Дополнительные настройки**: + +- **Содержимое Data**. Укажите команду приложению в формате JSON с содержимым уведомления — заголовком, текстом и изображением. + +- **Количество попыток отправки уведомления**. Настройте количество попыток отправки уведомления в случае сбоя сервиса. По умолчанию будет совершена 1 попытка, максимальное количество попыток — 5. + +Настройки, которые сработают только для уведомлений, отправленных через Firebase: + +- **Действие после нажатия на уведомление**. Укажите действие с соответствующим `intent_filter` — оно запустится после того, как пользователь нажмёт на уведомление. + +- **Время хранения уведомления**. Укажите, как долго сообщение будет находиться в хранилище сервиса, пока устройство не подключено к интернету. По умолчанию установлено максимальное значение для FCM — 2 419 000 секунд (28 дней). + +- **Эмулировать отправку уведомлений**. Отметьте галочкой, если необходимо провалидировать идентификаторы получателей. При эмулировании сервис пуш-уведомлений получит запрос на отправку уведомления, но конечным пользователям сообщение не отправит. + +## 5. Выберите тип отправки + +На шаге **Настройки отправки** укажите, как будет отправляться уведомление: + +- **Без дополнительных настроек**, +- **Отправить по часовым поясам** — выпуск отправится каждому пользователю в его часовом поясе. Если часовой пояс в анкете подписчика не указан, рассылка отправиться по московскому времени. + +## 6. Активируйте автоматизацию + +После завершения настройки нажмите «Активировать». Вы можете сразу активировать автоматизацию, отложить запуск или указать интервал, когда автоматизация будет работать. diff --git a/docs/other-channels/mobile-push/_category_.json b/docs/other-channels/mobile-push/_category_.json new file mode 100644 index 00000000..8578cfc6 --- /dev/null +++ b/docs/other-channels/mobile-push/_category_.json @@ -0,0 +1,10 @@ +{ + "label": "Мобильные пуши", + "position": 2, + "link": { + "type": "generated-index", + "slug": "other-channels/mobile-push" + } +} + + diff --git a/docs/other-channels/mobile-push/how-to-connect-mobile-push.mdx b/docs/other-channels/mobile-push/how-to-connect-mobile-push.mdx new file mode 100644 index 00000000..4bab4108 --- /dev/null +++ b/docs/other-channels/mobile-push/how-to-connect-mobile-push.mdx @@ -0,0 +1,287 @@ +--- +sidebar_position: 1 +sidebar_label: 'Как подключить приложение' +description: 'Что такое мобильные пуши и как их подключить' +sidebar_custom_props: + { restrictedAccessHref: 'other-channels/mobile-push/how-to-connect-mobile-push' } +--- + +import Details from '@theme/Details'; +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Mobile Push уведомления: что это и как подключить приложение + +**Mobile Push уведомления** (мобильные пуши) — это короткие сообщения от мобильного приложения, которые отображаются на главном экране смартфона пользователя приложения. + +Такие уведомления обычно содержат заголовок, текст и изображение, информируя подписчиков о каких-либо событиях или действиях в приложении: + +![Example](/img/other-channels/mobile-push/how-to-connect-mobile-push/mobile-push.png) + +Отправлять такие уведомления можно всем, кто установил приложение на свой смартфон или планшет и дал разрешение на отправку уведомлений. + +
+ +Пока пользователь не предоставит разрешение на показ уведомлений вашему приложению, мобильные пуш-уведомления показываться не будут. + +На устройствах с операционными системами iOS и HarmonyOS пользователь должен дать явное разрешение на показ уведомлений от приложения. + +Если пользователь устанавливает ваше приложение на устройство под управлением Android 13 или выше, показ уведомлений от вашего приложения тоже будет по умолчанию отключён. Пользователям более ранних версий Android не нужно давать разрешение на показ уведомлений. + +
+ +Задача мобильных пуш-уведомлений — привлечь внимание получателя и вернуть его в приложение. Уведомление показывается даже на заблокированном устройстве: чтобы прочитать его, пользователю не нужно ничего нажимать дополнительно — сообщение показывается сразу. + +При нажатии на уведомление открывается приложение. Чтобы мобильные пуши выполняли свои маркетинговые цели, рекомендуем настроить реакцию приложения при нажатии на уведомление — для этого обратитесь к разработчику вашего мобильного приложения. + +## Подключение мобильного приложения + +:::tip Важно +Для подключения приложения необходимы навыки работы с мобильными приложениями. Обратитесь к разработчику вашего приложения, если не обладаете такими навыками. +::: + +Мобильные пуш-уведомления доставляются через сервисы пуш-уведомлений, которые выступают в качестве посредника между отправителями сообщений и пользователями приложения: + +- [Firebase Cloud Messaging](https://firebase.google.com/products/cloud-messaging) (FCM) — для приложений на 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. + +В самом начале необходимо зарегистрировать мобильное приложение в одном из сервисов пуш-уведомлений. + +:::tip Важно +В интерфейсе Sendsay вы можете управлять мобильным приложением, зарегистрированным в Firebase. Управление приложениями через APNS или HMS осуществляется через [API Sendsay](https://sendsay.ru/api/api.html). +::: + +К одному аккаунту Sendsay можно подключить только одно мобильное приложение. При необходимости вы можете подключить приложение через несколько сервисов пуш-уведомлений: например, если вы хотите отправлять уведомления на iOS-устройства не через Firebase, добавьте отдельное APNS-подключение. + +### Параметры подключения + +После регистрации приложения в сервисе пуш-уведомлений, получите параметры подключения, которые доступны в консоли управления приложением: + + + + +Параметры подключения можно найти в [консоли Firebase](https://console.firebase.google.com/): + +- `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. + +[Документация Firebase](https://firebase.google.com/docs) + + + + +Для отправки мобильных пуш-уведомлений через APNS рекомендуется использовать ключи аутентификации (.p8) вместо сертификатов с паролями для APNS. Это упрощает процесс аутентификации и делает его более безопасным. Параметры подключения можно найти в [Apple Developer Console](https://icloud.developer.apple.com/dashboard/notifications): + +- `app ID` — уникальный идентификатор приложения, может быть `Bundle ID`. Чтобы сгенерировать App ID, в аккаунте Apple Developer перейдите в раздел **Identifiers** и создайте новый App ID для вашего приложения. + + Убедитесь, что в настройках App ID включена опция **Push Notifications** для поддержки мобильных пуш-уведомлений. + +- `topic` — Bundle ID или App ID вашего приложения. + +- `production` — принимает значение `true` или `false` при использовании приложения в режиме разработки. + +- `key` — сертификат Production Push Certificate в Base64. Его можно получить в **Apple Developer Console → Certificates, Identifiers & Profiles → Keys → Ваше приложение**. Если вы уже создавали и скачивали сертификат, но нигде не сохранили, его возможно только перевыпустить. + +- `key_type` — тип ключа, принимает значение `pem`, `p12` или `p8`. + +- `password` — пароль к сертификату. Необходим в случае, если вы используете тип ключа `pem` или `p12`. + +- `team_id` — идентификатор вашей команды (Team ID, только для `"key_type":"p8"`), который можно найти на главной странице вашего аккаунта в Apple Developer Console. + +[Документация на сайте Apple](https://developer.apple.com/documentation/usernotifications) + + + + +Параметры для подключения можно найти в **[AppGallery Connect](https://developer.huawei.com/consumer/en/service/josp/agc/index.html#/) → My projects → Project settings → General information → App information**: + +- `App_id` — уникальный идентификатор вашего приложения, который генерируется при его создании. +- `Client secret` — секретный ключ вашего приложения, обязательный параметр. + +[Документация Huawei Developer](https://developer.huawei.com/consumer/en/doc/HMSCore-Guides/service-introduction-0000001050040060) + + + + +### Как подключить приложение в интерфейсе Sendsay + +В интерфейсе Sendsay вы можете управлять мобильным приложением, зарегистрированным в Firebase. + +[Как подключить приложение через API Sendsay](#как-подключить-приложение-через-api-sendsay) + +Чтобы подключить мобильное приложение: + +1. Перейдите в раздел **[Подписчики → Мобильное приложение](https://app.sendsay.ru/subscribers/apps)** и нажмите «Подключить», затем выберите **Firebase** в качестве сервиса пуш-уведомлений. +2. Введите название приложения и нажмите «Далее». +3. Укажите **Project ID** и **Service account key** в формате JSON: + +![Firebase](/img/other-channels/mobile-push/how-to-connect-mobile-push/firebase.png) + +Затем нажмите «Подключить». + +После подключения нажмите «Перейти к настройкам» и импортируйте пользователей приложения, чтобы отправлять им мобильные пуш-уведомления. + +[Как импортировать Mobile Push подписчиков](https://docs.sendsay.ru/other-channels/mobile-push/import-mobile-push-subscribers) + +### Как подключить приложение через API Sendsay + +Для подключения мобильного приложения к Sendsay используйте **[API-консоль](https://app.sendsay.ru/api/console)** или предоставьте [параметры подключения](#параметры-подключения) вашему аккаунт-менеджеру. + +Управление мобильными приложениями осуществляется при помощи [внешних аутентификаций API Sendsay](https://sendsay.ru/api/api.html#Внешние-аутентификации). Чтобы подключить приложение к Sendsay, создайте внешнюю аутентификацию с нужным сервисом пуш-уведомлений: + + + + +``` +{ + "action": "authext.create", + "login": "AUTH_NAME", + "type": 16, + "auth": { + "fcm": { + "project_id": "Project ID", + "key_json": "Service account key" + } + } +} +``` + +где `AUTH_NAME` — название внешней аутентификации в Sendsay. В ответе вы получите `id` — идентификатор созданной внешней аутентификации. + + + + +``` +{ + "action": "authext.create", + "login": "AUTH_NAME", + "type": 16, + "auth": { + "apns": { + "topic": topic приложения iOS, + "production": true / false, + "key": сертификат или authkey в Base64, + "key_type": "pem" | "p12" | "p8", + "key_id": key_id, // только для "key_type": "p8" + "team_id": team_id, // только для "key_type": "p8" + "password": пароль к сертификату, // кроме "key_type": "p8" + } + } +} + +``` + +где `AUTH_NAME` — название внешней аутентификации в Sendsay. В ответе вы получите `id` — идентификатор созданной внешней аутентификации. + + + + +``` +{ + "action": "authext.create", + "login": "AUTH_NAME", + "type": 16, + "auth": { + "hms": { + "hms_app_id": "App_id", + "key": "Client secret" + } + } +} +``` + +где `AUTH_NAME` — название внешней аутентификации в Sendsay. В ответе вы получите `id` — идентификатор созданной внешней аутентификации. + + + + +[Создание внешней аутентификации в API Sendsay](https://sendsay.ru/api/api.html#Создание-внешней-аутентификации) + +В случае если в вашем аккаунте уже подключен какой-то сервис, необходимо обновить внешнюю аутентификацию с указанием ID уже существующей аутентификации. + +Чтобы получить ID, выполните запрос в **[API-консоли](https://app.sendsay.ru/api/console)**: + +``` +{ + "action": "authext.list", + "filter": [ + { + "a": "authext.type", + "op": "==", + "v": "16" + } + ] +} +``` + +После этого [измените внешнюю аутентификацию](https://sendsay.ru/api/api.html#Изменение-внешней-аутентификации): + + + + +``` +{ + "action": "authext.set", + "auth": { + "fcm": { + "app_id": "Project ID", + "key": "Server key" + } + }, + "id": authext_id +} +``` + +где `authext_id` — id существующей аутентификации. + + + + +``` +{ + "action": "authext.set", + "auth": { + "apns": { + "app_id": "app ID", + "topic": "topic", + "key_type": "key_type", + "key": "XXX...", + "production": true / false, + "key_id": "key_id", // только для "key_type": "p8" + "team_id": "team_id" // только для "key_type": "p8" + } + }, + "id": authext_id +} +``` + +где `authext_id` — id существующей аутентификации. + + + + +``` +{ + "action": "authext.set", + "auth": { + "hms": { + "hms_app_id": "App_id", + "key": "Client secret" + } + }, + "id": authext_id +} +``` + +где `authext_id` — id существующей аутентификации. + + + + +После подключения вы попадёте во вкладку настроек импорта на странице приложения. Импортируйте пользователей приложения, чтобы отправлять им пуш-уведомления. + +**Читайте также:**
+[Файл для импорта Mobile Push подписчиков](https://docs.sendsay.ru/subscribers/import-and-export/how-to-prepare-file-for-import#файл-для-импорта-mobile-push-подписчиков)
+[Как импортировать Mobile Push подписчиков](https://docs.sendsay.ru/other-channels/mobile-push/import-mobile-push-subscribers) diff --git a/docs/other-channels/mobile-push/how-to-create-mobile-push-campaign.mdx b/docs/other-channels/mobile-push/how-to-create-mobile-push-campaign.mdx new file mode 100644 index 00000000..80ab2c5f --- /dev/null +++ b/docs/other-channels/mobile-push/how-to-create-mobile-push-campaign.mdx @@ -0,0 +1,117 @@ +--- +sidebar_position: 3 +sidebar_label: 'Как отправить пуш' +description: 'Как отправить пуш уведомление' +sidebar_custom_props: + { restrictedAccessHref: 'other-channels/mobile-push/how-to-create-mobile-push-campaign' } +--- + +import Details from '@theme/Details'; + +# Как отправить Mobile Push уведомление + +**Mobile Push уведомление** — это выпуск рассылки, отправленный в приложение тем пользователям, кто дал разрешение на получение уведомлений. Такое уведомление отображается на главном экране устройства пользователя приложения, даже если приложение закрыто. + +
+ +Пока пользователь не предоставит разрешение на показ уведомлений вашему приложению, мобильные пуш-уведомления показываться не будут. + +На устройствах с операционными системами iOS и HarmonyOS пользователь должен дать явное разрешение на показ уведомлений от приложения. + +Если пользователь устанавливает ваше приложение на устройство под управлением Android 13 или выше, показ уведомлений от вашего приложения тоже будет по умолчанию отключён. Пользователям более ранних версий Android не нужно давать разрешение на показ уведомлений. + +
+ +Перед отправкой уведомления необходимо зарегистрировать мобильное приложение в сервисе пуш-уведомлений, подключить к Sendsay и импортировать контакты пользователей приложения типа Mobile Push. + +[Подключение мобильного приложения](https://docs.sendsay.ru/other-channels/mobile-push/how-to-connect-mobile-push#подключение-мобильного-приложения)
+[Как импортировать Mobile Push подписчиков](https://docs.sendsay.ru/other-channels/mobile-push/import-mobile-push-subscribers) + +:::tip Важно +В интерфейсе Sendsay вы можете отправлять массовые выпуски мобильных пушей от приложений, зарегистрированных через Firebase. Для настройки и отправки триггерных и транзакционных мобильных пуш-уведомлений, а также для управления приложениями через APNS или HMS используйте [API Sendsay](https://sendsay.ru/api/api.html). +::: + +Чтобы создать массовый выпуск, перейдите в раздел **Рассылки** и нажмите «Создать выпуск», затем выберите тип **Mobile Push**: + +![How to create mobile push](/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/how-to-create-mobile-push.gif) + +Подготовка выпуска к отправке проходит в пять шагов: + +## 1. Выберите получателей рассылки + +На шаге **Аудитория** укажите нужный список или сегмент получателей типа **Mobile Push**: + +![Subscribers](/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/subscribers.png) + +При необходимости ограничьте аудиторию, настроив дополнительные фильтры: например, вы можете отправить рассылку только части пользователей приложения. Нажмите «Сохранить». + +## 2. Настройте содержимое + +Создайте содержимое уведомления. Мобильное пуш-уведомление состоит из 3 элементов: + +- **заголовок** — до 120 символов, +- **сообщение** — до 290 символов, +- **изображение** — файл до 1 МБ, рекомендуемые форматы — PNG, JPEG или GIF. + +
+ +Одно и то же уведомление будет выглядеть у подписчиков по-разному, так как внешний вид мобильного пуша и длина самого сообщения зависит от операционной системы устройства и размера экрана. + +Поэтому лучше не выходить за рамки **40 символов для заголовка и 80 символов для текста уведомления** — так пользователи приложения смогут просматривать содержимое мобильного пуша на разных устройствах. + +Читайте также:
+[Документация Android](https://developer.android.com/media/platform/supported-formats)
+[Документация Apple](https://developer.apple.com/design/human-interface-guidelines/managing-notifications) + +
+ +Предпросмотр сообщения в правой части экрана покажет, как сообщение будет отображаться на устройствах iOS, Android и Huawei: + +![Preview](/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/preview.gif) + +## 3. Протестируйте рассылку (опционально) + +Чтобы убедиться, что уведомление отображается так, как вы задумали, отправьте тестовую копию на своё устройство. Для этого нажмите «Отправить тестовую копию» и выберите контакт из списка, либо укажите контакт формата: + +``` +eUj-ZTi3QRS1qzk8aNDt3U:AIA9121bFdefFqKBzR0p1vyIxeseqD3ryk181Cew55FlXpozQ2QLedNSDxWVTfOCD5O2JVYbCmsOeO_JP9vIDAJw5IfzHCLZbLyPdinpYsBDnqYsnroV8TCg_lCkSy7IYp99_YKKale1zQ@fcm.android.209 +``` + +Затем нажмите «Отправить». + +## 4. Укажите дополнительные настройки (опционально) + +:::tip Важно +Для работы с дополнительными настройками необходимы навыки работы с мобильными приложениями. Чтобы настроить поведение приложения при нажатии на уведомление, обратитесь к разработчику вашего мобильного приложения. +::: + +При необходимости укажите **Дополнительные настройки**: + +- **Содержимое Data**. Укажите команду приложению в формате JSON с содержимым уведомления — заголовком, текстом и изображением. + +- **Количество попыток отправки уведомления**. Настройте количество попыток отправки уведомления в случае сбоя сервиса. По умолчанию будет совершена 1 попытка, максимальное количество попыток — 5. + +Настройки, которые сработают только для уведомлений, отправленных через Firebase: + +- **Действие после нажатия на уведомление**. Укажите действие с соответствующим `intent_filter` — оно запустится после того, как пользователь нажмёт на уведомление. + +- **Время хранения уведомления**. Укажите, как долго сообщение будет находиться в хранилище сервиса, пока устройство не подключено к интернету. По умолчанию установлено максимальное значение для FCM — 2 419 000 секунд (28 дней). + +- **Эмулировать отправку уведомлений**. Отметьте галочкой, если необходимо провалидировать идентификаторы получателей. При эмулировании сервис пуш-уведомлений получит запрос на отправку уведомления, но конечным пользователям сообщение не отправит. + +## 5. Выберите способ отправки + +На шаге **Отправка** выберите, когда отправить рассылку: + +- **Отправить сейчас** — выпуск отправится сразу. + +- **Запланировать отправку** — выпуск отправится в установленное время. До отправки выпуски хранятся в папке «Запланированные», где их можно редактировать. + +- **Отправить по часовым поясам** — система определит время отправки в зависимости от города, указанного в анкете подписчика. Если поле `Город` в анкете подписчика не заполнено или система не смогла определить часовой пояс, выпуск отправится в указанное время по Москве (UTC+3). + +Затем нажмите «Далее» и подтвердите отправку выпуска. + +Также вы можете [автоматизировать отправку мобильных пуш-уведомлений по расписанию](https://docs.sendsay.ru/automations/automations-by-time/how-to-automate-mobile-push-campaign). + +**Читайте также**:
+[Статистика Mobile Push уведомлений](https://docs.sendsay.ru/other-channels/mobile-push/statistics) diff --git a/docs/other-channels/mobile-push/import-mobile-push-subscribers.mdx b/docs/other-channels/mobile-push/import-mobile-push-subscribers.mdx new file mode 100644 index 00000000..a3369774 --- /dev/null +++ b/docs/other-channels/mobile-push/import-mobile-push-subscribers.mdx @@ -0,0 +1,140 @@ +--- +sidebar_position: 2 +sidebar_label: 'Импорт подписчиков' +description: 'Как импортировать пользователей мобильного приложения' +sidebar_custom_props: + { restrictedAccessHref: 'other-channels/mobile-push/import-mobile-push-subscribers' } +--- + +# Как импортировать Mobile Push подписчиков + +Сервис пуш-уведомлений должен знать адрес устройства пользователя мобильного приложения, прежде чем отправлять уведомления на это устройство. Этот адрес принимает форму токена получателя уведомлений — он уникален как для устройства, так и для приложения. Получить токен пользователя можно только из приложения. + +В Sendsay контакты пользователй мобильного приложения хранятся под видом идентификатора `Mobile Push` в формате: + +``` +token@platform.os.authext_id +``` + +где: + +- `token` — токен пользователя приложения (содержит от 64 символов, иногда его называют `device id` или `hwid`), +- `platform` — через какой сервис пуш-уведомлений будут отправляться уведомления — `apns`, `fcm` или `hms`, +- `os` — операционная система устройства — `ios`, `android` или `huawei`, +- `authext_id` — идентификатор внешней аутентификации. + +Например: + +``` +0000F75178A7E26AE732B154ED7720DF510ABE578CFD2605B37088431E1BE2E0@fcm.ios.150 +``` + +Чтобы привести контакты Mobile Push к нужному формату, необходимо объединить данные — подробнее об этом читайте в статье [Как подготовить файл для импорта](https://docs.sendsay.ru/subscribers/import-and-export/how-to-prepare-file-for-import#файл-для-импорта-пользователей-мобильного-приложения). + +Импортировать контакты пользователей приложения в базу можно двумя способами: + +- загрузить вручную, +- настроить автоматический импорт через вебхук. + +## Как загрузить пользователей приложения вручную + +Вы можете загрузить токены пользователей приложения в базу контактов или сразу добавить их в список по типу контакта `Mobile Push` двумя способами: + +- указать ссылку на [файл с данными](https://docs.sendsay.ru/subscribers/import-and-export/how-to-prepare-file-for-import#файл-для-импорта-mobile-push-подписчиков), +- указать данные вручную. + +Для этого: + +1. Перейдите в раздел **[Подписчики → Просмотр подписчиков](https://app.sendsay.ru/subscribers/contacts)** и нажмите «Добавить подписчиков»: + + ![How to add subsribers](/img/other-channels/mobile-push/import-mobile-push-subscribers/how-to-add-subsribers.png) + + Либо создайте [список](https://docs.sendsay.ru/subscribers/lists-and-segments/what-is-list) в разделе **[Подписчики → Списки](https://app.sendsay.ru/subscribers/lists)** с типом **Mobile Push** и нажмите «Добавить подписчиков»: + + ![Subscriber list](/img/other-channels/mobile-push/import-mobile-push-subscribers/subscriber-list.gif) + +2. Укажите ссылку на [файл](https://docs.sendsay.ru/subscribers/import-and-export/how-to-prepare-file-for-import#файл-для-импорта-mobile-push-подписчиков), либо вручную добавьте контакты и другие данные через запятую. + + Каждая строка должна содержать данные одного пользователя приложения, порядок данных в строках должен быть одинаковым. В случае если у пользователя отсутствуют какие-либо данные, необходимо добавить два разделителя подряд (пробелы необязательны). Например: + + ``` + @..,Анатолий,Москва + @..,Светлана,Калуга + @..,,Санкт-Петербург + ``` + + ![Example](/img/other-channels/mobile-push/import-mobile-push-subscribers/mobile-push-contacts.png) + + Затем нажмите «Продолжить». + +3. Сопоставьте данные — для этого в каждом столбце с данными выберите нужное поле: + + ![How to match data](/img/other-channels/mobile-push/import-mobile-push-subscribers/how-to-match-data.gif) + + При необходимости укажите или создайте список, куда добавить пользователей приложения. Затем нажмите «Импортировать». + + Результаты импорта отслеживайте в **[Журнале заданий](https://app.sendsay.ru/queue)**. + +## Как настроить автоматический импорт пользователей приложения + +:::tip Важно +Для настройки автоматического импорта необходимы навыки работы с вебхуками. Обратитесь к разработчику, если не обладаете такими навыками. +::: + +Sendsay принимает данные о пользователях мобильного приложения через POST-запрос по индивидуальной ссылке с указанием информации о пользователе. +Ссылка формируется при подключении приложения в формате: + +``` +https://mobi.sendsay.ru/mobi/api/v100/json/callback/<аккаунт>/<секретный ключ>_ +``` + +Эта ссылка доступна во вкладке **Настройка приложения и импорта** на странице приложения: + +![Webhook](/img/other-channels/mobile-push/import-mobile-push-subscribers/webhook.png) + +:::tip Важно +Чтобы не обновлять подключение приложения при изменении `webhook.url`, рекомендуем передавать данные не напрямую из приложения, а через прокси-сервер. +::: + +### Параметры POST-запроса + +``` +method: POST +URL: webhook.url +{ + "action": "set", + "token": "token", + "platform": "сервис приёма пушей", + "os": "ОС", + "os_version": "версия ОС", + "list": "id группы-списка", + "dk": { + +----передача данных подписчика в анкету или ключ данных---- + "base.firstName": "Иван", + "base.lastName": "Иванов", + "base.gender": 1, + "base.birthDate": "1973-12-31", + +----привязка к существующим подписчикам--- + "member.email": ["test@kirtest.ru", "+79110123456"], + "member.umid": ["123", "abc"], +}, +} +``` + +где: + +- `webhook.url` — уникальная ссылка, которую можно найти на странице приложения во вкладке **Настройка приложения и импорта**, +- `token` — токен пользователя приложения, не короче 64 символов, +- `сервис приёма пушей` — сервис пуш-уведомлений — `fcm`, `apns` или `hms`, +- `ОС` — операционная система — `ios`, `android` или `huawei`, обязательное значение, +- `версия ОС` — операционная система `ios`, `android` или `huawei`, необязательное значение, +- `id группы-списка` — ID списка, в который импортируются подписчики, необязательное значение. + +Чтобы передать в Sendsay дополнительную информацию о пользователе и использовать её для сегментации и персонализации уведомлений, укажите значения для `base.firstName`, `base.lastName` и любых других ключей данных в Sendsay. + +При указании в `member.email` или `member.umid` идентификатора существующего подписчика, данные объединятся в одну карточку (необязательное значение). + +**Читайте также**:
+[Как отправить Mobile Push уведомление](https://docs.sendsay.ru/other-channels/mobile-push/how-to-create-mobile-push-campaign) diff --git a/docs/other-channels/mobile-push/statistics.mdx b/docs/other-channels/mobile-push/statistics.mdx new file mode 100644 index 00000000..88a8d817 --- /dev/null +++ b/docs/other-channels/mobile-push/statistics.mdx @@ -0,0 +1,58 @@ +--- +sidebar_position: 4 +sidebar_label: 'Статистика' +description: 'Как и где смотреть статистику пушей' +sidebar_custom_props: { restrictedAccessHref: 'other-channels/mobile-push/statistics' } +--- + +# Статистика Mobile Push уведомлений + +:::tip Важно +По умолчанию в Sendsay доступна статистика только по доставке мобильных пуш-уведомлений. Вам необходимо самостоятельно настроить вызов вебхуков из приложения. + +Для этого необходимы навыки работы с мобильными приложениями. Обратитесь к разработчику вашего приложения, если не обладаете такими навыками. +::: + +## Как настроить отслеживание событий + +Чтобы понимать, какие мобильные пуши наиболее эффективны, вы можете собирать информацию о поведении пользователей и отслеживать, какие действия они выполняют после получения мобильных пуш уведомлений — например, в Google Analytics. + +Система позволяет отслеживать: + +- **открытия** — когда уведомление отображается на экране смартфона. +- **клики** — когда подписчик нажимает на уведомление и переходит в приложение. + +Для отслеживания этих событий необходимо настроить приложение, чтобы при наступлении события отправлялся GET-запрос по соответствующей ссылке. При отправке уведомления сервер Sendsay подставляет в [data](https://firebase.google.com/docs/reference/fcm/rest/v1/projects.messages#Message.FIELDS.data) поля, которые содержат ссылки для учёта соответствующих событий: + +``` +"data": { + "sendsay_read_url": "https://...", // ссылка для учёта чтений + "sendsay_click_url": "https://..." // ссылка для учёта кликов +} +``` + +Таким образом приложение фиксирует факт нажатия на уведомление и отправляет запрос по ссылке, указанной в `sendsay_click_url`. + +## Где смотреть статистику мобильных пушей + +Чтобы посмотреть показатели по отправленным выпускам мобильных пушей, перейдите в раздел **[Статистика → Массовые рассылки](https://app.sendsay.ru/reports/campaigns)**, выберите `Mobile Push` в фильтре по типу канала и укажите необходимый период времени: + +![Statistics](/img/other-channels/mobile-push/statistics/statistics.png) + +Вы можете экспортировать отчёт по выпускам в форматах CSV, XLSX и JSON — для этого нажмите «Экспортировать» и выберите нужный формат в выпадающем меню: + +![Export](/img/other-channels/mobile-push/statistics/export.png) + +При нажатии на любой выпуск в таблице вы попадёте в отчёт по конкретному выпуску: + +![Campaign statistics](/img/other-channels/mobile-push/statistics/campaign-statistics.png) + +Здесь есть 3 вкладки: + +- **Сводка** — в этой вкладке можно посмотреть общую сводку по отправленному выпуску, его аудиторию, содержимое выпуска на разных ОС, а также охват аудитории по городам; +- **Доставка** — отчёты доставки до получателей и ошибки доставки, если они есть; +- **Переходы** — открытия мобильных пушей с последующим переходом в приложение — за период или по подписчикам. + +**Читайте также:**
+[Где следить за статистикой](https://docs.sendsay.ru/statistics/where-to-track-statistics)
+[Всё про статистические отчёты](https://docs.sendsay.ru/statistics/all-about-campaign-reports) diff --git a/docs/other-channels/sms/_category_.json b/docs/other-channels/sms/_category_.json index 07924fe5..201e2124 100644 --- a/docs/other-channels/sms/_category_.json +++ b/docs/other-channels/sms/_category_.json @@ -1,6 +1,6 @@ { "label": "SMS-рассылки", - "position": 4, + "position": 5, "link": { "type": "generated-index", "slug": "other-channels/sms" diff --git a/docs/other-channels/telegram/_category_.json b/docs/other-channels/telegram/_category_.json index e046cec2..b0967ec0 100644 --- a/docs/other-channels/telegram/_category_.json +++ b/docs/other-channels/telegram/_category_.json @@ -1,6 +1,6 @@ { "label": "Рассылки в Телеграме", - "position": 3, + "position": 4, "link": { "type": "generated-index", "slug": "other-channels/telegram" diff --git a/docs/other-channels/vk/_category_.json b/docs/other-channels/vk/_category_.json index 5c769ab7..4b72a316 100644 --- a/docs/other-channels/vk/_category_.json +++ b/docs/other-channels/vk/_category_.json @@ -1,6 +1,6 @@ { "label": "Рассылки ВКонтакте", - "position": 2, + "position": 3, "link": { "type": "generated-index", "slug": "other-channels/vk" diff --git a/docs/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface.md b/docs/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface.md index a0305330..3acc8e56 100644 --- a/docs/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface.md +++ b/docs/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface.md @@ -3,27 +3,139 @@ sidebar_position: 4 sidebar_label: 'Экспорт данных и контактов' --- +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import CodeBlock from '@theme/CodeBlock'; +import schedule from '/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/schedule.png'; +import filePath from '/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/file-path.png'; + # Как экспортировать контакты в новом интерфейсе -:::tip Важно -Если вы хотите экспортировать не только контакты, но и другие данные подписчиков, это можно сделать [в предыдущем интерфейсе](https://sendsay.ru/account/#dashboard). +Экспорт позволяет выгрузить контакты и другие данные ваших подписчиков из Sendsay в файл формата CSV, XLSX, HTML или JSON. В интерфейсе это можно сделать 3 способами: -[Как экспортировать контакты и данные подписчиков](https://docs.sendsay.ru/subscribers/import-and-export/how-to-export-data-in-the-legacy-interface#как-экспортировать-данные-подписчиков) +- экспортировать контакты одного типа из списка или сегмента (например, только email-адреса подписчиков), +- экспортировать контакты и другие данные подписчиков разово, +- настроить регулярную выгрузку контактов по шаблону. + +:::tip Важно +При экспорте контактов и данных подписчиков в файл формата XLSX стоит учитывать, что такой файл поддерживает 1 048 576 строк на лист. ::: -## Как экспортировать контакты из списка или сегмента +## Как выгрузить контакты одного типа из списка или сегмента​ + +Вы можете выгрузить из списка или сегмента контакты подписчиков одного типа в формате XLSX или CSV. Например, из списка по [типу канала](https://docs.sendsay.ru/getting-started/glossary#т) **Email** система выгрузит только email-адреса подписчиков, состоящих в этом списке. + +Чтобы это сделать: + +1. Перейдите в раздел [**Подписчики → Список**](https://app.sendsay.ru/subscribers/lists) или [**Сегмент**](https://app.sendsay.ru/subscribers/segments) и выберите нужный список или сегмент: + + + + + При выборе списка нажмите «Импортировать» и выберите необходимый формат — **Экспортировать как XLSX** или **Экспортировать как CSV**. + + ![List export](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/list-export.png) + + + + + При выборе сегмента нажмите «Настроить» и выберите необходимый пункт — **Экспортировать как XLSX** или **Экспортировать как CSV**. + + ![Segment export](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/segment-export.png) + + + + +2. Следите за экспортом в [**Журнале заданий**](https://app.sendsay.ru/queue). После завершения откройте выпадающий список кнопки «Детали» и нажмите «Скачать». + +## Как выгрузить контакты и другие данные подписчиков разово + +Вы можете экспортировать контакты и данные: + +- всех ваших подписчиков в базе контактов, +- подписчиков из конкретного списка или сегмента. + +Для этого: + +1. Перейдите в раздел [**Подписчики → Экспорт**](https://app.sendsay.ru/subscribers/export) и нажмите «Экспортировать разово»: + + ![One-time export](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/one-time-export.png) + +2. На шаге **Аудитория и данные** нажмите «Изменить». Если вы хотите выгрузить данные всех подписчиков из базы, в выпадающем поле **Список или сегмент** выберите **Все подписчики**: + + ![How to export all subscribers](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/all-subscribers.png) + + В случае если необходимо выгрузить данные подписчиков конкретного списка или сегмента, укажите этот список или сегмент. + +3. В полях ниже укажите [данные анкет](https://docs.sendsay.ru/subscribers/subscriber-data/data-groups), которые необходимо экспортировать: + + ![Subscriber data](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/subscriber-data.png) + + Вы можете настроить порядок отображения данных в экспортируемом файле — для этого перетаскивайте поля и меняйте их местами: + + ![Data order](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/data-order.gif) + + Затем нажмите «Сохранить». + +4. На шаге **Куда** нажмите «Изменить» и выберите директорию для сохранения файла с данными, укажите имя и формат — CSV, XLSX, HTML или JSON: + + ![Result retention](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/result-retention.gif) + + Имя файла должно быть уникальным, поэтому рекомендуем использовать дату и время экспорта в названии файла. В противном случае последующие экспорты будут сохраняться с этим же названием, перезаписывая предыдущий файл. + +5. Когда оба шага заполнены, нажмите «Экспортировать»: + + ![How to export](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/how-to-export.png) + +6. Следите за экспортом в [**Журнале заданий**](https://app.sendsay.ru/queue). После завершения откройте выпадающий список кнопки «Детали» и нажмите «Скачать». + +## Как настроить регулярный экспорт по шаблону + +Чтобы автоматизировать экспорт подписчиков и других данных, необходимо настроить регулярную выгрузку контактов и других данных подпсичиков по расписанию. Для этого: + +1. Перейдите в раздел [**Подписчики → Экспорт**](https://app.sendsay.ru/subscribers/export) и нажмите «Создать регулярный экспорт»: + + ![Regular export](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/regular-export.png) + +2. На шаге **Аудитория и данные** нажмите «Изменить»: + + - если вы хотите выгрузить данные всех подписчиков из базы, в выпадающем поле **Список или сегмент** выберите **Все подписчики**, + - в случае если необходимо выгрузить данные подписчиков конкретного списка или сегмента, укажите этот список или сегмент. + +3. В полях ниже укажите [данные анкет](https://docs.sendsay.ru/subscribers/subscriber-data/data-groups), которые необходимо экспортировать. При необходимости настройте порядок отображения данных в экспортируемом файле — для этого перетаскивайте поля и меняйте их местами: + + ![Export data](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/export-data.gif) + + Затем нажмите «Сохранить». + +4. На шаге **Расписание** выберите периодичность и время экспорта: + + - если контакты должны загружаться **ежедневно**, укажите время, + - если контакты должны загружаться **еженедельно**, укажите дни недели и время, + - если контакты должны загружаться **ежемесячно**, укажите число месяца и время экспорта. + + Вы можете выбрать несколько дней и несколько вариантов времени экспорта. Например: + +

+ Schedule +

+ + Так контакты будут экспортироваться четыре раза в неделю — каждый вторник и четверг в 10:30 и в 18:30. При необходимости укажите ограничения в расписании. + +5. На шаге **Куда** нажмите «Изменить». Выберите здесь директорию для сохранения файла с экспортом данных, укажите имя и формат — CSV, XLSX, HTML или JSON: + +

+ File path +

+ + Имя файла должно быть уникальным, поэтому рекомендуем использовать дату и время экспорта в названии файла. В противном случае последующие экспорты будут сохраняться с этим же названием, перезаписывая предыдущий файл. -1. Откройте список или сегмент. В правом верхнем углу страницы откройте выпадающий список и выберите «Экспортировать как XLSX» или «Экспортировать как CSV». -2. Зайдите в журнал заданий — там появилось задание на экспорт выбранного списка или сегмента. Откройте выпадающее меню напротив него и выберите «Загрузить». +6. Когда все шаги заполнены, для запуска автоматизации нажмите «Активировать»: -![How to export contacts from list](/img/subscribers/import-and-export\how-to-export-contacts-in-the-new-interface/how-to-export-contacts-from-list.png)
+ ![Export activation](/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/export-activation.png) -## Как экспортировать все контакты одного типа + После активации система начнёт автоматически выгружать контакты и данные в файл по указанному расписанию. -1. Зайдите в раздел **Подписчики → Сегменты**, создайте сегмент и выберите тип контактов, который вы хотите экспортировать (email, веб-пуш, смс или CSID). -2. В новом сегменте перейдите во вкладку **Настройка условий**. Чтобы отобрать всех подписчиков с нужным контактом, на новой строке нажмите на плюсик и поставьте следующие значения: - - вместо «состоит в группе» — «имеет данные», - - в поле для ключа — пункт «OBJ Системная», подпункт «ID подписчика», - - в поле для условия — «Заполнено». -3. Нажмите «Сохранить». -4. В правом верхнем углу откройте выпадающий список и нажмите на «Экспортировать как XLSX» или «Экспортировать как CSV». +**Читайте также:**
+[Как экспортировать контакты и данные подписчиков в старом интерфейсе +](https://docs.sendsay.ru/subscribers/import-and-export/how-to-export-data-in-the-legacy-interface) diff --git a/docs/subscribers/import-and-export/how-to-prepare-file-for-import.md b/docs/subscribers/import-and-export/how-to-prepare-file-for-import.md index 4a0e8faf..e5c09f9d 100644 --- a/docs/subscribers/import-and-export/how-to-prepare-file-for-import.md +++ b/docs/subscribers/import-and-export/how-to-prepare-file-for-import.md @@ -7,14 +7,15 @@ import fieldCode from "/img/subscribers/import-and-export/how-to-prepare-file-fo import fileForAutoimport from "/img/subscribers/import-and-export/how-to-prepare-file-for-import/file-for-autoimport.png"; import fileForManualImport from "/img/subscribers/import-and-export/how-to-prepare-file-for-import/file-for-manual-import.png"; import listType from "/img/subscribers/import-and-export/how-to-prepare-file-for-import/list-type.png"; +import Details from '@theme/Details'; # Как подготовить файл для импорта -## 1. Формат файла +### 1. Формат файла -Файл должен быть формата csv, txt, xlsx или zip. +Файл должен быть формата CSV, TXT, XLSX или ZIP. -## 2. Расположение данных в файле +### 2. Расположение данных в файле На одной строке записываются данные одного подписчика, порядок данных в строках должен быть одинаковым. Требования к первой строке файла различаются в зависимости от того, как вы импортируете контакты — вручную или через автоматизацию по времени. @@ -36,7 +37,7 @@ import listType from "/img/subscribers/import-and-export/how-to-prepare-file-for File for manual import

-## 3. Разделитель данных +### 3. Разделитель данных В Excel данные записываются в ячейки таблицы, а в остальных случаях их нужно разделять запятой, точкой с запятой или табуляцией (разделитель должен быть одинаковым в каждой строке). @@ -50,7 +51,7 @@ pochta1@gmail.com, Иван, Иванов, Москва, 1970-01-21 pochta2@gmail.com, , Фёдоров, , 1980-02-14 ``` -## 4. Основной контакт +### 4. Основной контакт В файле должен быть один контакт, который заполнен у всех подписчиков (он называется основной контакт). Это может быть: @@ -69,7 +70,7 @@ pochta2@gmail.com, , Фёдоров, , 1980-02-14 ![How to choose list during import](/img/subscribers/import-and-export\how-to-prepare-file-for-import/how-to-choose-list-during-import.gif)
-## 5. Формат записи дат и телефонных номеров +### 5. Формат записи дат и телефонных номеров Даты указываются в формате ГГГГ-ММ-ДД. Например, для даты «1 июля 1993 года» запись будет такой: @@ -79,7 +80,7 @@ pochta2@gmail.com, , Фёдоров, , 1980-02-14 Телефонные номера можно указывать в любом виде — со скобками, пробелами или цифры подряд. В российских номерах код страны указывать необязательно, а если он есть, то допустим в любом виде — 7, +7 или 8. Номера других стран нужно писать в полном виде. -## 6. Какие данные не загружаются +### 6. Какие данные не загружаются Чтобы исключить из импорта конкретного подписчика, добавьте символ # в начало строки. @@ -97,4 +98,65 @@ pochta2@gmail.com, , Фёдоров, , 1980-02-14 Страны надо указывать только на русском языке, иначе они не будут загружены ::: -**Читайте также:** [Как настроить параметры импорта](https://docs.sendsay.ru/subscribers/import-and-export/how-to-import-subscribers#2-настройте-параметры-импорта) +## Файл для импорта Mobile Push подписчиков + +Контакты пользователей мобильного приложения хранятся в Sendsay под видом контакта `Mobile Push` в формате: + +``` +token@platform.os.authext_id +``` + +где: + +- `token` — токен пользователя приложения, содержит от 64 символов, +- `platform` указывает, через какой сервис пуш-уведомлений будут отправляться уведомления — `apns`, `fcm` или `hms`, +- `os` — операционная система приложения — `ios`, `android` или `huawei`, +- `authext_id` — идентификатор внешней авторизации. + +Например: + +``` +0000F75178A7E26AE732B154ED7720DF510ABE578CFD2605B37088431E1BE2E0@fcm.ios.150 +``` + +Чтобы привести контакты к нужному формату, необходимо объединить данные. + +
+ +«Склеить» данные для каждого контакта можно в таблицах с помощью формулы, — например, в Exel или в [Google Sheets](https://workspace.google.com/intl/ru/products/sheets/). Как это сделать: + +1. Укажите токены пользователей мобильного приложения `token` в первом столбце таблицы — по одному токену на каждую ячейку. +2. В верхней ячейке второго столбца укажите сервис пуш-уведомлений — `apns`, `fcm` или `hms`. +3. В третьем столбце укажите операционную систему — `ios`, `android` или `huawei`. +4. В четвёртом столбце укажите идентификатор внешней авторизации. +5. Скопируйте ячейки 2–4 вниз на весь столбец, протянув их за правый нижний угол первой ячейки: + + ![How to prepare mobile push contacts](/img/subscribers/import-and-export/how-to-prepare-file-for-import/how-to-prepare-mobile-push-contacts.gif) + +6. В верхней ячейке следующего столбца введите знак равенства `=` и укажите формулу для объединения ячеек: + + ``` + =<первая ячейка>&"@"&<вторая ячейка>&"."&<третья ячейка>&"."&<четвёртая ячейка> + ``` + + где `&` — знак для объединения ячеек, а символы в кавычках (`”@”` или `”.”`) объединяют символы внутри ячеек. + + В нашем примере формула будет такой: + + ``` + =A1&"@"&B1&"."&C1&"."&D1 + ``` + + Затем нажмите клавишу ввода — формула автоматически преобразуется в нужное значение. Скопируйте ячейку с формулой вниз на весь столбец% + + ![Mobile push contacts](/img/subscribers/import-and-export/how-to-prepare-file-for-import/how-to-prepare-mobile-push-contacts1.gif) + + Так вы получите столбец с идентификаторами получателей мобильных пуш-уведомлений в нужном формате. Перенесите их в файл формата CSV, TXT, XLSX или ZIP для импорта Mobile Push подписчиков в Sendsay. + +
+ +Укажите идентификаторы Mobile Push подписчиков в первом столбце файла, в следующих столбцах — другие данные пользователей. Каждая строка должна содержать данные одного пользователя приложения, порядок данных в строках должен быть одинаковым. В остальном требования к оформлению файла не отличаются от обычного импорта подписчиков. + +**Читайте также:**
+[Как импортировать Mobile Push подписчиков](https://docs.sendsay.ru/other-channels/mobile-push/import-mobile-push-subscribers)
+[Как настроить параметры импорта](https://docs.sendsay.ru/subscribers/import-and-export/how-to-import-subscribers#2-настройте-параметры-импорта) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/automations/automations-by-time/how-to-automate-mobile-push-campaign.mdx b/i18n/en/docusaurus-plugin-content-docs/current/automations/automations-by-time/how-to-automate-mobile-push-campaign.mdx new file mode 100644 index 00000000..f0f79600 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/automations/automations-by-time/how-to-automate-mobile-push-campaign.mdx @@ -0,0 +1,7 @@ +--- +hide_title: true +--- + +import { Redirect } from '@docusaurus/router'; + +; diff --git a/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/how-to-connect-mobile-push.mdx b/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/how-to-connect-mobile-push.mdx new file mode 100644 index 00000000..f0f79600 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/how-to-connect-mobile-push.mdx @@ -0,0 +1,7 @@ +--- +hide_title: true +--- + +import { Redirect } from '@docusaurus/router'; + +; diff --git a/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/how-to-create-mobile-push-campaign.mdx b/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/how-to-create-mobile-push-campaign.mdx new file mode 100644 index 00000000..f0f79600 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/how-to-create-mobile-push-campaign.mdx @@ -0,0 +1,7 @@ +--- +hide_title: true +--- + +import { Redirect } from '@docusaurus/router'; + +; diff --git a/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/import-mobile-push-subscribers.mdx b/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/import-mobile-push-subscribers.mdx new file mode 100644 index 00000000..f0f79600 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/import-mobile-push-subscribers.mdx @@ -0,0 +1,7 @@ +--- +hide_title: true +--- + +import { Redirect } from '@docusaurus/router'; + +; diff --git a/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/statistics.mdx b/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/statistics.mdx new file mode 100644 index 00000000..f0f79600 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/other-channels/mobile-push/statistics.mdx @@ -0,0 +1,7 @@ +--- +hide_title: true +--- + +import { Redirect } from '@docusaurus/router'; + +; diff --git a/static/img/automations/automations-by-time/how-to-automate-mobile-push-campaign/automation-parameters.png b/static/img/automations/automations-by-time/how-to-automate-mobile-push-campaign/automation-parameters.png new file mode 100644 index 00000000..ffc02f68 Binary files /dev/null and b/static/img/automations/automations-by-time/how-to-automate-mobile-push-campaign/automation-parameters.png differ diff --git a/static/img/automations/automations-by-time/how-to-automate-mobile-push-campaign/subscribers.png b/static/img/automations/automations-by-time/how-to-automate-mobile-push-campaign/subscribers.png new file mode 100644 index 00000000..3b85324e Binary files /dev/null and b/static/img/automations/automations-by-time/how-to-automate-mobile-push-campaign/subscribers.png differ diff --git a/static/img/other-channels/mobile-push/how-to-connect-mobile-push/firebase.png b/static/img/other-channels/mobile-push/how-to-connect-mobile-push/firebase.png new file mode 100644 index 00000000..3eda876f Binary files /dev/null and b/static/img/other-channels/mobile-push/how-to-connect-mobile-push/firebase.png differ diff --git a/static/img/other-channels/mobile-push/how-to-connect-mobile-push/mobile-push.png b/static/img/other-channels/mobile-push/how-to-connect-mobile-push/mobile-push.png new file mode 100644 index 00000000..90a7519d Binary files /dev/null and b/static/img/other-channels/mobile-push/how-to-connect-mobile-push/mobile-push.png differ diff --git a/static/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/how-to-create-mobile-push.gif b/static/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/how-to-create-mobile-push.gif new file mode 100644 index 00000000..079cda22 Binary files /dev/null and b/static/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/how-to-create-mobile-push.gif differ diff --git a/static/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/preview.gif b/static/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/preview.gif new file mode 100644 index 00000000..961e6a5e Binary files /dev/null and b/static/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/preview.gif differ diff --git a/static/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/subscribers.png b/static/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/subscribers.png new file mode 100644 index 00000000..3b85324e Binary files /dev/null and b/static/img/other-channels/mobile-push/how-to-create-mobile-push-campaign/subscribers.png differ diff --git a/static/img/other-channels/mobile-push/import-mobile-push-subscribers/how-to-add-subsribers.png b/static/img/other-channels/mobile-push/import-mobile-push-subscribers/how-to-add-subsribers.png new file mode 100644 index 00000000..a3e5d091 Binary files /dev/null and b/static/img/other-channels/mobile-push/import-mobile-push-subscribers/how-to-add-subsribers.png differ diff --git a/static/img/other-channels/mobile-push/import-mobile-push-subscribers/how-to-match-data.gif b/static/img/other-channels/mobile-push/import-mobile-push-subscribers/how-to-match-data.gif new file mode 100644 index 00000000..b4d56d38 Binary files /dev/null and b/static/img/other-channels/mobile-push/import-mobile-push-subscribers/how-to-match-data.gif differ diff --git a/static/img/other-channels/mobile-push/import-mobile-push-subscribers/mobile-push-contacts.png b/static/img/other-channels/mobile-push/import-mobile-push-subscribers/mobile-push-contacts.png new file mode 100644 index 00000000..6b475cfb Binary files /dev/null and b/static/img/other-channels/mobile-push/import-mobile-push-subscribers/mobile-push-contacts.png differ diff --git a/static/img/other-channels/mobile-push/import-mobile-push-subscribers/subscriber-list.gif b/static/img/other-channels/mobile-push/import-mobile-push-subscribers/subscriber-list.gif new file mode 100644 index 00000000..0ed20bf2 Binary files /dev/null and b/static/img/other-channels/mobile-push/import-mobile-push-subscribers/subscriber-list.gif differ diff --git a/static/img/other-channels/mobile-push/import-mobile-push-subscribers/webhook.png b/static/img/other-channels/mobile-push/import-mobile-push-subscribers/webhook.png new file mode 100644 index 00000000..a79d4b65 Binary files /dev/null and b/static/img/other-channels/mobile-push/import-mobile-push-subscribers/webhook.png differ diff --git a/static/img/other-channels/mobile-push/statistics/campaign-statistics.png b/static/img/other-channels/mobile-push/statistics/campaign-statistics.png new file mode 100644 index 00000000..71c4c6cf Binary files /dev/null and b/static/img/other-channels/mobile-push/statistics/campaign-statistics.png differ diff --git a/static/img/other-channels/mobile-push/statistics/export.png b/static/img/other-channels/mobile-push/statistics/export.png new file mode 100644 index 00000000..3016eaeb Binary files /dev/null and b/static/img/other-channels/mobile-push/statistics/export.png differ diff --git a/static/img/other-channels/mobile-push/statistics/statistics.png b/static/img/other-channels/mobile-push/statistics/statistics.png new file mode 100644 index 00000000..5959cd6f Binary files /dev/null and b/static/img/other-channels/mobile-push/statistics/statistics.png differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/all-subscribers.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/all-subscribers.png new file mode 100644 index 00000000..b9ef3b70 Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/all-subscribers.png differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/data-order.gif b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/data-order.gif new file mode 100644 index 00000000..d33ac93f Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/data-order.gif differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/export-activation.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/export-activation.png new file mode 100644 index 00000000..d1dc9c9d Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/export-activation.png differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/export-data.gif b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/export-data.gif new file mode 100644 index 00000000..d2e84b0d Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/export-data.gif differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/file-path.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/file-path.png new file mode 100644 index 00000000..e3ddc52c Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/file-path.png differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/how-to-export-contacts-from-list.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/how-to-export-contacts-from-list.png deleted file mode 100644 index ab41b85c..00000000 Binary files a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/how-to-export-contacts-from-list.png and /dev/null differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/how-to-export.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/how-to-export.png new file mode 100644 index 00000000..3ec4e3b7 Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/how-to-export.png differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/list-export.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/list-export.png new file mode 100644 index 00000000..d565ce28 Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/list-export.png differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/one-time-export.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/one-time-export.png new file mode 100644 index 00000000..a482f30e Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/one-time-export.png differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/regular-export.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/regular-export.png new file mode 100644 index 00000000..37637ccb Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/regular-export.png differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/result-retention.gif b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/result-retention.gif new file mode 100644 index 00000000..8bc253e7 Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/result-retention.gif differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/schedule.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/schedule.png new file mode 100644 index 00000000..fd94e94d Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/schedule.png differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/segment-export.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/segment-export.png new file mode 100644 index 00000000..d47c447d Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/segment-export.png differ diff --git a/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/subscriber-data.png b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/subscriber-data.png new file mode 100644 index 00000000..44b1146d Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-export-contacts-in-the-new-interface/subscriber-data.png differ diff --git a/static/img/subscribers/import-and-export/how-to-prepare-file-for-import/how-to-prepare-mobile-push-contacts.gif b/static/img/subscribers/import-and-export/how-to-prepare-file-for-import/how-to-prepare-mobile-push-contacts.gif new file mode 100644 index 00000000..9d0f846c Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-prepare-file-for-import/how-to-prepare-mobile-push-contacts.gif differ diff --git a/static/img/subscribers/import-and-export/how-to-prepare-file-for-import/how-to-prepare-mobile-push-contacts1.gif b/static/img/subscribers/import-and-export/how-to-prepare-file-for-import/how-to-prepare-mobile-push-contacts1.gif new file mode 100644 index 00000000..d6fa7fc3 Binary files /dev/null and b/static/img/subscribers/import-and-export/how-to-prepare-file-for-import/how-to-prepare-mobile-push-contacts1.gif differ