Перейти к основному содержимому
Документация для версии v73

Ресурсы подписок

Ресурс — это средство для организации подписок клиентов на определённый контент по определённым каналам связи, иными словами — издатель. Подписки на разные ресурсы не связаны: прекращение подписки на один ресурс не влияет на другие подписки и глобальный статус профиля, а значит подписчик может в личном кабинете выбрать, какой именно контент получать.

В ресурсе может быть настроен один или несколько каналов связи для формирования подписок. Ресурсом может быть:

  • сайт или отдельный лендинг,
  • мобильное или десктопное приложение,
  • форма регистрации на сайте партнёра (и сама партнёрская программа),
  • определённый тип рассылок (промо-акции, новости, полезные советы),
  • конкретная акция или продукт.

Например, если подписчика не устраивают рекламные рассылки, но интересуют информационные, то в случае использования двух ресурсов шанс сохранения потенциального клиента и заключения сделки существенно выше.

Разные ресурсы могут использовать разные домены трекинга и отправщика, имена отправителя. В "Отчётах по каналам" доступна общая группировка статистики по ресурсам, что позволяет проводить эффективный сквозной анализ разных направлений вашего маркетинга.

Управление ресурсами​

Чтобы перейти к управлению ресурсами, в главном меню выберите раздел Ресурсы.

В открывшемся списке отображаются существующие ресурсы. Чтобы перейти к редактированию, нажмите на название ресурса. Из меню действий в правой части можно просмотреть подписчиков ресурса , клонировать ресурс или удалить ресурс . Чтобы добавить новый ресурс, нажмите + Создать в верхней части страницы.

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

Основные настройки​

Для нового ресурса укажите название и опционально — описание. Для каждого ресурса настраивается:

  • Группа доступа — поместите ресурс в группу объектов аккаунта.
  • Политика отправки для ресурса — ограничить коммуникацию с одним подписчиком в рамках ресурса.
  • Базы данных — выбрать, профили каких баз данных могут подписываться на ресурс.
  • URL вебсайта, формы или приложения — URL источника подписчиков ресурса. Можно добавить дополнительные URL.
  • Трекинг-домен по умолчанию — домен для отслеживания действий подписчика с отправляемыми сообщениями. В Smart настройках кампании можно изменить эту настройку и добавить несколько трекинг-доменов.

Повышать приоритет подписки

Пользователь может подписаться на один ресурс несколько раз, указав разные контактные данные (email или номер телефона). Если вы активируете опцию "Повышать приоритет для новых подписок", то контактные данные, которые пользователь указал при последней подписке, станут приоритетными. Именно на этот email или номер будут отправляться сообщения в последующих рассылках.

Обратите внимание, опция "Повышать приоритет для новых подписок" работает только в случае, если при добавлении новой подписки явно не указан приоритет. Если приоритет новой подписки указывается явно (например, в API-запросе), то приоритеты существующих подписок не изменяются.

Категории ресурса​

Категории позволяют детализировать тип контента, на который подписан профиль. Например, ресурс "Мобильное приложение" может содержать такие категории, как "Новости", "Промо-предложения" и "Транзакции". Если клиент отпишется от одной категории ресурса, он продолжит получать сообщения в рамках других категорий. В отличие от подписки на ресурс, подписка на категорию имеет только 2 статуса: "Подписан" и "Отписан". Изменять статус вы можете вручную в профиле клиента или через API-запросы.

Чтобы добавить новую категорию в ресурс, нажмите кнопку + Создать:

Укажите произвольное имя категории и имя, которое будет использоваться в API-запросах:

Дополнительно вы можете добавить категорию в менеджер подписок, чтобы у подписчика была возможность самостоятельно управлять подписками на категории. Если получение сообщений в рамках этой категории является обязательным, активируйте опцию "Подписчик не может отписаться от категории в менеджере подписок".

Количество категорий не ограничено. Для удаление категории нажмите кнопку   .

Обратите внимание, что после сохранения ресурса вы сможете отредактировать имя категории, но не API имя.

Настройки каналов связи​

к сведению

Для одного ресурса можно добавить не более 8 каналов коммуникации!

