Сервис сокращения ссылок#

Описание сервиса#

Функциональные возможности сервиса:

  • замена длинных ссылок в тексте сообщений на короткие;

  • хранение соответствия ссылок;

  • выполнение переадресации с короткой ссылки на длинную;

  • сбор статистики переходов.

Данный сервис подключается Сервис-провайдером по запросу от Партнера (см. Подключение сервиса).
После того, как Сервис-провайдер выполнит настройку Сервиса, все полученные ссылки в тексте сообщений будут сокращаться по-умолчанию в соответствии с заданными настройками.
При необходимости, данной настройкой можно управлять также при помощи опциональных параметров shortenLinks для одиночных сообщений и shorten_list для каскадной доотправки сообщений (см. Параметры запроса).
В случае, если сервис настроен, а параметр не отправлен, то ссылка будет сокращена по-умолчанию. То же касается и ссылок, переданных в каскадных сообщениях.
Ссылка сокращается с использованием домена http://kr4.me.

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

Алгоритм работы сервиса#

  1. При выявлении длинной ссылки в сообщении формируется новая ссылка - в начало новой ссылки подставляется домен http://kr4.me/ и добавляется уникальный идентификатор UID, длина которого может составлять от 3 до 8 символов. Пример ссылки после сокращения: http://kr4.me/EQiCREB.

  2. После доставки сообщений, при переходе абонентов по короткой ссылке сервис сокращения ссылок определит соответствующую длинную ссылку и осуществит переадресацию.

  3. Переходы по каждой ссылке будут фиксироваться в статистике Платформы.

Подключение сервиса#

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

  • количество символов, после которых необходимо сокращать ссылку. Например, в случае, если сокращать ссылку более 26 символов, то ссылка https://rapporto.ru/ будет передана абоненту в неизменном виде, а ссылка https://rapporto.ru/company/o_platforme_rapporto/ будет сокращена, например http://kr4.me/QEiCRE/;

  • количество символов в UID, который добавляется после домена. Данный параметр влияет на количество уникальных ссылок, которые возможно будет сформировать. Например, с длиной UID = 8 символов можно сформировать около 281 триллиона уникальных ссылок;

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

  • количество дней, по прошествии которых удаляется неактивная ссылка, если по ней не было переходов;

  • время жизни ссылки - количество дней, по прошествии которых удаляется неактивная ссылка, даже если по ней были переходы.

Сокращение ссылок при передаче каскадных сообщений#

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

Возможные варианты передачи параметра shorten_list:

  • параметр не передан в запросе – по умолчанию будут сокращены ссылки во всех типах сообщений;

  • параметр передан с пустым значением – сокращение ссылок отменено для всех типов сообщений;

  • параметр передан в запросе, и значение не пустое – сокращаются ссылки только в тех типах сообщений, которые указаны в значении параметра.