Размещение ссылки на виджет
Данный способ подойдёт клиентам, у которых нет доступа на размещение скриптов на сайте. Достаточно правильным образом сформировать ссылку на виджет и разместить её на сайте.
Правила формирования ссылки
Чтобы сформировать ссылку, необходимо перечислить параметры и указать их значения.
Параметры и их значения перечисляются после символа ?. Название параметра и его значение разделяются знаком равенства =:
параметр=значение
Пары параметр-значение разделяются символом &:
параметр1=значение1&параметр2=значение2&...
В общем виде ссылка на виджет выглядит следующим образом https://widget.giftery.cards/?параметр1=значение1&параметр2=значение2&...
Доступные параметры
Далее перечислены параметры, которые можно указать в URL.
| Параметр | Описание |
|---|---|
productId | ID продукта |
code | Символьный код конфигурации |
color | Основной цвет оформления в шестнадцатеричном формате. Например, ff6400. Символ `#` можно не указывать; сокращённый формат не поддерживается. |
face | Номинал подарочного сертификата, который будет выбран по умолчанию при открытии виджета. |
isDemo | Если параметр установлен в `1`, то виджет будет работать в демо-режиме. В таком режиме не будет перехода на оплату, а клиенту сразу придёт тестовый сертификат. |
headerLink | Данный параметр позволяет добавить ссылку к логотипу в блоке header. |
locale | Локаль виджета. На данный момент виджет может быть отображён на русском, казахском, английском и испанском языках. Для этого можно указать значение параметра ru,kk,en,es соответственно. Example: https://widget.giftery.cards/?locale=kk |
macroregion | Возможность указывать регион вне зависимости от региона продукта. (Влияет исключительно на интерфейс виджета, внутренняя логика и покупки завязаны на регионе продукта!). На данный момент работают регионы: ru, kk, by, es. Example: https://widget.giftery.cards/?macroregion=kk |
currencyCode | Возможность указывать валюту вне зависимости от региона продукта. Поддерживается трёхбуквенный код по стандарту ISO 4217 (пример: RUB, BYN, EUR, USD). Example: https://widget.giftery.cards/?currencyCode=USD |
checkBalance | Позволяет вручную отключать возможность проверки баланса. Принимает значения: "disabled". Example: https://widget.giftery.cards/?checkBalance=disabled |
corporateOrder | Позволяет вручную включать/отключать кнопку Корпоративный заказ. Принимает значения: "enabled", "disabled". Example: https://widget.giftery.cards/?corporateOrder=disabled |
analytics[channel] | Параметр, позволяющий передавать аналитическую информацию. Example: https://widget.giftery.cards/?code=card&analytics[channel]=SITE |
Пример
html
<a
href="https://widget.giftery.cards/?productId=23903&color=ff0064&locale=en&isDemo=1"
target="_blank"
>Открыть виджет Giftery Card</a>Плюсы
- Не нужно размещать дополнительные скрипты
- Достаточно быстрый и понятный способ размещения (нужно всего лишь добавить ссылку)
Минусы
- Виджет открывается в новом окне, что может запутать пользователя