Каждый ресурс может формировать подписки на один или несколько каналов коммуникации. По умолчанию доступно 7 каналов: Email, SMS, Push, Telegram, WhatsApp*, Viber™ и Notify. Кастомные каналы предварительно настраиваются администраторами платформы, и после этого становятся доступны для выбора. Чтобы добавить в ресурс новый канал, нажмите на плюс и выберите его из выпадающего меню:

Email канал​

Для коммуникации с клиентами по электронной почте активируйте в ресурсе Email канал, введите имя и адрес отправителя (From name и From email), а также имя и адрес для получения ответов (Reply-to name и Reply-to email) — если рассылки по этому ресурсу предполагают ответы подписчиков.

Также необходимо заполнить поле "List-ID". List-ID — это уникальный идентификатор списка рассылки, который передается в заголовке email-письма. Почтовые клиенты используют информацию из заголовка для фильтрации и сортировки входящих сообщений. Подробности стандарта List-ID можно найти по ссылке.

Введите List-Id в формате [list-label].[domain]. Примеры:

  • list-header.nisto.com
  • commonspace-users.list-id.within.com
  • 0Jks9449.list-id.cmu.edu

List-ID указывается без символов < и >. Длина идентификатора не должна превышать 255 символов. Домен должен совпадать с доменом отправителя.

к сведению

Рекомендуется использовать разные List-ID для каждого ресурса.

Настройки отписки в Email-канале

Платформа предоставляет два механизма отписки от Email-канала в ресурсе:

  1. Ссылка отписки в List-Unsubscribe — передается в заголовке письма для использования почтовыми сервисами.
  2. Ссылка отпиcки в теле письма — добавляется в шаблон с помощью переменной {unsubscribe}.

Для управления отпиской через List-unsubscribe доступны следующие настройки:

  • Не использовать list-unsubscribe в email — ссылка отписки list-unsubscribe не добавляется в параметр заголовка.
  • Вызывать URL, если была отписка через list-unsubscribe — отобразится обязательное поле "Вызываемый URL". В нем следует указать URL, на который перейдет пользователь после отписки через ссылку отписки почтового сервиса. Если URL не указывать, то пользователь перейдет на системную страницу отписки.
предупреждение

Опция отписки "Не использовать list-unsubscribe в email" доступна только для пользователей On-Premise решения. Для активации этой опции необходимо добавить параметр "unconditional_subscriber" в свойство EXTRAS в файл конфигурации main.json.

подсказка

Для коммуникации с подписчиками через email-канал используется email-адреса в формате john@example.com. Email-адрес должен соответствовать стандартам RFC. Основные требования вы найдете по этой ссылке.

SMS-канал​

Для коммуникации с клиентами по SMS активируйте в ресурсе SMS-канал и введите имя отправителя (Caller ID). Обычно его нужно согласовать с SMS провайдером, иначе он использует своё собственное имя.

подсказка

Для коммуникации с подписчиками через sms-канал используются номера телефонов. Номер должен быть указан в международном формате (без пробелов, дефисов и других разделителей, кроме плюса в начале). Пример: +79123456789

Push-канал​

Push-канал объединяет настройки push уведомлений для всех поддерживаемых платформ.

Веб-браузеры: Google Chrome, Mozilla Firefox, Apple safari и Opera browser.

Мобильные приложения: Android и iOS.

Для отправки уведомлений доступны следующие провайдеры:

  • Google Firebase Cloud Messaging — все платформы за исключением Safari.
  • Apple Push Notification Service — только Safari и iOS.
  • Mozilla Services — только Mozilla Firefox.
  • Yandex AppMetrica (доступна автоподписка при интеграции с AppMetrica) — только Android и iOS. Для отправки уведомлений AppMetrica используется Google Firebase SDK.
  • Huawei Mobile Services — Android и iOS.
  • RuStore — только Android.

Для работы с push уведомлениями активируйте в ресурсе Push-канал и выберите необходимые браузеры, платформы и провайдеры.

подсказка

Настройка push уведомлений в зависимости от провайдера подробно описана в этой статье.

Telegram Bot канал​

Используйте этот канал для отправки подписчикам сообщений через Telegram-бота. Необходимо указать токен бота. О том, как получить токен, читайте в этом гайде.

Telegram Group канал​

Сообщения в этот канал можно отправлять с помощью кампаний размещения. Укажите токен бота и идентификатор группы или канала. Больше информации о настройке канала вы найдете здесь.

WhatsApp-канал​

