Project

General

Profile

Описание формата ссылок на покупку

История изменений

15.01.2021 Параметр для скрытия выпадающего списка у продуктов с узлами теперь также скрывает и выпадающий список для выбора количества устройств.

Базовые возможности

Ссылка на покупку – это ссылка, с помощью которой покупатель может добавить товар в корзину и перейти к оформлению заказа.
Чтобы покупатель смог воспользоваться ссылкой, её необходимо разместить на сайте или в письме.

Ссылки на покупку доступны для каждой ценовой группы продуктов вашего каталога. См. подробнее в инструкции по управлению каталогом.

Ссылки на покупку ваших продуктов можно получить на странице Кабинет разработчика > Управление корзиной > Ссылки на покупку (https://secure.allsoft.ru/shop/buylinks).

Список содержит:
  • Все программы, их версии и ценовые группы (в том числе скрытые).
  • Ссылки на покупку для каждой ценовой группы.
    Вы можете скопировать ссылку со страницы или выгрузить все ссылки в Excel.
    purchase_links.png

Если Вы не нашли ссылку для какой-либо программы, пожалуйста, проверьте, правильно ли заведена программа и указаны ли цены. Для этого перейдите на страницу Кабинет разработчика > Список программ (https://secure.allsoft.ru/author_list.php) или обратитесь за помощью в Отдел Контента.

Гибкие ссылки на покупку

Гибкие ссылки - это ссылки на покупку с дополнительными параметрами в URL, с помощью которых задаются настройки отображения продуктов в корзине.
В гибкой ссылке может быть указано несколько параметров сразу, например, количество продукта в корзине, купон и др. Для этого все необходимые параметры перечисляются после ?, разделённые знаком &.

  • Например, базовый вид ссылки имеет формат:
    В таком виде вы можете получить ссылку в Кабинете Разработчика, см. описание выше.
    https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
Пример: https://{домен_корзины}/basket/add/
123456789
  • Формат ссылки с одним дополнительным параметром будет:
    https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
    ?
    {параметр}
    =
    {значение}
  • Формат ссылки с несколькими дополнительными параметрами будет:
    https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
    ?
    {параметр 1}
    =
    {значение 1}
    &
    {параметр N}
    =
    {значение N}

С предварительной очисткой корзины

После перехода по ссылке на покупку с дополнительным параметром:
  • В корзине будут только продукты, для которых в ссылке были переданы id ценовых групп.
  • Если в корзине до этого были другие продукты - они будут удалены из неё.

Формат ссылки:

https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
clear=Y
где:
  • https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • clear=Y
    - параметр очистки корзины. Подставляемых значений нет.
Пример:
  1. Добавляем первый продукт в корзину: https://w-lab.shop.allsoftglobal.com/basket/add/4636933
  2. Добавляем второй с параметром в ссылке, первый продукт будет удалён из корзины: https://w-lab.shop.allsoftglobal.com/basket/add/4636940?clear=Y

Результат: в корзине остался только продукт 2.

С указанием нескольких продуктов

Позволяет добавить в корзину сразу несколько разных продуктов (ценовых групп).

Формат ссылки:

https://{домен_корзины}/basket/add/
?
pricegroupid
=
{id_ценовой_группы_1}
,
{id_ценовой_группы_N}
где:
  • https://{домен_корзины}/basket/add/
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • pricegroupid
    =
    {id_ценовой_группы_1}
    ,
    {id_ценовой_группы_N}
    - параметр со списком ценовых групп продуктов, которые нужно добавить в корзину:
     
    Вместо
    {id_ценовой_группы_1}
    ,
    {id_ценовой_группы_N}
    подставляются идентификаторы ценовых групп через запятую.
    Получить ID ценовых групп можно из базовых ссылок на покупку, доступных в Кабинете Разработчика.
Пример, если есть два продукта: То ссылка на добавление в корзину сразу двух продуктов будет:

С указанием количества продукта

С одной ценовой группой и её количеством

Позволяет добавить в корзину несколько шт. продукта. По умолчанию (без дополнительного параметра в ссылке на покупку) в корзину добавляется минимально допустимое количество продукта.

Формат ссылки:

https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
quantity
=
{количество}
где:
  • https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • quantity
    =
    {количество}
    - параметр количества продукта:
     
    Вместо
    {количество}
    нужно подставить количество штук продукта, которое нужно добавить в корзину.
    Например: quantity=5 - чтобы добавить 5 шт. в корзину.
Пример:

С несколькими ценовыми группами и их количеством

(!) Ценовые группы в ссылке должны идти в том же порядке, что и количество к ним.

https://{домен_корзины}/basket/add/
?
pricegroupid
=
{id_ценовой_группы_1}
,
{id_ценовой_группы_N}
&
quantity
=
{количество_1}
,
{количество_N}
где:
  • https://{домен_корзины}/basket/add/
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • pricegroupid
    =
    {id_ценовой_группы_1}
    ,
    {id_ценовой_группы_N}
    - параметр по списком ценовых групп продуктов, которые нужно добавить в корзину:
    Вместо
    {id_ценовой_группы_1}
    ,
    {id_ценовой_группы_N}
    подставляются идентификаторы ценовых групп через запятую.
  • quantity
    =
    {количество_1}
    ,
    {количество_N}
    - параметр со списком количества продуктов для каждой ценовой группы соответственно, которое нужно добавить в корзину:
    Вместо
    {количество_1}
    ,
    {количество_N}
    нужно указать сколько единиц продукта нужно добавить в корзину через запятую.
Пример, если есть два продукта:

То ссылка на добавление в корзину 5 шт. - Продукта 1 и 3 шт. - Продукта 2 будет:
https://w-lab.shop.allsoftglobal.com/basket/add/?pricegroupid=4636933,4636940&quantity=5,3&clear=Y

С количеством для части продуктов в корзине

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

(!) Важно сохранять соответствующий порядок следования ценовых групп/количества и все запятые. Если для ценовой группы не задаётся количество, то запятые сохраняются и следуют подряд.

https://{домен_корзины}/basket/add/
?
pricegroupid
=
{id_ценовой_группы_1}
,
{id_ценовой_группы_2}
,
{id_ценовой_группы_N}
&
quantity
=
{количество_1}
,,
{количество_N}
В указанном выше примере:
  • Для
    {id_ценовой_группы_1}
    - будет добавлено
    {количество_1}
    шт. продукта.
  • Для
    {id_ценовой_группы_2}
    - минимально доступное к продаже количество продукта (так как для второй позиции количество не передано).
  • Для
    {id_ценовой_группы_N}
    - будет добавлено
    {количество_N}
    шт. продукта.
Пример, если есть три продукта:
  • White label Test New license for 1 day trial - нужно добавить 5 шт. в корзину
  • White label Test New license perpetual (recommendation) - нужно добавить минимальное количество в корзину (1 шт.)
  • White label Test New license for 1 day - нужно добавить 3 шт. в корзину

То ссылка будет:
https://w-lab.shop.allsoftglobal.com/basket/add/?pricegroupid=4636937,4636940,4636934&quantity=5,,3&clear=Y

С указанием валюты корзины

Позволяет указать валюту, в которой продукт отобразится в корзине для оформления заказа.

(!) Применяется только в корзинах, где доступны продажи в нескольких валютах (см. описание в инструкции по управлению каталогом).

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

С одной ценовой группой

Формат ссылки:

https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
currency
=
{валюта}
где:
  • https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • currency
    =
    {валюта}
    - параметр с кодом валюты, в которой продукт нужно добавить в корзину:
     
    Вместо
    {валюта}
    подставляется код соответствующей валюты по ISO 4217 alpha-3, например:
    RUB - рубль; UAH – гривна; KZT – тенге; BYN – белорусский рубль; USD - доллары; EUR - евро.
    Например: currency=KZT, чтобы добавить в корзину продукт с ценой в тенге.
Пример:

С несколькими ценовыми группами

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

(!) При этом валюта указывается только 1 раз для всех продуктов:

https://{домен_корзины}/basket/add/
?
pricegroupid
=
{id_ценовой_группы_1}
,
{id_ценовой_группы_N}
&
currency
=
{валюта}
Особенности работы:
  • Если все продукты доступны для покупки в указанной валюте, то корзина откроется в заданной валюте,
  • Если хотя бы один продукт не доступен для покупки в указанной валюте, то корзина откроется так, как если бы в ссылке не было указания валюты.
Пример:

С указанием языка корзины

(!) По умолчанию не поддерживается. Если у вас есть необходимость в использовании данного функционала, обратитесь в Отдел контента для обсуждения возможности подключения. Настройка производится Отделом контента и не доступна через Кабинет разработчика.

Формат ссылки:

https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
lang
=
{язык_корзины}
где:
  • https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • lang
    =
    {язык_корзины}
    - параметр с кодом языка корзины:
     
    Вместо
    {язык_корзины}
    подставляется код соответствующего языка, например:
    ru_RU - русский, en_EN - английский. Список доступных кодов предоставляется Отделом контента при подключении.
Пример:

С указанием цены в формате "за месяц"

Цена за месяц используется для продуктов, у которых есть срок действия лицензии. При использовании цена, заданная для продукта как "NNN рублей", будет отображаться в корзине как "NNN рублей / месяц".

(!) По умолчанию не поддерживается. Если у вас есть необходимость в использовании данного функционала, обратитесь в Отдел контента для обсуждения возможности подключения.

https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
CustomID=PPMONTH
где:
  • https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • CustomID=PPMONTH
    - параметр, включающий отображение цены в формате "за месяц". Подставляемых значений нет.
Особенности использования:
  • Применяется ко всем продуктам в корзине.
  • Срок действия лицензии берётся из ценовой группы (настройка срока действия осуществляется по запросу в Отдел контента).
  • Стоимость позиции будет выведена в формате "за месяц", если:
    • срок действия задан в месяцах или годах,
    • и срок действия лицензии ≥ 1 месяца.
  • В ином случае будет стандартный формат цены (просто в валюте корзины).

Со скрытием выбора срока действия лицензии и кол-ва устройств

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

Обзор использования узлов »

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

(!) По умолчанию не поддерживается. Если у вас есть необходимость в использовании данного функционала, обратитесь в Отдел контента для обсуждения возможности подключения.

https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
CustomID=VSOFF
где:
  • https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • CustomID=VSOFF
    - параметр, скрывающий выпадающие списки для выбора срока действия лицензии и количества устройств.
Особенности использования:
  • Применяется ко всем продуктам в корзине.
  • Может быть использован совместно с другими параметрами, передающимися через CustomID. В этом случае значения указываются через запятую:
    CustomID=VSOFF
    ,
    PPMONTH
Пример:

С купоном

Купоны - один из видов скидок на продукты. Для применения скидки необходимо активировать купон в корзине.

Обзор свойств и применения купонов »
Возможно несколько режимов работы корзины:
  • Блок для ввода купона выводится всегда.
  • Блок для ввода купона скрыт.
    • Для этого случая можно включить отображение блока при добавлении в корзину определённого продукта с помощью параметра в ссылке на покупку (см. далее).

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

С активацией вручную

При переходе по ссылке в корзине будет отображён блок ввода купона, предварительно заполненный серией/номером купона. Пользователю нужно будет нажать кнопку "активировать", чтобы применить купон.

Блок будет отображён в любом режиме работы корзины (если он выводится всегда или если по умолчанию скрыт).

Формат ссылки:

Для купонов из серии и номера:
https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
coupon_seria
=
{cерия_купона}
&
{coupon_number}
=
{номер_купона}

 
Для купонов только из серии:
https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
coupon_seria
=
{cерия_купона}
где:
  • https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • coupon_seria
    =
    {cерия_купона}
    - параметр с серией купона.
    Вместо
    {cерия_купона}
    необходимо подставить серию купона.
  • {coupon_number}
    =
    {номер_купона}
    - параметр с номером купона.
    Вместо
    {номер_купона}
    необходимо подставить номер купона.

Пример, если блок купонов отображается всегда:
https://w-lab.shop.allsoftglobal.com/basket/add/4636933?coupon_seria=testwl2020&clear=Y
Результат: отобразится блок купона с предзаполненным значением серии "testwl2020".

С автоматической активацией

При переходе по ссылке купон будет применен автоматически.

  • Если блок купонов отображается всегда, то пользователь увидит сообщение, что купон с таким-то названием активирован, и скидку для продукта по купону.
  • Если блок купона скрыт, то он не будет отображён при переходе по ссылке (пользователь увидит только применённую скидку в корзине).
Формат ссылки такой же, как при активации купона вручную, но в конце нужно добавить параметр для автоматической активации:
&
auto
:
Для купонов из серии и номера:
https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
coupon_seria
=
{cерия_купона}
&
{coupon_number}
=
{номер_купона}
&
auto

 
Для купонов только из серии:
https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
coupon_seria
=
{cерия_купона}
&
auto

Пример, если блок купонов отображается всегда:
https://w-lab.shop.allsoftglobal.com/basket/add/4636933?coupon_seria=testwl2020&auto&clear=Y
Результат: отобразится блок купона с сообщением об успешной активации купона с серией "testwl2020" и в корзине появится скидка по купону.

С отображением блока ввода купона без предзаполнения

Вариант ссылки используется, если блок купона скрыт. При переходе по ссылке в корзине отобразится незаполненный блок для ввода купона.

Формат ссылки:

https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
show-coupon
где:
  • https://{домен_корзины}/basket/add/
    {id_ценовой_группы}
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • show-coupon
    - параметр отображения блока купона. Подставляемых значений нет.

Пример, если нужно показать не заполненный блок купона:
https://w-lab.shop.allsoftglobal.com/basket/add/4636933?show-coupon&clear=Y

Пример, если нужно показать блок купона с автоматическим применением:
https://w-lab.shop.allsoftglobal.com/basket/add/4636933?show-coupon&coupon_seria=testwl2020&auto&clear=Y

С указанием рефереров

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

После перехода по ссылке на покупку с реферером:
  • Рефереры фиксируются для покупателя (cookies) и если он оформляет заказ, то эти параметры фиксируются в заказе.
    Параметр сохраняется в браузере 45 дней.
  • Посмотреть сохраненные рефереры можно:
    - Через Экспорт заказов в Кабинете разработчика, подробнее.
    - Через Сервис для получения информации по заказам, подробнее.
    - В уведомлениях по заказам и подписками, подробнее.
(!) Ограничения:
  • По умолчанию не поддерживается. Если у вас есть необходимость в использовании данного функционала, обратитесь в Отдел контента для обсуждения возможности подключения.
  • Максимальное количество рефереров 6, т.е. допустимое названия параметров referer1 ... referer6.
  • Значение реферера не может быть больше 255 символов.

Формат ссылки:

https://{домен_корзины}/basket/add/
{id_ценовой_группы}
?
referer1
=
{любое_значение}
&
referer2
=
{любое_значение}
&
referer3
=
{любое_значение}
&
referer4
=
{любое_значение}
&
referer5
=
{любое_значение}
&
referer6
=
{любое_значение}

Пример:
https://w-lab.shop.allsoftglobal.com/basket/add/4636933?referer1=promo1&clear=Y

С всплывающим предложением (Up-Sell)

Up-Sell - специальное предложение, открывающееся при добавлении определенного продукта в корзину.

Обзор Up-Sell предложений »

(!) По умолчанию не поддерживается. Если у вас есть необходимость в использовании данного функционала, обратитесь в Отдел контента для обсуждения возможности подключения и настройки.

Формат ссылки:

https://{домен_корзины}/basket/add/
?
pricegroupid
=
{id_ценовой_группы}
&
show-interstitial-id
=
{id_upsale}
Где:
  • https://{домен_корзины}/basket/add/
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • pricegroupid
    =
    {id_ценовой_группы}
    - параметр с ценовой группой продукта, которую нужно добавить в корзину:
    Вместо
    {id_ценовой_группы}
    подставляется идентификатор ценовой группы.
  • show-interstitial-id
    =
    {id_upsale}
    - параметр upsale предложения, которое нужно отобразить в корзине:
    Вместо
    {id_upsale}
    подставляется идентификатор upsale предложения (предоставляется Отделом контента после заведения).

Пример:
https://w-lab.shop.allsoftglobal.com/basket/add/?pricegroupid=4636934&show-interstitial-id=209&clear=Y

С настройкой согласия на подписку

Используется для продуктов с подпиской на автоматическое продление лицензии. Для таких продуктов в корзине выводится чекбокс согласия на продление, который по умолчанию может быть включён или выключен.
Состояние чекбокса по умолчанию настраивается Отделом контента для всей корзины в целом. Но с помощью гибких ссылок может передать нужное состояние чекбокса.

Обзор подписок с автоматическим продлением лицензии »

(!) По умолчанию не поддерживается. Если у вас есть необходимость в использовании данного функционала, обратитесь в Отдел контента для обсуждения возможности подключения. Настройка подписок также производится Отделом контента и не доступна через Кабинет разработчика.

Формат ссылки:

https://{домен_корзины}/basket/add/
?
pricegroupid
=
{id_ценовой_группы}
&
auto_renew
=
{0 или 1}
Где:
  • https://{домен_корзины}/basket/add/
    - базовый url ссылки на покупку, см. выше описание способа получения.
  • pricegroupid
    =
    {id_ценовой_группы}
    - параметр с ценовой группой продукта, которую нужно добавить в корзину:
    Вместо
    {id_ценовой_группы}
    подставляется идентификатор ценовой группы.
  • auto_renew
    =
    {0 или 1}
    - параметр, в котором передается состояние чекбокса согласия на подписку:
    Вместо
    {0 или 1}
    подставляется соответствующее значение:
    0 - чекбокс согласия по умолчанию = выключен;
    1 - чекбокс согласия по умолчанию = включен.

Пример:
https://w-lab.shop.allsoftglobal.com/basket/add/?pricegroupid=4636934&auto_renew=0&clear=Y
Результат: чекбокс автопродления по умолчанию выключен

Формат ссылки для нескольких продуктов:
(!) Ценовые группы в ссылке должны идти в том же порядке, что и состояния чекбоксов согласия к ним.

https://{домен_корзины}/basket/add/
?
pricegroupid
=
{id_ценовой_группы_1}
,
{id_ценовой_группы_N}
&
auto_renew
=
{0 или 1}
,
{0 или 1}