Реализация виджета "Домик"

Всем привет! :upside_down_face:
В сегодняшней статье мы подробнее рассмотрим виджет “Домик”, присаживайтесь поудобнее;)

Начнем с того, что виджет “Домик” предназначен для отправления в остальные виджеты на странице (или на часть виджетов на странице) переменную из датасета, текущую дату или набор конкретных значений в соответствующие переменные.
Важно!
Виджет является невидимым и не занимает места на странице, поэтому вы можете не беспокоиться за его расположение. :+1:

Нужные вам метрики по стандарту подключаются в SDK.

Идем дальше)

Виджет работает в трёх режимах:

  • Запуск при прогрузке страницы - отправка переменной при прогрузке страницы.
    image

Тут при загрузки страницы виджет автоматически прокидывает указанные переменные. В основном сочетается с настройкой “фильтр”, например, для обнуления конкретных переменных.
image

  • Запуск по событию - режим запуска отправки переменных по получению события. При активации данного режима появляется дополнительные поля для ввода наименования события.
    image
    Событие - это действие, которое может быть инициировано виджетом. Наш “Домик” его подхватывает и выполняет указанные действия( на примере картинки, получая событие виджет очищает переменную) :zap:

  • Запуск по закрытию виджетов. Этот режим слушает события закрытия виджетов/попапов и при их срабатывании очищает переменные, которые указаны в “фильтры”.

Также у виджета есть свои настройки: :wrench:

  • “Записывать метрику в хранилище” - в выпадающем списке выбирается метрика, настроенная в SDK, для отправки на другие виджеты.
    image
    Настраиваем нужную метрику в СДК
    image
    Также настраивается триггер в переменной
    image

  • “Записывать текущую дату в хранилище” - в дополнительных настройках необходимо прописать переменную для даты, которую слушают остальные виджеты с колонкой - датой и указать формат даты.
    image
    Далее для нужного виджета в переменных поля “Listen” указываем наше название ключа в хранилище.

  • “Записывать профиль в хранилище” - дает возможность сохранять в переменные значения, получаемые из профиля кейклока. Для этого в Вашем проекте должна быть авторизация. Без авторизации “Настройка переменных профиль” ничего не будет отображать.
    Для начала вам нужно авторизоваться, далее перейдите в раздел профиль, у Вас должны отобразиться все поля профиля.
    image

Далее перейдите в настройку виджета “Домик”, активируйте чекбокс “Записать профиль в хранилище”, перейдите через карандаш в данную настройку и вы увидите все поля, которые были в профиле.
image

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

  • “Фильтры” - виджет работает по аналогии с таким же пунктом в виджете Кнопка. Появляется возможность передавать условия фильтрации данных через переменную. Наименование данных, по которым производится фильтрация должны совпадать с наименованиями из датасета. (пример работы “фильтры” уже указан выше на картинках :slightly_smiling_face:)

:boom: И последняя настройка “Ожидать фильтрацию из хранилища” дает возможность выбора ожидания конкретных переменных в хранилище.
image

Если переменные не выбраны, но настройка включена, то он будет ожидать любую переменную.

Спасибо за внимание!
Надеюсь, данная статья поможет вам разобраться в виджете “Домик”. :100:

5 лайков