Чтобы отправлять подписчикам сообщения в мессенджер, необходимо настроить интеграцию с WhatsApp* Business API. Интеграция осуществляется через одного из провайдеров: Edna или 360dialog.

После настройки интеграции выберите подключенный аккаунт (360dialog) или канал (Edna) в выпадающем списке:

подсказка

Для коммуникации с подписчиками через WhatsApp*-канал используются номера телефонов. Номер должен быть указан в международном формате (без пробелов, дефисов и других разделителей, кроме плюса в начале). Пример: +79123456789

Viber™-канал​

Для отправки сообщений в Viber™ необходимо настроить интеграцию. Интеграция осуществляется через провайдеров Devino Telecom, SMS Traffic, MTS OmniChannel или Rapporto.

В настройках канала выберите созданное раннее Viber™-подключение и укажите имя отправителя. Это имя увидят подписчики при получении сообщения. Имя отправителя можно найти в личном кабинете сервиса-провайдера; оно должно быть с ним предварительно согласовано.

к сведению

Для настройки коллбэков со статусами сообщений обратитесь к менеджеру компании или в техническую поддержку вашего провайдра: Devino Telecom, SMStraffic, МТС OmniChannel или Rapporto.

подсказка

Для коммуникации с подписчиками через Viber™-канал используются номера телефонов. Номер должен быть указан в международном формате (без пробелов, дефисов и других разделителей, кроме плюса в начале). Пример: +79123456789

Notify-канал​

Сервис Notify позволяет рассылать бизнес-уведомления через VK и OK для эффективной коммуникации с клиентами. Для использования Notify в платформе необходимо предварительно настроить подключение и интеграцию сервиса.

В настройках канала выберите интегрированный раннее аккаунт Notify:

Проверьте, активен ли аккаунт, и сохраните ресурс:

Дополнительные поля в каналах подписок​

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

Чтобы создать поле, нажмите кнопку "Добавить поле" и выберите его тип:

  • Целое число — положительные и отрицательные целые числа.
  • Число с точкой — положительные и отрицательные числа с плавающей точкой.
  • Строка — текст на любом языке, включая цифры, специальные символы, пробелы. Используется стандарт Unicode.
  • Boolean — поле, которое предоставляет возможность выбора из двух вариантов True или False (Да или Нет).

Далее укажите имя поля и имя, которое будет использоваться в API-запросах. В имени допускается использование любых символов. В API-имени можно использовать только латинские символы, цифры и символ подчеркивания; также оно должно начинаться с буквы.

После создания полей вы можете использовать их для настройки триггерной кампании. Это позволит сделать её более персонализированной.

Дополнительные настройки полей:

  • Значение по умолчанию — указанное значение будет установлено в поле подписки, если не было передано других данных для этого поля.
  • Сделать обязательным — данные для этого поля необходимо будет указывать при добавлении подписки профилю.
  • Добавить в менеджер подписок — поле появится на странице менеджера подписок.

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

Настройка отписки​

Для каждого ресурса можно настроить отдельный механизм отписки. URL страницы отписки, указанный в ресурсе, переопределит системную страницу отписки. Однако если в шаблоне письма указана пользовательская ссылка на отписку, то она будет приоритетной. Подробнее о пользовательских ссылках.

Мгновенная отписка без подтверждения​

При клике на ссылку отписки профиль переходит на системную страницу отписки и его статус сразу же меняется на "Отписан". Данный тип отписки используется по умолчанию.

Вы можете перенаправлять профиль на собственную страницу отписки, указав другой URL-адрес в поле "URL страницы отписки".

Подтверждение отписки на отдельной странице​

предупреждение

Эта настройка отписки доступна только для пользователей On-Premise решения. Для активации этих настроек необходимо добавить параметр "unconditional_subscriber" в свойство EXTRAS в файл конфигурации main.json.

При клике на ссылку отписки в сообщении профиль перейдет на пользовательскую страницу отписки. Его статус изменится на "Отписан" только после этого, как он подтвердит отписку. Такая страница может использоваться для уточнения причины отписки.

Настройка полей:

Укажите "URL страницы отписки" — этот URL переопределит URL-адрес системной страницы отписки.

В URL страницы отписки добавьте параметр ID отправленного сообщения {send_message_id}. Это обязательный параметр, который позволит идентифицировать ресурс и профиль, для которого требуется осуществить отписку.

