notifications.sendMass
Отправляет сообщение с оповещением всем пользователям приложения, чьи профили соответствуют указанным критериям
Название | Обязательный | Тип | Описание |
---|---|---|---|
text | Да | | Сообщение, которое будет отправлено как оповещение пользователю. Максимальная длина текста составляет 200 символов. |
expires | Да | | Дата и время истечения срока действия этого оповещения. Формат: гггг.ММ.дд ЧЧ:мм Примечание: дата истечения срока действия должна составлять менее 14 дней от текущей даты. Используемый часовой пояс: MSK(UTC+03:00) |
status | Нет | | Одно из значений:
|
gender | Нет | | Одно из значений:
|
age_range | Нет | | Диапазон возраста (включительно). Формат: <минимальный возраст="">-<максимальный возраст="">максимальный>минимальный> |
birthday_range | Нет | | Диапазон дней рождения (включительно). Формат: ММ.дд-ММ.дд |
country | Нет | | Код страны в профиле пользователя. |
city | Нет | | Код города, возвращаемый в параметре «location.city» метода users.getInfo. |
first_access_range | Нет | | Диапазон дат первого запуска приложения пользователем (включительно). Формат: гггг.ММ.дд-гггг.ММ.дд |
last_access_range | Нет | | Диапазон дат последнего запуска приложения пользователем (включительно). Формат: гггг.ММ.дд-гггг.ММ.дд |
has_email | Нет | | Если параметр задан, ограничивает пользователей следующим образом:
|
mask | Нет | | Маска размерностью 32 бита. Подается как десятичное число. Нотификация дойдет в том случае, если результат операции побитового AND сравнения с маской пользователя не равно 0. (user.mask & notification.mask > 0) |
maskExactMatch | Нет | | Использовать строгое совпадение битов в mask и маски пользователя. (user.mask == notification.mask) |
mark | Нет | | Метка, которая будет передана приложению в параметре custom_args при переходе по нотификации |
qualifier | Нет | | Идентификатор для проведения A/B-эксперимента (см. ниже).
|
test_group | Нет | | Порядковый номер тестовой группы в A/B-эксперименте. |
test_groups | Нет | | Количество тестовых групп в A/B-эксперименте. Должно быть равно 2 |
custom_button_key | Нет | | Если параметр задан, то позволяет заменить значение теста по умолчанию на кнопке в оповещении. Например, если указано “button_accept”, то на кнопке вместо “Начать играть” будет написано “Принять”.
|
Авторизация
Сессия запрещенаНеобходимые права
- VALUABLE_ACCESS
В тексте оповещения допускается указывать не более 5 спец. символов или эмодзи
Данный тип оповещений имеет следующие ограничения:
- оповещения рассылаются только пользователям, запускавшим игру не более 7 дней назад;
- у каждого пользователя может быть не более одного активного массового оповещения от игры. При наличии нескольких массовых оповещений пользователю показывается самое новое из них
Если указывается несколько критериев фильтрации, они комбинируются с использованием логического AND. Например, если отправлено gender=MALE&age_range=20-25, то оповещение будет показано пользователям, которые соответствуют обоим условиям: пользователям мужского пола в возрасте 20 - 25 лет. Значения начала и конца диапазона являются включительными, поэтому оповещение из предыдущего примера будет показано пользователям мужского пола, возраст которых равен любому из следующих значений: 20, 21, 22, 23, 24, 25. Разрешается выполнять не более 30 рассылок в день.
Текст оповещения может содержать следующие заполнители, которые будут заменены данными пользователя, перед тем как оповещение будет показано. Поддерживаются следующие заполнители:
Заполнитель | Описание |
---|---|
${user.first-name} | Имя пользователя. Пример: Ivan |
${user.last-name} | Фамилия пользователя. Пример: Petrov |
${user.full-name} | Полное имя пользователя. Пример: Ivan Petrov |
${user.age} | Возраст пользователя. Пример: 25 |
A/B-эксперименты для нотификаций
Данный метод позволяет проводить A/B-эксперименты среди пользователей. Например, вы можете провести эксперимент с проверкой наиболее эффективного текста в оповещении, либо раздавать разным группам пользователей разные бонусы с помощью оповещений.
При проведении экспериментов мы полностью берём на себя задачу разделения пользователей на независимые и непересекающиеся экспериментальные группы, а вам лишь остается определить, сколько тестовых групп у вас будет в эксперименте, и разослать этим группам необходимые оповещения.
Одновременно вы можете проводить до 5 различных экспериментов. Уникальным идентификатором эксперимента выступает параметр qualifier. То есть, если вы проводите 2 эксперимента, то для первого эксперимента этот параметр должен быть равен game1 (или любой другой который вам нравится), а для второго - любой из оставшихся, но не равный qualifier-у первого эксперимента (для нашего примера - не game1).
В каждом эксперименте есть 2 группы пользователей, метрики по которым можно сравнивать. Они определяются параметром test_group:
- 0 - это базовая группа эксперимента;
- 1 - это экспериментальная группа эксперимента.
Эти группы пользователей не будут пересекаться, за это отвечаем мы, вам отдельно разделять пользователей не требуется.
Статистика по A/B-экспериментам
Чтобы проще было анализировать проводимые вами A/B-эксперименты, мы подготовили инструменты для получения базовой статистики по оповещениям.
Статистика доступна:
- для просмотра и скачивания отчетов в разделе игровой статистики в ОК - https://ok.ru/app/appstat
- для получения через API OK - stat.getFromServer. Статистическая таблица application_notification_exp.
Тип
Параметры приложения
Данные о сессии пользователя
|