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

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

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

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

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

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

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

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

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

  • Viber;

  • SMS;

  • Push;

  • VK.

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

  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 триллиона уникальных ссылок;

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

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

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

TLV-параметры для сокращения ссылок#

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

  • shorten_links — для сокращения ссылок в тексте отдельных сообщений;

  • shorten_list — для сокращения ссылок в текстах сообщений, входящих в каскад.

Сокращение ссылок в тексте отдельных сообщений.

TLV-параметр

Поле

Размер (октетов)

Тип

Описание

shorten_links

Tag

2

Integer

id = 0x4001

Length

2

Integer

Длина параметра в октетах.

Value

1

Octet String

Сокращение ссылок в тексте сообщения.

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