Выберите механизм отписки:

Механизм отписки с использованием Altcraft SDK

предупреждение

Этот механизм реализуется на стороне клиента (в браузере). Безопасен для размещения на странице отписки, доступной пользователю. Все операции выполняются через SDK, без передачи токенов или других чувствительных данных в открытом виде.

Вставьте предоставленный в ресурсе код на вашу страницу отписки для подключения Altcraft SDK. Далее инициализируйте класс AkUnsub. Пример:

<!-- Подключение Altcraft SDK -->
<script src="https://pxl.altkraft.com/ak_list_unsubscribe.js?id=MXw3Mw=="></script>

<!--  Инициализация AkUnsub класса -->
<script>
  const akUnsub = new AkUnsub();
</script>
к сведению

При необходимости вы можете переопределить токен ресурса и пиксель домен в скрипте:

new AkUnsub({
  rtoken: "example_token",
  pxl_domain: "your_pxl_domain",
});

Класс AkUnsub имеет 2 публичных метода:

  • confirmUnsub — метод для подтверждения отписки
  • cancelUnsub — метод для отмены отписки. Используется только для отложенной отписки, подробнее о ней можно узнать в следующем пункте статьи.

Каждый из методов принимает следующие аргументы:

  • SMID — идентификатор отправленного сообщения (обязательный параметр).
  • Массив категорий ресурса, от которых происходит отписка (необязательный параметр).

Пример:

AkUnsub.confirmUnsub("SMID", ["cat_to_unsub"]);
AkUnsub.cancelUnsub("SMID", ["cat_to_unsub"]);

Для вызова методов на страницу отписки можно добавить кнопки. Пример:

<!-- Кнопка для подтверждения отписки -->
<button onclick="akUnsub.confirmUnsub('SMID',['category_1', 'category_2'])">
  Подтвердить отписку
</button>

<!-- Кнопка для отмены отписки -->
<button onclick="akUnsub.cancelUnsub('SMID',['category_1', 'category_2'])">Отменить отписку</button>

Замените 'SMID' и ['category1', 'category2'] на соответствующие значения.

Механизм отписки без использования Altcraft SDK

предупреждение

Этот механизм реализуется на стороне сервера. Использует API-токен и токен ресурса, которые являются конфиденциальными. Их нельзя размещать в коде страницы или отправлять напрямую из браузера.

Вы можете реализовать механизм отписки на своей стороне. Для этого в URL страницы отписки необходимо добавить 2 параметра:

  • ID отправленного сообщения {send_message_id}. Это обязательный параметр, позволяющий идентифицировать ресурс, от которого требуется осуществить отписку.

  • Токен ресурса {resource_token}. Этот параметр требуется для дополнительной защиты и для реализации собственного механизма отписки без использования Altcraft SDK. Токен ресурса можно передавать не в URL страницы отписки, а в теле API-запроса. Токен можно получить в окне редактирования ресурса на вкладке "i" — детали:

Если профиль своими действиями подтвердил отписку на вашей странице, то необходимо передать эти данные в платформу с помощью API запроса /api/v1.1/profiles/message_unsub. Статус подписки профиля на ресурс изменится на "Отписан". Если передавать параметр categories, то профиль будет отписан только от указанных категорий ресурса.

Пример запроса:

{
  "token": "abcdefghijklmnqrstuvwxyz", // API-токен
  "smid": "fGmXiWU9Y4NSIpCwl4QG6QXAAAQE", // ID отправленного сообщения
  "rtoken": "2fHLS9YR9daS-a90b371eecc2952f", // Токен ресурса
  "categories": ["cat_to_unsub"] // Категории ресурса, от которых отписать профиль
}
подсказка

API запрос /api/v1.1/profiles/message_unsub описан в документации.

Запретить пользователям отписываться от ресурса​

предупреждение

Эта настройка отписки доступна только для пользователей On-Premise решения. Для активации этих настроек необходимо добавить параметр "unconditional_subscriber" в свойство EXTRAS в файл конфигурации main.json.

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

к сведению

Отписка через ссылку list-unsubscribe в Email-письме также будет запрещена.

Отложенная отписка​

При клике на ссылку отписки в сообщении профиль перейдет на пользовательскую страницу отписки. Его статус изменится на "Отписан", если:

  • профиль своими действиями подтвердит отписку;
  • профиль не отменит отписку в течение времени, заданном в поле "Таймер" (максимальное значение таймера — 30 минут).

Настройка полей:

Укажите "URL страницы отписки" — этот URL переопределит URL-адрес системной страницы отписки.

В URL страницы отписки добавьте параметр ID отправленного сообщения {send_message_id}. Это обязательный параметр, который позволит идентифицировать ресурс и профиль, для которого требуется осуществить отписку.

Выберите механизм отписки:

Механизм отписки с использованием Altcraft SDK

предупреждение

Этот механизм реализуется на стороне клиента (в браузере). Безопасен для размещения на странице отписки, доступной пользователю. Все операции выполняются через SDK, без передачи токенов или других чувствительных данных в открытом виде.

Вставьте предоставленный в ресурсе код на вашу страницу отписки для подключения Altcraft SDK. Далее инициализируйте класс AkUnsub. Пример:

<!-- Подключение Altcraft SDK -->
<script src="https://pxl.altkraft.com/ak_list_unsubscribe.js?id=MXw3Mw=="></script>

<!--  Инициализация AkUnsub класса -->
<script>
  const akUnsub = new AkUnsub();
</script>
к сведению

При необходимости вы можете переопределить токен ресурса и пиксель домен в скрипте:

new AkUnsub({
  rtoken: "example_token",
  pxl_domain: "your_pxl_domain",
});

Класс AkUnsub имеет 2 публичных метода:

  • confirmUnsub — метод для подтверждения отписки
  • cancelUnsub — метод для отмены отписки

Каждый из методов принимает следующие аргументы:

  • SMID — идентификатор отправленного сообщения (обязательный параметр).
  • Массив категорий ресурса, от которых происходит отписка (необязательный параметр).

Пример:

AkUnsub.confirmUnsub("SMID", ["cat_to_unsub"]);
AkUnsub.cancelUnsub("SMID", ["cat_to_unsub"]);

Для вызова методов на страницу отписки можно добавить кнопки. Пример:

<!-- Кнопка для подтверждения отписки -->
<button onclick="akUnsub.confirmUnsub('SMID',['category_1', 'category_2'])">
  Подтвердить отписку
</button>

<!-- Кнопка для отмены отписки -->
<button onclick="akUnsub.cancelUnsub('SMID',['category_1', 'category_2'])">Отменить отписку</button>

Замените 'SMID' и ['category1', 'category2'] на соответствующие значения.

Механизм отписки без использования Altcraft SDK

предупреждение

Этот механизм реализуется на стороне сервера. Использует API-токен и токен ресурса, которые являются конфиденциальными. Их нельзя размещать в коде страницы или отправлять напрямую из браузера.

Вы можете реализовать механизм отписки на своей стороне. Для этого в URL страницы отписки необходимо добавить 2 параметра:

  • ID отправленного сообщения {send_message_id}. Это обязательный параметр, позволяющий идентифицировать ресурс, от которого требуется осуществить отписку.

  • Токен ресурса {resource_token}. Этот параметр требуется для дополнительной защиты и для реализации собственного механизма отписки без использования Altcraft SDK. Токен ресурса можно передавать не в URL страницы отписки, а в теле API-запроса. Токен можно получить в окне редактирования ресурса на вкладке "i" — детали:

Если профиль своими действиями подтвердил отписку на вашей странице, то необходимо передать эти данные в платформу с помощью API запроса /api/v1.1/profiles/message_unsub. Статус подписки профиля на ресурс изменится на "Отписан". Если передавать параметр categories, то профиль будет отписан только от указанных категорий ресурса.

Пример запроса:

{
  "token": "abcdefghijklmnqrstuvwxyz", // API-токен
  "smid": "fGmXiWU9Y4NSIpCwl4QG6QXAAAQE", // ID отправленного сообщения
  "rtoken": "2fHLS9YR9daS-a90b371eecc2952f", // Токен ресурса
  "categories": ["cat_to_unsub"] // Категории ресурса, от которых отписать профиль
}
подсказка

API запрос /api/v1.1/profiles/message_unsub описан в документации.

*Организация Meta, которой принадлежат продукты Instagram, Facebook и WhatsApp, признана экстремистской и запрещена на территории РФ.

* Viber™ является товарным знаком Rakuten Group, Inc. Заблокирован на территории РФ.

Последнее обновление